Как вывести сообщение laravel

Основы Laravel 5: Сообщения-вспышки

Laravel 5 Fundamentals: Flash Messaging → Laracasts +1 060 30 августа 2016

(0:00)
Вот о чём я хочу, чтобы вы подумали. Часто когда пользователь выполняет какое-либо действие в вашем приложении, вы хотите дать ему какое-то уведомление, чтобы сообщить, например: «Эй, ваша учетная запись была успешно деактивирована» .
Поэтому, возможно, это было бы полезно и для нашего маленького блога здесь. Введём Blog Article , небольшой текст и опубликуем статью. И заметьте, что, да, нас сюда перенаправили, и если честно, в данном случае совершенно очевидно, что всё прошло успешно.

(0:30)
Но, как вы можете себе представить, во многих других случаях, вам действительно понадобятся какие-то уведомления. Даже нечто настолько простое, как нажатие на кнопку Log Out , может выдать вам сообщение, подтверждающее статус: «Вы вышли из системы» .
Давайте в этом уроке разберёмся как с этим справиться. Я покажу вам два способа, во-первых, мы сделаем это вручную, а затем дальше, я покажу вам небольшой пакет, который вы сможете притянуть, и с его помощью можно до смешного просто всё это сделать.
Наш первый шаг — идём на PHP ArticlesController .

(1:00)
Теперь, когда пользователь создаёт новую статью, как мы знаем, метод PHP store () вызывается, когда мы сделали новую статью и сохранили её. И на самом деле, немного не в тему — здесь мы создаём статью и передаём её методу сохранения PHP save () , но также, если вы предпочитаете, то могли бы использовать метод PHP create () .
Так же, как мы это делали, когда мы передавали массив атрибутов:

то же самое было бы верно здесь. Так что если вы хотите, вы могли бы сказать: получить статьи аутентифицированного пользователя и создать новую, используя запрос из формы:

(1:30)
так что, если мы удалим вот это, то всё будет по-прежнему работать точно таким же образом.
Хорошо, но в любом случае, мы создали новую статью, и мы перенаправим пользователя назад к списку статей, но я также хочу отобразить то, что мы называем «сообщением-вспышкой» (flash). Сообщение, которое показывается на экране для следующего запроса, а позднее, если перезагрузить страницу, его больше не будет видно.
Вот как мы можем сделать это в Laravel. У нас есть фасад сессии, так что мы могли бы сказать:

(2:00)
Я хочу показать сообщение, мы даём ему какой-нибудь идентификатор, flash message , а затем тело, как насчет Your article has been created (т.е. ваша статья была создана). Хорошо, это сработает для конкретной сессии. Однако, когда мы перенаправляем, то мы не увидим это сообщение, нам всё равно нужно отобразить его где-то в нашем представлении.
Так давайте сделаем это. Давайте вернёмся к нашей мастер-странице; если это относится к каждому виду, то мастер-страница – хорошее место, куда это стоит поместить.

(2:30)
И давайте вставим это прямо здесь, в верхней части нашего контейнера, и позднее мы сможем извлечь паршл, но сейчас давайте просто вставим наш код прямо здесь.
Давайте скажем, если у сессии есть этот ключ:

то в этом случае мы хотим отобразить его. Так почему бы нам не использовать:

Это специфические классы из Twitter Bootstrap, которые просто немного облегчат нам работу. И потом внутри здесь мы выведем сообщение

(3:00)
ОК, таким образом, мы уже узнали несколько методов API.
Для начала – PHP \ Session :: flash () . Думайте о нём, в качестве единовременного флэш-сообщения. Также есть такие вещи, как PHP \ Session :: put () – поместить это в сессию. Разница между этим и flash-сообщением в том, что последнее носит временный характер, только для одного запроса.
Так что у нас есть эти два, и ещё мы можем увидеть такие методы, как PHP Session :: has () . Есть ли у нас этот ключ в сессии?

(3:30)
И если он есть, то через PHP get () получим значение, связанное с этим ключом. Давайте посмотрим, как это выглядит в браузере.
Поэтому ещё раз я создам новую статью. Просто напишем test (в название) и test (в тело), и, когда мы добавим статью, точно, вы увидите сообщение прямо здесь. Теперь вот что я имел в виду про то, что это одноразовое сообщение. Если мы перезагрузим эту страницу, сообщение только промелькнуло, так что мы его больше не видим, и это значит, что это идеально подходит для таких маленьких сообщений с уведомлениями.

