Download the PHP package druidvav/email-bundle without Composer
On this page you can find all versions of the php package druidvav/email-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download druidvav/email-bundle
More information about druidvav/email-bundle
Files in druidvav/email-bundle
Package email-bundle
Short Description Transactional email bundle for Symfony 4.4/5.4/6.4 (Twig, Symfony Mailer).
License MIT
Homepage https://github.com/druidvav/email-bundle
Informations about the package email-bundle
DvEmailBundle
Бандл для Symfony 4: транзакционные письма с рендером Twig, инлайном CSS (Emogrifier), опциональным встраиванием картинок и событиями жизненного цикла. Отправка через Symfony Mailer (symfony/mailer).
Требования
- PHP ≥ 7.4
- Symfony 4.4 (
symfony/framework-bundle,symfony/twig-bundle,symfony/event-dispatcher,symfony/translation) symfony/mailer(подтягиваетsymfony/mime)
Установка
Подключите бандл в config/bundles.php:
В приложении должны быть включены FrameworkBundle, TwigBundle, настроен Symfony Mailer (framework.mailer) и объявлен хотя бы один сервис MailerInterface (обычно mailer).
Возможности
- Шаблоны: subject, plain text и HTML из Twig; путь к шаблонам задаётся в конфиге (
template_path). - CSS в HTML: внешний файл стилей, инлайн через Pelago Emogrifier; опциональное кеширование предобработанного HTML в
kernel.cache_dir. - Встраивание изображений: подмена URL на
cid:при включённой секцииembed_images. - События — отдельные классы в
Druidvav\DvEmailBundle\Event\:
BeforeRenderHtmlEvent,AfterRenderHtmlEvent,BeforeSendEvent,AfterSendEvent.
Подписка по FQCN (или константы вDvEmailEvent, равные этим классам). Диспатч: один аргументdispatch($event). - Локали: при наличии секции
locale:слушатель подменяетRequestContext, локаль переводчика и (опционально) Gedmo Translatable на время рендера письма, затем восстанавливает состояние. - Несколько профилей
sender: разные алиасы (напримерdefault/subscribe) — разные сервисыMailerInterface, если в приложении заведено несколько mailer’ов. Запасной SMTP настраивается в Symfony Mailer (цепочка транспортов,failover()в DSN и т.д.), а не отдельнымmailer_fallbackв бандле. - Реестр сообщений: сервис
dv_email.locator(Symfony\Component\DependencyInjection\ServiceLocator) по алиасам изmessage.
Конфигурация
Корневой ключ: dv_email. Структура: message, sender, опционально locale.
Минимальный пример см. в документацию Mailer.
Использование в коде
Через контейнер получите dv_email.message (алиас на сообщение с алиасом default) или dv_email.locator для выбора по имени. Сообщение: Druidvav\DvEmailBundle\Message\Message — вызовите setTo(), setTemplate(), при необходимости setLocale(), затем render() и send(), либо сразу send() (рендер выполнится сам).
Трейт DvEmailAwareTrait ожидает внедрения локатора сообщений (например, dv_email.locator как Psr\Container\ContainerInterface) — настройте вызов setDvEmailLocator в вашем services.yaml, если используете трейт.
Документация по обновлению
Переход с версии на SwiftMailer описан в MIGRATION.md.
All versions of email-bundle with dependencies
symfony/framework-bundle Version ^4.4 || ^5.4 || ^6.4 || ^7.0
symfony/event-dispatcher Version ^4.4 || ^5.4 || ^6.4 || ^7.0
symfony/twig-bundle Version ^4.4 || ^5.4 || ^6.4 || ^7.0
symfony/translation Version ^4.4 || ^5.4 || ^6.4 || ^7.0
symfony/mailer Version ^4.4 || ^5.4 || ^6.4 || ^7.0
ramsey/uuid Version ~3.9.3
pelago/emogrifier Version ^7.0