Класс LocaleSelectorFilter
Устанавливает по умолчанию локаль выполнения для запроса на основе заголовка Accept-Language. По умолчанию локаль будет установлена только в том случае, если она соответствует списку допустимых локалей.
- Cake\Routing\DispatcherFilter реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait
-
Cake\Routing\Filter\LocaleSelectorFilter
Подробное описание методов
__constructsource public
__construct( array $config [] )
Конструктор.
Параметры
- массив
$configнеобязательно [] - Настройки фильтра.
Исключения
Cake\Core\Exception\ExceptionКогда условия «when» не вызываемы.
Переопределяет
Cake\Routing\DispatcherFilter::__construct() beforeDispatchsource public
beforeDispatch( Cake\Event\Event $event )
Проверяет запрос на наличие заголовка Accept-Language и устанавливает локаль для текущего выполнения, если она соответствует списку допустимых локалей, переданных в конфигурации.
Параметры
-
Cake\Event\Event$event - Экземпляр события.
Переопределяет
Cake\Routing\DispatcherFilter::beforeDispatch() Методы, унаследованные от Cake\Routing\DispatcherFilter
afterDispatchsource public
afterDispatch( Cake\Event\Event $event )
Метод, вызываемый после того, как контроллер обработает запрос и сгенерирует ответ. В этот момент можно изменить объект ответа, так как он ещё не отправлен клиенту.
Если возвращается false, событие будет остановлено, и больше не будут уведомлены слушатели. В качестве альтернативы, вы можете вызвать $event->stopPropagation() для достижения того же результата.
Параметры
-
Cake\Event\Event$event - Объект контейнера, содержащий ключи
requestиresponseв свойстве data.
handlesource public
handle( Cake\Event\Event $event )
Метод обработчика, применяющий условия и разрешающий вызов правильного метода.
Параметры
-
Cake\Event\Event$event - Экземпляр события.
Возвращает
mixedсмешанный тип
implementedEventssource public
implementedEvents( )
Возвращает список событий, за которыми следит этот фильтр. Диспечер уведомляет о двух разных событиях Dispatcher.before и Dispatcher.after. По умолчанию этот класс присоединяет методы preDispatch и postDispatch соответственно.
Переопределите этот метод, чтобы следить только за интересующими вас событиями.
Возвращает
arrayмассив
Реализация
Cake\Event\EventListenerInterface::implementedEvents() matchessource public
matches( Cake\Event\Event $event )
Проверка соответствия входящего запроса критериям этого фильтра.
Параметры
-
Cake\Event\Event$event - Событие для сопоставления.
Возвращает
booleanбулево значение
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDeletesource protected
_configDelete( string $key )
Удаление одного конфигурационного ключа
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписать существующую конфигурацию
_configReadsource protected
_configRead( string|null $key )
Чтение конфигурационной переменной
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
mixedсмешанный тип
_configWritesource protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Запись конфигурационной переменной
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный тип
$value - Значение для записи.
- булево значение|строка
$mergeнеобязательно false - True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
configsource 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 - Ключ для получения/установки или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
- булево значение
$mergeнеобязательно true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
mixedЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallowsource 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 - Ключ для установки или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для установки.
Возвращает
mixedСам объект $this.
Краткое описание свойств
Свойства, унаследованные от Cake\Routing\DispatcherFilter
$_defaultConfigsource
protected массив
Конфигурация по умолчанию
Эти значения объединяются с предоставленной пользователем конфигурацией при использовании класса. Опции when и for позволяют задать условия, которые проверяются перед вызовом вашего фильтра.
[
'when' => null,
'for' => null,
'priority' => null,
] Свойства, используемые из Cake\Core\InstanceConfigTrait
$_configInitializedsource
protected boolean
Указывает, была ли конфигурация уже настроена по умолчанию
false
© 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.1/class-Cake.Routing.Filter.LocaleSelectorFilter.html