(4:00)
Вы вероятно обнаружите, что для большинства производственных приложений вам понадобится немного больше гибкости.
Например, когда нас перенаправляют назад на эту страницу с flash-сообщением, оно как бы отображается всё время. Может быть, вы хотите отображать сообщение в течение четырех секунд и чтобы затем оно ускользнуло наверх? Вы хотите, чтобы оно исчезло.
Но в других ситуациях, для действительно важных сообщений, вы и правда хотите, чтобы они отображались постоянно. И чтобы пользователь должен был нажать на маленькую кнопку ‘х’, чтобы признать, что «Да» , он прочитал сообщение и теперь хочет удалить его.

(4:30)
Так что, похоже, что на самом деле, нам нужно здесь чуть больше гибкости. Давайте посмотрим, как мы могли бы это сделать. Ну, для начала, если мы вернёмся к нашему представлению, то почему бы нам не добавить маленький х наверху, и я просто вставлю вот этот код:

Это на самом деле взято с сайта Twitter Bootstrap. Просто код, который можно добавить чтобы поставить кнопочку х . Итак, позвольте мне показать вам, как это выглядит.

test2 , опубликуем статью. И теперь мы получаем сообщение, и вы увидите, вот он маленький х .

(5:00)
Но если я нажму на него, то ничего пока не происходит, потому что Twitter Bootstrap там требуется немного JavaScript. Так почему бы нам не добавить его? Давайте разместим это внизу, прямо перед закрывающим

Источник

Laravel Уведомления

Система уведомлений Laravel позволяет отправлять уведомления пользователям используя различные каналы. В этой статье мы рассмотрим Laravel Notifications, самый прекрасный способ обработки уведомлений для вашего веб-приложения.

Что такое Уведомления?

Во время разработки приложений часто нужно уведомлять пользователей о различных изменениях или действиях. Это могут быть email-уведомлений при изменении статуса заказа, либо отправка сообщений в Slack при завершении фоновой задачи приложения. Обычно это короткие сообщения, просто дающие представление об изменениях состояний.

Laravel предоставляет почтовый класс, который можно использовать для отправки электронных писем. Но, обычно это большие письма с markup-разметкой и мы не можем отправлять их по другим каналам. Laravel Notifications решает эту проблему, предоставляя элегантный и удобный способ отправки уведомлений пользователям.

Каналы Уведомлений

Вся прелесть Laravel Notifications в том, что он позволяет вам выбирать каналы, по которым будут доставляться ваши уведомления. Давайте рассмотрим какие каналы, в настоящее время, поддерживает фреймворк.

• Mail: уведомления будут отправлены пользователям в виде электронных писем.
• SMS: пользователи будут получать уведомления на свои мобильные телефоны.
• Database: эта опция позволяет вам сохранять уведомления в базе данных, которые далее своим способом можно показывать пользователям.
• Slack: эта опция позволяет отправлять уведомления в канал Slack.

Мы рассмотрим mail, database и slack уведомления, так как они используются чаще всего.

Установка приложения

Для начала мы быстренько установим Laravel через Composer.

Когда приложение Laravel будет готово, откройте файл .env и настройте в нём свою базу данных.

Создание Уведомления

Уведомления Laravel просты в использовании, так как они генерируют отдельный класс для каждого уведомления. В этом классе мы можем описать, как будем доставлять уведомления пользователям.

Чтобы создать новый класс уведомлений, выполните следующую команду в терминале.

Она создаст новый файл app\Notifications\NewUser.php со следующим содержимым:

Обратите внимание на метод via в вышеприведенном классе, в нём вы можете указать, как вы хотите, чтобы пользователь получал уведомления. В вышеприведенном классе объявлено, что мы хотим использовать уведомление по электронной почте.

Соответственно, он запустит метод toMail() .

Запуск Уведомлений

Чтобы включить уведомления Laravel для модели User, мы должны использовать трейт Notifiable , как показано ниже:

Laravel «из коробки» содержит модель User , поэтому она уже использует этот трейт. Если вы хотите включить уведомления для своей модели, например, Customer или Admin , то вы должны использовать трейт Notifiable в классе вашей модели.

После добавления трейта вы можете просто отправить уведомление пользователю, как показано ниже.

Теперь $user получит уведомление NewUser .

