Класс LocaleSelectorFilter
Устанавливает по умолчанию локаль выполнения для запроса на основе заголовка Accept-Language. Значение по умолчанию будет установлено только в том случае, если оно соответствует списку переданных допустимых локалей.
- Cake\Routing\DispatcherFilter implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait
-
Cake\Routing\Filter\LocaleSelectorFilter
Краткое описание свойств
-
$_localesprotectedСписок допустимых локалей для запросаarray
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор.
- beforeDispatch() public
Проверяет запрос на наличие заголовка Accept-Language и устанавливает локаль для текущего выполнения, если она соответствует списку допустимых локалей, переданных в настройках.
Подробное описание методов
__construct()source public
__construct( array $config [] )
Конструктор.
Параметры
- массив
$configнеобязательно [] - Настройки фильтра.
Исключения
Cake\Core\Exception\ExceptionКогда условия 'when' не являются вызываемыми функциями.
Переопределяет
Cake\Routing\DispatcherFilter::__construct() beforeDispatch()source public
beforeDispatch( Cake\Event\Event $event )
Проверяет запрос на наличие заголовка Accept-Language и устанавливает локаль для текущего выполнения, если она соответствует списку допустимых локалей, переданных в настройках.
Параметры
-
Cake\Event\Event$event - Экземпляр события.
Переопределяет
Cake\Routing\DispatcherFilter::beforeDispatch() Методы, унаследованные от Cake\Routing\DispatcherFilter
afterDispatch()source public
afterDispatch( Cake\Event\Event $event )
Метод, вызываемый после того, как контроллер обработает запрос и сгенерирует ответ. На данном этапе можно изменить объект ответа, так как он ещё не отправлен клиенту.
Если возвращается false, событие будет остановлено, и больше никаких слушателей не будут уведомлены. В качестве альтернативы можно вызвать $event->stopPropagation() для достижения того же результата.
Параметры
-
Cake\Event\Event$event объект контейнера, содержащий ключи
requestиresponseв свойстве data.
handle()source public
handle( Cake\Event\Event $event )
Метод обработчика, применяющий условия и определяющий правильный метод для вызова.
Параметры
-
Cake\Event\Event$event - Экземпляр события.
Возвращает
mixedimplementedEvents()source public
implementedEvents( )
Возвращает список событий, за которыми следит этот фильтр. Диспечер уведомляет о двух разных событиях Dispatcher.before и Dispatcher.after. По умолчанию этот класс прикрепляет методы preDispatch и postDispatch соответственно.
Переопределите этот метод по своему усмотрению, чтобы прослушивать только интересующие вас события.
Возвращает
массивРеализация
Cake\Event\EventListenerInterface::implementedEvents() matches()source public
matches( Cake\Event\Event $event )
Проверяет, соответствует ли входящий запрос критериям этого фильтра.
Параметры
-
Cake\Event\Event$event - Событие для проверки соответствия.
Возвращает
booleanМетоды, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет один конфигурационный ключ.
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionесли попытка перезаписать существующую конфигурацию.
_configRead()source protected
_configRead( string|null $key )
Считывает конфигурационную переменную.
Параметры
- строка или null
$key - Ключ для считывания.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записывает конфигурационную переменную.
Параметры
- строка или массив
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean или строка
$mergeнеобязательно false True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionесли попытка перезаписи существующей конфигурации
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Использование
Чтение всей конфигурации:
$this->config();
Чтение определённого значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких конфигурационных настроек одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка, массив или null
$keyнеобязательно null - Ключ для получения/установки или полный массив конфигураций.
- mixed или null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
mixedЗначение конфигурации, которое считывается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить некорректный ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Объединить предоставленную конфигурацию с существующей конфигурацией. В отличие от config(), которая выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких конфигурационных настроек одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- строка или массив
$key - Ключ для установки или полный массив конфигураций.
- mixed или null
$valueнеобязательно null - Значение для установки.
Возвращает
$this Объект самого себя.
Подробное описание свойств
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.2/class-Cake.Routing.Filter.LocaleSelectorFilter.html