Класс FlashComponent
Компонент FlashComponent CakePHP предоставляет способ записи переменной флэш в сессию из контроллеров для последующего отображения в представлении с помощью FlashHelper.
- Cake\Controller\Component реализует Cake\Event\EventListenerInterface использует Cake\Core\InstanceConfigTrait , Cake\Log\LogTrait
-
Cake\Controller\Component\FlashComponent
Краткое описание свойств
-
$_defaultConfigprotectedКонфигурация по умолчаниюarray - Экземпляр объекта сессии
$_sessionprotected
Унаследованные свойства
Краткое описание методов
- __call() publicМагический метод для подробных методов флэш, основанных на именах элементов.
- __construct() publicКонструктор
- getSession() protectedВозвращает текущий объект сессии из запроса контроллера.
- set() public
Используется для установки переменной сессии, которая может быть использована для вывода сообщений в представлении. Если вы делаете последовательные вызовы этого метода, сообщения будут стекироваться (если они установлены с одинаковым ключом флэш).
Подробное описание методов
__call()source public
__call( string $name , array $args )
Магический метод для подробных методов флэш, основанных на именах элементов.
Например: $this->Flash->success('My message') будет использовать элемент success.ctp в src/Template/Element/Flash для отображения сообщения флэш.
Если вы делаете последовательные вызовы этого метода, сообщения будут стекироваться (если они установлены с одинаковым ключом флэш)
Обратите внимание, что параметр element всегда будет переопределён. Для вызова конкретного элемента из плагина, необходимо установить параметр plugin в $args.
Например: $this->Flash->warning('My message', ['plugin' => 'PluginName']) будет использовать элемент warning.ctp в plugins/PluginName/src/Template/Element/Flash для отображения сообщения флэш.
Параметры
- строка
$name - Имя элемента для использования.
- массив
$args - Параметры для передачи при вызове
FlashComponent::set().
Исключения
Cake\Http\Exception\InternalErrorExceptionЕсли отсутствует сообщение флэш.
__construct()source public
__construct( Cake\Controller\ComponentRegistry $registry , array $config = [] )
Конструктор
Параметры
-
Cake\Controller\ComponentRegistry$registry - ComponentRegistry для этого компонента
- массив
$configнеобязательно [] - Массив конфигурации.
Переопределяет
Cake\Controller\Component::__construct() getSession()source protected
getSession( )
Возвращает текущий объект сессии из запроса контроллера.
Возвращает
Cake\Http\Sessionset()source public
set( string|Exception $message , array $options = [] )
Используется для установки переменной сессии, которая может быть использована для вывода сообщений в представлении. Если вы делаете последовательные вызовы этого метода, сообщения будут стекироваться (если они установлены с одинаковым ключом флэш).
В вашем контроллере: $this->Flash->set('Это сохранено');
Параметры:
-
keyКлюч для установки в сессии Flash -
elementЭлемент, используемый для отображения сообщения флэш. По умолчанию 'default'. -
paramsМассив переменных, доступных при использовании элемента -
clearБулево значение, указывающее, следует ли очистить текущий стек для начала нового -
escapeУстановите в false, чтобы шаблоны могли выводить HTML-контент
Параметры
- строка|Исключение
$message Сообщение для отображения. Если это экземпляр \Exception, будет использовано сообщение об исключении, а код будет установлен в params.
- массив
$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 True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source public deprecated
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Данные конфигурации по указанному ключу или null, если ключ не найден.
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
] $_sessionsource
protected Cake\Http\Session
Экземпляр объекта сессии
Устарело
3.7.5 Это свойство будет удалено в версии 4.0.0 в пользу методаgetSession().
© 2005–present 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.8/class-Cake.Controller.Component.FlashComponent.html