Класс FlashComponent
Компонент FlashCakePHP предоставляет способ записи переменной flash в сессию из контроллеров для последующего рендеринга в представлении с помощью FlashHelper.
- Cake\Controller\Component реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait , Cake\Log\LogTrait
-
Cake\Controller\Component\FlashComponent
Краткое описание свойств
-
$_defaultConfigprotectedЗначение по умолчаниюarray - Экземпляр объекта Session
$_sessionprotected
Унаследованные свойства
Краткое описание методов
- __call() publicМагический метод для методов flash с длинным названием, основанных на именах элементов.
- __construct() publicКонструктор
- set() public
Используется для задания переменной сессии, которая может быть использована для вывода сообщений в представлении. Если вы делаете последовательные вызовы этого метода, сообщения будут накапливаться (если они заданы с одинаковым ключом flash).
Подробное описание методов
__call()source public
__call( string $name , array $args )
Магический метод для методов flash с длинным названием, основанных на именах элементов.
Например: $this->Flash->success('My message') будет использовать элемент success.ctp в src/Template/Element/Flash для рендеринга сообщения flash.
Если вы делаете последовательные вызовы этого метода, сообщения будут накапливаться (если они заданы с одинаковым ключом flash).
Обратите внимание, что параметр element будет всегда перезаписываться. Для вызова определенного элемента из плагина, необходимо установить опцию plugin в $args.
Например: $this->Flash->warning('My message', ['plugin' => 'PluginName']) будет использовать элемент warning.ctp в plugins/PluginName/src/Template/Element/Flash для рендеринга сообщения flash.
Параметры
- строка
$name - Имя элемента для использования.
- массив
$args - Параметры для передачи при вызове
FlashComponent::set().
Исключения
Cake\Network\Exception\InternalErrorExceptionЕсли отсутствует сообщение flash.
__construct()source public
__construct( Cake\Controller\ComponentRegistry $registry , array $config [] )
Конструктор
Параметры
-
Cake\Controller\ComponentRegistry$registry - ComponentRegistry для этого компонента
- массив
$configнеобязательно [] - Массив конфигурации.
Переопределяет
Cake\Controller\Component::__construct() set()source public
set( string|Exception $message , array $options [] )
Используется для задания переменной сессии, которая может быть использована для вывода сообщений в представлении. Если вы делаете последовательные вызовы этого метода, сообщения будут накапливаться (если они заданы с одинаковым ключом flash).
В контроллере: $this->Flash->set('Это сохранено');
Опции:
-
keyКлюч для задания в ключе Flash сессии -
elementЭлемент для рендеринга сообщения flash. По умолчанию 'default'. -
paramsМассив переменных, доступных при использовании элемента -
clearЛогическое значение, указывающее, нужно ли очистить текущий стек для создания нового -
escapeУстановить в false, чтобы шаблоны могли выводить HTML-контент
Параметры
- строка|Исключение
$message Сообщение, которое нужно отобразить. Если экземпляр \Exception, будет использовано сообщение исключения, а код будет задан в параметрах.
- массив
$optionsнеобязательно [] - Массив опций
Методы унаследованные от Cake\Controller\Component
__debugInfo()source public
__debugInfo( )
Возвращает массив, который может быть использован для описания внутреннего состояния этого объекта.
Возвращает
массив__get()source public
__get( string $name )
Магический метод для леничной загрузки $components.
Параметры
- строка
$name - Имя компонента для получения.
Возвращает
смешанный типОбъект компонента или null.
implementedEvents()source public
implementedEvents( )
Получение обратных вызовов контроллера, в которых заинтересован этот компонент.
Использует соглашения для сопоставления событий контроллера со стандартными именами методов обратного вызова компонента. Если компонент определяет один из методов обратного вызова, считается, что он заинтересован в соответствующем событии.
Переопределите этот метод, если вам нужно добавить обработчики событий, не соответствующие соглашениям, или если вы хотите, чтобы компоненты прослушивали нестандартные события.
Возвращает
массивРеализация
Cake\Event\EventListenerInterface::implementedEvents() initialize()source public
initialize( array $config )
Метод обратного вызова инициализации.
Реализуйте этот метод, чтобы избежать необходимости переопределения конструктора и вызова родителя.
Параметры
- массив
$config - Настройки конфигурации, предоставленные этому компоненту.
Методы, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаление одного ключа конфигурации
Параметры
- строка
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionпри попытке переопределения существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Чтение переменной конфигурации
Параметры
- строка|null
$key - Ключ для чтения.
Возвращает
смешанный тип_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Запись переменной конфигурации
Параметры
- строка|массив
$key - Ключ для записи.
- смешанный тип
$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 - Ключ для получения/записи, или полный массив конфигураций.
- смешанный тип|null
$valueнеобязательно null - Значение для записи.
- boolean
$mergeнеобязательно true - Рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.
Возвращает
смешанный типЗначение конфигурации, которое читается, или сам объект при операциях записи.
Исключения
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']);
Параметры
- string|array
$key - Ключ для установки или полный массив конфигураций.
- mixed|null
$valueoptional null - Значение для установки.
Возвращает
$this Сам объект.
Методы, используемые из Cake\Log\LogTrait
log()source public
log( mixed $msg , integer|string $level LogLevel::ERROR , string|array $context [] )
Удобный метод для записи сообщения в журнал. Для получения дополнительной информации о записи в журналы см. Log::write().
Параметры
- mixed
$msg - Сообщение журнала.
- integer|string
$leveloptional LogLevel::ERROR - Уровень ошибки.
- string|array
$contextoptional [] - Дополнительные данные журнала, относящиеся к этому сообщению.
Возвращает
booleanУспешность записи в журнал.
Резюме магических методов
Подробности свойств
$_defaultConfigsource
protected array
Значения по умолчанию конфигурации
[
'key' => 'flash',
'element' => 'default',
'params' => [],
'clear' => false,
'duplicate' => true
]
© 2005–2017 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.
https://api.cakephp.org/3.3/class-Cake.Controller.Component.FlashComponent.html