Класс FlashComponent
Компонент FlashCakePHP позволяет записывать переменную flash в сессию из контроллеров для последующего отображения в представлении с помощью помощника FlashHelper.
- Cake\Controller\Component реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait , Cake\Log\LogTrait
-
Cake\Controller\Component\FlashComponent
Краткое описание свойств
-
$_defaultConfigprotectedЗначение по умолчанию конфигурацииarray - Экземпляр объекта сессии
$_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('This has been saved');
Параметры:
-
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.
getController()source public
getController( )
Получить контроллер, к которому привязан этот компонент.
Возвращает
Cake\Controller\ControllerСвязанный контроллер.
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 - Значение для записи.
- логическое значение или строка
$mergeнеобязательно false Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключения
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']);
Устаревшее
3.4.0 используйте setConfig()/getConfig() вместо этого.Параметры
- string|array|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->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или весь массив настроек.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определенного значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyнеобязательно null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultнеобязательно null - Значение, возвращаемое, когда ключ не существует.
Возвращает
mixedЗначение конфигурации, которое читается.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или весь массив настроек.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Флаг для рекурсивного слияния или перезаписи существующей конфигурации, по умолчанию true.
Возвращает
$this
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
Методы, используемые из Cake\Log\LogTrait
log()source public
log( mixed $msg , integer|string $level LogLevel::ERROR , string|array $context [] )
Метод для записи сообщения в журнал. Смотрите Log::write() для получения дополнительной информации о записи в журналы.
Параметры
- mixed
$msg - Сообщение для записи в журнал.
- integer|string
$levelнеобязательно LogLevel::ERROR - Уровень ошибки.
- string|array
$contextнеобязательно [] - Дополнительные данные журнала, относящиеся к этому сообщению.
Возвращает
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.4/class-Cake.Controller.Component.FlashComponent.html