Вы также можете для отправки уведомлений использовать фасад Notification , как показано ниже.

Перед отправкой уведомления по электронной почте мы добавим в метод toMail() наше специальное сообщение

Мы узнали, как можно сгенерировать класс уведомлений и использовать его для отправки уведомления пользователю по почтовому каналу. В следующих разделах мы рассмотрим, как мы можем настроить уведомления для базы данных и Slack.

Уведомления для базы данных

Такие уведомления хранятся в таблице вашей базы данных. Таблица содержит пользовательское сообщение в формате JSON.

Прежде, чем использовать уведомления базы данных, мы должны создать для них новую таблицу. Не волнуйтесь, Laravel подготовил для этого отдельную команду

Приведенные выше команды создадут новый файл миграции для таблицы уведомлений и создадут таблицу в вашей базе данных.

Как я упоминал ранее, для уведомления по почте мы использовали метод toMail() . Для уведомлений базы данных вам нужно определить либо метод toDatabase() , либо toArray() и он должен возвращать простой PHP-массив. Этот массив будет сохранен в столбце data таблицы уведомлений.

Так как у нас уже есть метод toArray() , то мы его и будем использовать. После внесения изменений в базу данных наш класс уведомлений будет выглядеть следующим образом.

Теперь мы отправляем уведомление как по почте, так и в канал базы данных.

Отображение Уведомлений базы данных

Laravel предоставляет несколько методов для доступа и удаления уведомлений базы данных. Наша модель User использует трейт Notifiable , который включает отношение, возвращающее уведомления для пользователя.

Чтобы получить такое уведомление, просто используйте отношение notifications .

Для получения всех непрочитанных уведомлений:

Отметить уведомления как прочитанные:

Чтобы пометить все уведомления как прочитанные, используйте метод markAsRead() непосредственно в коллекции уведомлений.

Чтобы удалить все уведомления для конкретной модели User :

Slack Уведомления

Чтобы отправлять уведомления в Slack, необходимо установить Guzzle HTTP.

И обновить наш класс уведомлений NewUser , изменив метод via() как показано ниже

Теперь наш класс использует три канала доставки, для простоты я использую один класс для всех трех каналов. В своих профессиональных проектах я предпочитаю создавать отдельный класс для каждого канала доставки.

Добавим метод toSlack() :

Настройка хука

Чтобы получить уведомление Slack, перейдите по адресу https://<вашакоманда>.slack.com/apps . Выберите тип «Incoming Webhook» и добавьте новую конфигурацию.

Скопируйте URL-адрес Webhook и вернитесь в приложение Laravel.

Чтобы направить уведомление в Slack, нам нужно определить метод routeNotificationForSlack() в моделе User .

Чтобы узнать больше о различных параметрах, доступных для Slack уведомлений, ознакомьтесь с Официальной документацией Laravel.

Заключение

В этом уроке мы создали систему Laravel Уведомлений и узнали, как отправлять их из Laravel по электронной почте, в базу данных и в каналы Slack. Подписывайтесь на наши соцсети для получения уведомлений о новых уроках Laravel.

Наш Телеграм-канал — следите за новостями о Laravel.

Задать вопросы по урокам можно на нашем форуме.

Источник

Laravel Framework Russian Community

Пролог

Начало работы

Основы архитектуры

Основы

Фронтенд

Безопасность

Копаем глубже

База данных

Eloquent ORM

Тестирование

Официальные пакеты

Уведомления

Введение

Дополнительно к поддержке отправки email-сообщений, Laravel также поддерживает и отправку уведомлений по различным каналам доставки, включая почту, SMS (через Nexmo) и Slack. Уведомления также можно хранить в БД, поэтому их можно отображать в вашем интерфейсе.

Как правило, уведомления должны быть короткими, информативными сообщениями, которые уведомляют пользователей о каком-либо событий, произошедшем в вашем приложении. Например, если вы пишете биллинг-приложение, то можете отправлять своим пользователям уведомление об оплаченном счете через каналы email и SMS.

Создание уведомлений

В Laravel каждое уведомление представлено единым классом (обычно хранится в директории app/Notifications ). Не волнуйтесь, если не видите эту директорию в своем приложении, т.к. она будет создана, когда вы запустите Artisan-команду make:notification :

