Download the PHP package cri2net/email without Composer
On this page you can find all versions of the php package cri2net/email. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cri2net/email
More information about cri2net/email
Files in cri2net/email
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package email
README
Это надстройка над PHPMailer для работы с шаблонами Эта библиотека предназначена для отправки email как сразу, так и по крону, с минимальной (для простоты) поддержкой шаблонов.
Установка
Установка библиотеки
Таблица в БД
Для лучшей интеграции будет удобно создать таблицу в базе данных. Однако это не обязательно для работы. Не забывайте просматривать файл install.sql при обновлениях версии. Также, поддерживаются автоматические SQL миграции на основе пакета placebook/framework-selfupdate
Описание полей:
- id: Идентификатор записи
- status: Статус отправки
- to_email: E-mail получателя
- to_username: Имя получателя
- created_at: unix время создания записи
- updated_at: unix время последнего изменения записи
- send_at: unix время фактической отправки sms
- min_sending_time: unix время минимального момента времени, когда можно отправлять письмо - для отложенной отправки
- type: одно из значений: raw_text, raw_html, html_template (по умолчанию)
- template: ключ шаблона
- raw_body: текст сообщения, есть поддержка "макросов"
- replace_data: JSON строка с правилами замен
- settings: JSON строка с массивом настроек (ключи массива должны совпадать с доступными полями PHPMailer)
Логика отправки из БД (по крону)
Метод sendEmailByCron по очереди обработает все письма, которые имеют подходящий статус и минимальное время отправки.
Если шаблон задан, класс пытается взять из него контент письма. Шаблон хранится в виде файла {template_name}.tpl в папке, путь к которой нужно задать в параметр $folder класса. Если есть файл __main.tpl, который находится в этой же папке, то класс будет считать, что там находится основная обёртка для письма, а контент письма перезаменит собой макрос {{MAIN_CONTENT}} в тексте этого основного шаблона. То есть, файл __main.tpl должен содержать текст {{MAIN_CONTENT}}, и вместо этого текста будет подключён конкретный указанный шаблон.
В шаблоне можно использовать переменные, обрамленные двойными фигурными скобками: {{some_var}}
Довольно важно указывать текстовую версию для письма. PHPMailer умеет генерировать её на основе html версии, но часто это получается коряво. Чтоб хранить plain text версию в шаблоне (файле), необходимо хранить её по пути {$this->folder}/plain_text/$template.tpl
Также, класс загружает статический контент в inline вложения
All versions of email with dependencies
ext-json Version *
cri2net/php-pdo-db Version ^1.2
phpmailer/phpmailer Version ^6.1.6