Класс FlashComponent
Компонент FlashComponent CakePHP предоставляет способ записи переменной flash в сессию из контроллеров для последующего отображения в представлении с помощью FlashHelper.
- Cake\Controller\Component implements Cake\Event\EventListenerInterface uses Cake\Core\InstanceConfigTrait, Cake\Log\LogTrait
-
Cake\Controller\Component\FlashComponent
Подробное описание методов
__callsource 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 отсутствует.
__constructsource public
__construct( Cake\Controller\ComponentRegistry $registry , array $config [] )
Конструктор
Параметры
-
Cake\Controller\ComponentRegistry$registry - ComponentRegistry для этого компонента
- массив
$configнеобязательно [] - Массив конфигурации.
Переопределяет
Cake\Controller\Component::__construct() setsource public
set( string|Exception $message , array $options [] )
Используется для задания переменной сессии, которая может использоваться для вывода сообщений в представлении. Если вы вызываете этот метод последовательно, сообщения будут складываться (если они заданы с одним и тем же ключом flash).
В вашем контроллере: $this->Flash->set('Это было сохранено');
Опции:
-
keyКлюч для задания в ключе Flash сессии -
elementЭлемент, используемый для отображения сообщения flash. По умолчанию 'default'. -
paramsМассив переменных, доступных при использовании элемента -
clearЛогическое значение, указывающее, следует ли очистить текущий стек, чтобы начать новый
Параметры
- строка|Исключение
$message - Сообщение для отображения. Если экземпляр \Exception, то используется сообщение исключения и код будет задан в параметрах.
- массив
$optionsнеобязательно [] - Массив опций
Методы, унаследованные от Cake\Controller\Component
__debugInfosource public
__debugInfo( )
Возвращает массив, который может быть использован для описания внутреннего состояния этого объекта.
Возвращает
arrayмассив
__getsource public
__get( string $name )
Магический метод для ленивой загрузки $components.
Параметры
- строка
$name - Имя компонента для получения.
Возвращает
mixedОбъект компонента или null.
implementedEventssource public
implementedEvents( )
Получение обработчиков контроллера, которыми интересуется этот компонент.
Использует соглашения для сопоставления событий контроллера с стандартными именами методов обратного вызова компонента. Определяя один из методов обратного вызова, предполагается, что компонент интересуется соответствующим событием.
Переопределите этот метод, если вам нужно добавить обработчики событий, не соответствующие соглашениям. Или если вы хотите, чтобы компоненты слушали нестандартные события.
Возвращает
arrayмассив
Реализация
Cake\Event\EventListenerInterface::implementedEvents() initializesource public
initialize( array $config )
Метод обратного вызова конструктора.
Реализуйте этот метод, чтобы не приходилось переопределять конструктор и вызывать родительский.
Параметры
- массив
$config - Настройки конфигурации, предоставленные этому компоненту.
Методы, используемые из 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Сам объект.
Методы, используемые из Cake\Log\LogTrait
logsource 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Успешность записи в журнал.
Краткое описание магических методов
Краткое описание свойств
Унаследованные свойства от Cake\Controller\Component
$_componentMapsource
protected array
Таблица поиска компонентов для отложенной загрузки объектов компонентов.
[]
$_registrysource
protected Cake\Controller\ComponentRegistry
Класс реестра компонентов, используемый для отложенной загрузки компонентов.
Используемые свойства из 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.Controller.Component.FlashComponent.html