Мгновенные сообщения¶

class Cake\View\Helper\FlashHelper(View $view, array $config = [])¶

FlashHelper предоставляет способ визуализации мгновенных сообщений, которые сохраняются в $_SESSION с использованием FlashComponent. FlashComponent и FlashHelper в основном используют элементы для отображения мгновенных сообщений. Элементы мгновенных сообщений находятся в папке templates/element/flash. Заметьте, что шаблон приложения CakePHP предоставляется с тремя готовыми элементами мгновенных сообщений: success.php, default.php, и error.php.

Отображение мгновенных сообщений¶

Для отображения мгновенного сообщения используется метод render() из FlashHelper в файле шаблона:

<?= $this->Flash->render() ?>

По умолчанию CakePHP использует ключ «flash» для мгновенных сообщений в сессии. Но, если был указан ключ при установке мгновенного сообщения в FlashComponent, можно указать какой из ключей мгновенного сообщения отображать:

<?= $this->Flash->render('other') ?>

Также можно переопределить любой из параметров, которые были установлены во FlashComponent:

// в Контроллере
$this->Flash->set('The user has been saved.', [
    'element' => 'success'
]);

// В файле шаблона: будет использован great_success.php вместо succcess.php
<?= $this->Flash->render('flash', [
    'element' => 'great_success'
]);

Примечание

При создании пользовательских шаблонов мгновенных сообщений, необходимо убедиться, что HTML-код правильно обрабатывает пользовательские данные. CakePHP не экранирует параметры мгновенных сообщений за вас.

Для дополнительной информации о доступных параметрах массива, обратитесь в раздел FlashComponent.

Префикс маршрутизации и мгновенные сообщения¶

Если у вас сконфигурирован префикс маршрутизации, Flash элементы могут храниться в templates/{Prefix}/element/flash. Таким образом, вы можете хранить конкретные шаблоны сообщений для каждой части вашего приложения. Например, используя различные щаблоны для пользовательского интерфейса и интерфейса администратора.