Эта команда поместит свежий класс уведомлений в вашу директорию app/Notifications . Каждый класс уведомления содержит метод via и переменный номер методов построения сообщений (например, toMail или toDatabase ), которые конвертируют уведомление в сообщение, оптимизированное для конкретного канала.

Отправка уведомлений

Использование трейта Notifiable

Уведомления можно отправлять двумя способами: используя метод notify трейта Notifiable или используя фасад Notification . Сначала давайте рассмотрим использование трейта:

Этот трейт используется моделью App\User по умолчанию и содержит один метод, который можно использовать для отправки уведомлений: notify . Метод notify ожидает получить экземпляр уведомления:

Помните, что можете использовать трейт Illuminate\Notifications\Notifiable на любой своей модели. Вы не ограничены включением его только в вашу модель User .

Использование фасада Notification

Другой способ отправки уведомлений — через фасад Notification . Это полезно, прежде всего, когда вам нужно отправить уведомление нескольким уведомляемым объектам, таким как коллекция пользователей. Чтобы отправлять уведомления с использованием фасада, передайте все уведомляемые объекты и экземпляр уведомления методу send :

Указание каналов доставки

У каждого класса уведомлений есть метод via , который определяет по каким каналам будет доставляться это уведомление. Изначально уведомления можно отправлять на каналы mail , database , broadcast , nexmo и slack .

Если вы бы хотели использовать другие каналы доставки, такие как Telegram или Pusher, ознакомьтесь с управляемым сообществом вебсайтом о каналах уведомлений Laravel.

Метод via получает экземпляр $notifiable , который будет экземпляром класса, которому отправляется уведомление. Можно использовать $notifiable , чтобы определить по каким каналам следует доставлять уведомление:

Формирование очередей уведомлений

Перед формированием очередей уведомлений вам следует настроить свою очередь и запустить воркер.

Отправка уведомлений может занять время, особенно если каналу требуется вызывать внешний API с целью доставки этих уведомлений. Чтобы ускорить время ответа вашего приложения, позвольте своим уведомлениям формировать очереди, добавив интерфейс ShouldQueue и трейт Queueable к своему классу. Этот интерфейс и трейт уже испортированы для всех уведомлений, сгенерированных с использованием make:notification , так что вы можете сразу же добавить их к свой класс уведомлений:

Как только к вашему уведомлению был добавлен интерфейс ShouldQueue , вы можете отправлять уведомления как обычно. Laravel определит интерфейс ShouldQueue в классе и автоматически поставит доставку уведомления в очередь:

Если вы бы хотели отложить доставку уведомления, то можно привязать метод delay к экземпляру вашего уведомления:

Mail-уведомления

Форматирование Mail-сообщений

Если уведомление поддерживает только отправку в виде электронного сообщения, вы должны задать класс toMail в классе уведомления. Этот метод получит сущность $notifiable и должен возвратить экземпляр Illuminate\Notifications\Messages\MailMessage . Mail-сообщения могут содержать строки текста, а также «призыв к действию». Давайте взглянем на пример метода toMail :

Обратите внимание, что мы используем $this->invoice->id в нашем методе message . В конструктор уведомления можно передавать любые данные, которые требуются уведомлению для генерирования своего сообщения.

В этом примере мы зарегистрируем приветствие, строку текста, призыв к действию, а затем еще одну строку текста. Эти методы, предоставляемые объектом MailMessage , делают форматирование небольших email-сообщений простым и быстрым. Почтовый канал затем будет преобразовывать компоненты сообщения в симпатичный, отзывчивый HTML email-шаблон с копией только с простым текстом. Вот пример электронного сообщения, генерируемого каналом mail :

При отправке уведомлений по почте не забудьте установить значение name в вашем конфиге config/app.php . Это значение будет использоваться в заголовке и подвале ваших сообщений-уведомлений по почте.

Другие опции форматирования уведомления

Вместо рпделения «строк» текста в классе уведомления, можно использовать метод view , чтобы указать пользовательский шаблон, который следует использовать для визуализации email-уведомления:

Дополнительно, можно возвращать mailable-объект из метода toMail :

Сообщения об ошибке

Некоторые уведомления оповещают пользователей об ошибках, например, об ошибке при оплате счета. Можно указать, что это почтовое сообщение об ошибке, вызвав метод error при построении вашего сообщения. При использовании метода error в Mail-сообщении кнопка призыва к действию будет красной, а не синей:

Настройка получателя

