PHPackages oleg-chulakov-studio/yii2-queue-mailer - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Queues & Workers](/categories/queues) 4. / 5. oleg-chulakov-studio/yii2-queue-mailer ActiveYii2-components[Queues & Workers](/categories/queues) oleg-chulakov-studio/yii2-queue-mailer ====================================== Mailer with send message via queue. 1.0.5(5y ago)42.4k↓100%1BSD-3-ClausePHPPHP >=5.6.0 Since Dec 11Pushed 5y ago7 watchersCompare [ Source](https://github.com/OlegChulakovStudio/yii2-queue-mailer)[ Packagist](https://packagist.org/packages/oleg-chulakov-studio/yii2-queue-mailer)[ RSS](/packages/oleg-chulakov-studio-yii2-queue-mailer/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (2)Versions (8)Used By (0) Yii2 Queue Mailer ================= [](#yii2-queue-mailer) Компонент отправки почты путем постановки ее в очередь. Компонент полностью имплементирует весь функционал мейлера и может быть использован как основной мейлер, без потери привычного функционала. Установка --------- [](#установка) Для подключения компонентов в свой код необходимо добавить в *composer.json* следующий код: ``` "oleg-chulakov-studio/yii2-queue-mailer": "dev-master" ``` Или набрать команду: ``` composer require oleg-chulakov-studio/yii2-queue-mailer ``` Выполнение миграций: ``` php yii migrate/up --migrationPath="@vendor/oleg-chulakov-studio/yii2-queue-mailer/src/migrations" ``` Настройка --------- [](#настройка) Майлер зависит от нескольких компонентов, которые так же необходимо настроить и передать их названия через конфигурацию. **queue** В первую очередь зависимость касается непосредственно компонента постановки задания в очередь. Подробно про его конфигурацию можно почитать в официальной документации: [Yii2-Queue](https://github.com/yiisoft/yii2-queue/blob/master/docs/guide-ru/usage.md) **mailer** Вторым важным компонентом является непосредственно [Swift Mailer](https://github.com/yiisoft/yii2-swiftmailer). Через который будет осуществляться отправка почты из задания в очереди. К тому же данный компонент может отправить письмо автоматически через него, если не будет настроен компонент очереди или процедура постановки в очередь прервется и не будет выполнена. Данное поведение можно отключить через конфигурацию. **attachment** Третий желаемый компонент находится в этом пакете и является хранилищем и обработчиком прикрепляемых (внедряемых) файлов к письму. Поскольку мейлер имеет возможность прикрепить файлы не сохраненные на диске, хранить такие файлы в базе данных не выгодно и они могут быть сохранены во временном каталоге и в дальнейшем успешно прикреплены к оригинальному сообщению. Так же компонент может продублировать все файлы во временный каталог, если необходимо сохранять текущие версии файлов для отправки. ``` 'attachment' => [ 'class' => 'chulakov\queuemailer\AttacheStorage', 'storageAll' => false, 'storageClear' => true, 'storagePath' => '@runtime/attachments', ] ``` - **storageAll** - Копировать ли все прикрепляемые файлы. По умолчанию `false`. - **storageClear** - Необходимость удаление всех временных файлов сообщения после отправки. По умолчанию `true`. - **storagePath** - Папка в которую будут сохранены прикрепляемые файлы. По умолчанию `@runtime/attachments`. Для каждого письма **со вложениями** будет создана своя папка. **queuemailer** Настройка компонента отложенной отправки почты имеет множество похожих параметров при настройке: ``` 'queuemailer' => [ 'class' => 'chulakov\queuemailer\Mailer', 'messageClass' => 'chulakov\queuemailer\Message', 'storageClass' => 'chulakov\queuemailer\models\QueueMail', 'jobClass' => 'chulakov\queuemailer\jobs\MessageJob', // Базовый мейлер 'viewPath' => '@common/mail', 'useFileTransport' => false, 'messageConfig' => [ ... ], // Настройка компонентов 'attacheComponent' => 'attachment', 'mailerComponent' => 'mailer', 'componentName' => 'queuemailer', 'queueComponent' => 'queue', ], ``` - **messageClass** - Класс сообщения, используемый для компоновки сообщения перед отправкой. - **storageClass** - Класс модели, в которой будет храниться вся информация о сформированном сообщении. Должен реализовать интерфейс `MailStorageInterface`, реализуя метод `findById`, который должен вернуть модель с сохраненными данными по ее ID. - **jobClass** - Класс задания, которое будет обрабатывать отправку сообщения из очереди. Должно реализовать интерфейс `MessageJobInterface`, реализуя метод `create` для создания задания. Класс можно поменять на лету, перед каждой отправкой сообщения, через функцию `setJobClass`. - **viewPath** - Устанавливает папку с шаблонами письма. При отсроченной отправке, данную настройку достаточно указать только в данном компоненте, поскольку `mailerComponent` не будет осуществлять генерацию письма, а только заниматься его отправкой. - **useFileTransport** - Если данный параметр установлен в `true`, то компонент не будет пытаться отправить почту через компонент `mailerComponent`, а только пытаться сохранить его в базу. - **messageConfig** - Может так же, как и базовый класс сообщения, получать все настройки письма, но так же приобретает возможность установить конфигурацию для сериализатора полем `serializer`. Компонент сериализации должен реализовать интерфейс `SerializerInterface`. - **attacheComponent** - Компонент обработки прикрепляемых файлов. Если не будет настроен, то будет возможность прикреплять только существующие файлы на диске. - **mailerComponent** - Имя компонента для отправки почты. Должен ссылаться на `Yii2-swiftmailer`. Если компонент не будет настроен, сообщения, что не попадут в очередь, вернут `false` при отправке сообщения. Так же может не настраиваться при указании `'useFileTransport' => true`, поскольку не будет осуществляться попытки отправить реальное сообщение. - **componentName** - Имя текущего или другого компонента, доступного из консольного приложения. Название будет храниться в базе с заданием и использоваться при извлечении сообщения и отправки почты через вложеннего мейлера (@see mailerComponent, который обязательно должен быть настроен в консольном приложении). - **queueComponent** - Имя компонента, используемого для постановки сообщения в очередь. Если все сообщения планируется отправлять через отложенную отправку, возможно настроить компонент мейлером по умолчанию, зарегестрировав его под именем `mailer`и передав, наспример, в `'mailerComponent' => 'swiftmailer'`. ### Health Score 33 — LowBetter than 75% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity25 Limited adoption so far Community10 Small or concentrated contributor base Maturity63 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~202 days Recently: every ~253 days Total 6 Last Release 2062d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a7cb11be37853072fe7ab807b40211e2c135bc04bf5c7c79d9c523dc4022ed2d?d=identicon)[Oleg Chulakov Studio](/maintainers/Oleg%20Chulakov%20Studio) --- Top Contributors [![ikchulakov](https://avatars.githubusercontent.com/u/32455466?v=4)](https://github.com/ikchulakov "ikchulakov (62 commits)") ### Embed Badge ![Health badge](/badges/oleg-chulakov-studio-yii2-queue-mailer/health.svg) ``` [![Health](https://phpackages.com/badges/oleg-chulakov-studio-yii2-queue-mailer/health.svg)](https://phpackages.com/packages/oleg-chulakov-studio-yii2-queue-mailer) ``` ### Alternatives [zhuravljov/yii2-queue-monitor Yii2 Queue Analytics Module 102203.2k](/packages/zhuravljov-yii2-queue-monitor)[trntv/yii2-command-bus Yii2 Command Bus extension 57625.1k8](/packages/trntv-yii2-command-bus)[bubasuma/yii2-simplechat A simple chat for your yii2 application 889.5k](/packages/bubasuma-yii2-simplechat) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)