При отправке уведомлений через канал mail , система уведомлений будет автоматически искать свойство email в экземпляре notifiable. Можно настроить какие email-адреса используются для доставки уведомлений, определив в сущности метод routeNotificationForMail :

Настройка темы

По умолчанию тема сообщения — название класса уведомления, форматированное в виде капитализации начальных букв всех слов в предложении («title case»). Таким образом, если класс вашего уведомления носит название InvoicePaid , то тема этого email-сообщения будет Invoice Paid (счет оплачен). Если вы хотите указать явно заданную тему собщения, то можно вызвать метод subject при построении вашего сообщения:

Настройка шаблонов

Вы можете изменить HTML-шаблон и шаблон только с текстом, используемые уведомлениями по почте, опубликовав ресурсы пакета уведомлений. После запуска этой команды шаблоны уведомлений будут располагаться в директории resources/views/vendor/notifications :

Markdown Mail-уведомления

Почтовые уведомления в формате markdown позволяют воспользоваться заранее построенными шаблонами почтовых уведомлений, в то же время давая вам свободу в написании более длинных, настроенные по вашему вкусу сообщений. Так как сообщения пишутся в формате markdown, Laravel может отображать красивые, отзывчивые HTML шаблоны для сообщений, в то же время генерируя их копию исключительно в виде текста.

Генерирование сообщения

Чтобы сгенерировать уведомление с соответствующим Markdown-шаблоном можно использовать опцию —markdown Artisan-команды make:notification :

Как и все другие почтовые уведомления, уведомления с Markdown-шаблонами должны определять метод toMail в классе уведомления. Однако, вместо использования методов line и action для конструирования уведомления, используйте метод markdown для указания названия Markdown-шаблона, который следует использовать:

Написание сообщения

Почтовые уведомления в формате markdown используют комбинацию компонентов Blade и синтаксиса Markdown, что позволяет вам запросто конструировать уведомления, пользуясь предварительно созданными компонентами уведомлений Laravel:

Компонент Button

Компонент кнопки отображает выравненную по центру ссылку-кнопку. Этот компонент принимает два аргумента: url и необязательный color . Поддерживаются цвета: синий blue , зеленый green и красный red . К уведомлению можно добавлять сколько угодно компонентов-кнопок:

Компонент Panel

Этот компонент отображает заданный блок текста на области, у которой цвет заднего фона для заданной области текста слегка отличается от фона остальной части уведомления. Это позволяет привлечь внимание к заданному блоку текста:

Компонент Table

Компонент таблиц позволяет вам трансформировать Markdown-таблица в HTML-таблицу. Этот компонент принимает Markdown-таблицу и ее содержимое. Поддерживается выравнивание столбцов благодаря Markdown синтаксису выравнивания таблиц по умолчанию:

Настройка компонентов

Вы можете экспортировать все Markdown-компоненты уведомления в собственное приложение с целью настройки. Чтобы экспортировать компоненты используйте Artisan-команду vendor:publish для публикации тега ассетов laravel-mail :

Эта команда опубликует почтовые компоненты Markdown в директорию resources/views/vendor/mail . В директории mail будут содержаться директории html и markdown , в каждой из которых содержится соответствующее представление каждого доступного компонента. Вы можете свободно изменять эти компоненты по собственному желанию.

Настройка CSS

После экспортирования компонентов директория resources/views/vendor/mail/html/themes будет содержать файл default.css . Вы можете настроить CSS в этом файле и ваши стили будут автоматически приведены в соответствие с HTML-представлениями ваших Markdown-уведомлений.

Если вы бы хотели построить полностью новую тему для Markdown-компонентов, просто создайте новый файл CSS в директории html/themes и измените параметр theme конфига mail .

БД-уведомления

Требования

Канал уведомлений database хранит информацию уведомления в таблице базы данных. Эта таблица будет содержать такую информацию как тип уведомления, а также пользовательские данные JSON, которые описывают уведомление.

Вы можете запросить, чтобы таблица отображала уведомления в пользовательском интерфейсе вашего приложения. Но, прежде чем вы сможете это сделать, вам потребуется создать таблицу БД, которая будет содержать ваши уведомления. Можно использовать команду notifications:table для генерирования миграции с подходящей схемой таблицы:

Форматирование БД-уведомлений

Если уведомление можно хранить в таблице БД, вам следует задать метод toDatabase или toArray в классе уведомления. Этот метод получит сущность $notifiable и должен вернуть простой PHP массив. Возвращенный массив будет кодирован как JSON и будет храниться в столбце data вашей таблицы notifications . Давайте взглянем на метод-пример toArray :

toDatabase против toArray

Метод toArray также используется каналом broadcast , чтобы определить какие данные вещать вашему JavaScript-клиенту. Если вы хотите, чтобы у вас было два разных представления массива для каналов database и broadcast , вам следует задать метод toDatabase вместо метода toArray .

Доступ к уведомлениям

Если уведомления хранятся в БД, то вам потребуется удобный способ получить к ним доступ из уведомляемых (notifiable) сущностей. Трейт Illuminate\Notifications\Notifiable , который включен в модель Laravel App\User по умолчанию, включает Eloquent-отношение notifications , которое возвращает уведомления для сущности. В целях выборки уведомлений можно получить доступ к данному методу как и к любому другому Eloquent-отношению. По умолчанию уведомления будут отсортированы по метке created_at :

Если вы хотите получить только «непрочитанные» уведомления, можно использовать отношение unreadNotifications . Опять же, эти уведомления будут отсортированы по метке created_at :

Для доступа к уведомлениям из вашего JavaScript-клиента вам следует задать контроллер уведомлений для своего приложения, который будет возвращать уведомления для уведомляемой сущности, такой как текущий пользователь. Затем вы можете выполнить HTTP-запрос к URI этого контроллера из своего JavaScript-клиента.

Пометить уведомления как прочитанные

Как правило, нужно будет помечать уведомления «прочитанными» после того, как пользователь просмотрит эти уведомления. Трейт Illuminate\Notifications\Notifiable предоставляет метод markAsRead , который обновляет столбец read_at в записи уведомления в БД:

Однако, вмето прохождения в цикле по каждому уведомлению можно использовать метод markAsRead напрямую на коллекции уведомлений:

Вы также можете использовать запрос массового обновления, чтобы пометить все уведомления прочитанными без получения их из базы данных:

Конечно, можно удалить ( delete ) уведомления, чтобы полностью убрать их из таблицы:

Бродкаст-уведомления

Требования

Перед вещанием уведомлений вам следует настроить и ознакомиться с сервисами бродкаста событий Laravel. Вещание событий предоставляет способ реагировать на выбрасываемые со стороны сервера события Laravel от вашего JavaScript-клиента.

Форматирование уведомлений вещания

Уведомления вещания канала broadcast , использующие сервисы вещания событий Laravel, позволяют вашему JavaScript-клиенту ловить уведомления в режиме реального времени. Если уведомление поддерживает бродкаст, нужно задать метод toBroadcast в классе уведомления. Этот метод получит сущность $notifiable и должен вернуть экземпляр BroadcastMessage . Возвращаемые данные будут кодированы как JSON и будут отправлены по вебсокет-совдинению вашему JavaScript-клиенту. Рассмотрим пример метода toBroadcast :

Настройка очереди вещания

Все уведомления вещания становятся в очередь на вещание. Если вам нужно настроить подключение очереди или имя очереди, можно использовать методы onConnection и onQueue в BroadcastMessage :

Дополнительно к указываемым данным, уведомления вещания также будут содержать поле type , содержащее имя класса уведомления.

Слушать уведомления

Уведомления будут вещаться на приватном канале, форматированном по конвенции . . Поэтому если вы отправляете уведомление экземпляру App\User с ID равным 1 , уведомление будет вещаться только на приватном канале App.User.1 . При использовании Laravel Echo можно легко слушать уведомления на канале, используя метод-хелпер notification :

Настройка канала уведомлений

Можно задать метод receivesBroadcastNotificationsOn в уведомляемой сущности, если вы хотите настроить по каким каналам уведомляемая сущность будет получать свои уведомления:

SMS-уведомления

Требования

Отправка SMS-уведомлений в Laravel поддерживается благодаря Nexmo. Прежде чем вы сможете отправлять уведомления через Nexmo, вам потребуется установить пакет Composer nexmo/client и добавить несколько опций настройки в свой конфиг config/services.php . Для начала вы можете скопировать пример настройки ниже:

Опция sms_from — это номер телефона, с которого будут отправляться ваши SMS-сообщения. Генерировать номер телефона для вашего приложения следует на панели управления Nexmo.

Форматирование SMS-уведомлений

Если уведомление поддерживает отправку через SMS, нужно задать метод toNexmo в классе уведомления. Данный метод получит сущность $notifiable и должен вернуть экземпляр Illuminate\Notifications\Messages\NexmoMessage :

Юникод-контент

Если ваше SMS-сообщение будет содержать символы в кодировке юникод, нужно вызвать метод unicode во время конструирования экземпляра NexmoMessage :

Настройка номера «From»

Если вам нужно отправить некоторые уведомления с номера, отличающегося от телефонного номера, указанного в файле config/services.php , можно использовать метод from на экземпляре NexmoMessage :

Роутинг SMS-уведомлений

При отправке уведомлений через канал nexmo система уведомлений будет автоматически искать атрибут phone_number уведомляемой сущности. В случае если нужно настроить номер телефона, куда доставляется уведомление, задайте в сущности метод routeNotificationForNexmo :

Slack-уведомления

Требования

Прежде чем начать отправлять уведомления через Slack, вам необходимо установить HTTP библиотеку Guzzle через Composer:

Вам также нужно будет настроить интеграцию «Входящего Веб-хука» («Incoming Webhook») для своей команды Slack. Эта интеграция предоставит URL, который можно использовать при роутинге Slack-уведомлений.

Форматирование Slack-уведомлений

Если уведомление поддерживает отправку в виде Slack-сообщения, то вам нужно задать метод toSlack классу уведомления. Этот метод получит сущность $notifiable и должен возвратить экземпляр Illuminate\Notifications\Messages\SlackMessage . Slack-сообщения могут содержать как текст, так и «вложение», которое форматирует дополнительный текст или массив полей. Рассмотрим базовый пример toSlack пример:

В этом примере мы просто отправляем одну строку текста Slack, что создаст сообщение, которое выглядит следующим образом:

Настройка отправителя и получателя

Можно использовать методы from и to для настройки отправителя и получателя. Метод from принимает в качестве идентификатора имя пользователя и эмоджи, в то время как метод to принимает канал или имя пользователя:

Также в качестве логотипа можно использовать изображение вместо эмоджи:

Slack-вложения

Вы также можете добавлять «вложения» к сообщениям Slack. Вложения обеспечивают более богатые возможности форматирования, чем простые текстовые сообщения. В этом примере мы отправим уведомление об исключении, которое произошло в приложении, включая ссылку для просмотра более подробной информации об исключении:

Пример выше сгенерирует Slack-сообщение, которое выглядит следующим образом:

Вложения также позволяют указывать массив данных, которые нужно презентовать пользователю. Эти данные будут представлены в виде таблицы для упрощения чтения:

Пример выше создаст Slack-сообщение, которое выглядит так:

Markdown содержимое вложения

Если некоторые из полей вашего вложения содержат разметку Markdown, можно использовать метод markdown , чтобы сообщить Slack анализировать и отображать заданные поля вложения как форматированный Markdown-текст:

Роутинг Slack-уведомлений

Чтобы направить Slack-уведомления в подходящее местоположение, задайте метод routeNotificationForSlack вашей уведомляемой сущности. Это должно вернуть URL веб-хука, которому нужно доставить данное уведомление. URL веб-хуков можно генерировать добавляя сервис «Incoming Webhook» своей команде Slack:

События уведомлений

Когда уведомление уже отправлено, системой уведомления выбрасывается событие Illuminate\Notifications\Events\NotificationSent . Оно содержит сущность «notifiable» и сам экземпляр уведомления. Вы можете зарегистрировать слушателей для этого события в своем EventServiceProvider :

После регистрирования слушателей в вашем EventServiceProvider , используйте Artisan-команду event:generate для быстрого генерирования классов слушателей.

В слушателе событий можно получить доступ к свойствам события notifiable , notification и channel , чтобы узнать больше о получателе уведомления или о самом уведомлении:

Пользовательские каналы

Laravel поставляется с несколькими каналами уведомлений, но вы можете захотеть написать свои собственные драйверы для доставки уведомлений по другим каналам. В Laravel это чрезвычайно просто. Для начала определите класс, который содержит метод send . Этот метод должен получать два аргумента: $notifiable и $notification :

Как только был определен класс вашего канала уведомлений, вы можете просто вернуть название класса из метода via любого из ваших уведомлений:

Источник