Download the PHP package locomotivemtl/charcoal-email without Composer
On this page you can find all versions of the php package locomotivemtl/charcoal-email. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download locomotivemtl/charcoal-email
More information about locomotivemtl/charcoal-email
Files in locomotivemtl/charcoal-email
Package charcoal-email
Short Description Email sending and queueing for Charcoal
License MIT
Homepage https://charcoal.locomotive.ca
Informations about the package charcoal-email
Charcoal Email
Sending emails (with PHPMailer) and queue management.
How to install
The preferred (and only supported) way of installing charcoal-email is with composer:
Dependencies
PHP 5.6+
- PHP 7.3+ is highly recommended
phpmailer/phpmailer
locomotivemtl/charcoal-config
locomotivemtl/charcoal-app
Optional dependencies
pimple/pimple
- Dependency injection Container (required for the Service Provider)
👉 All optional depedencies are required for development. All other development dependencies, which are optional when using charcoal-email in a project, are described in the Development section of this README file.
Usage
Email Config
The entire email system can be configured from the main app config, in the email
config key.
Service Provider
All email services can be quickly registered to a (pimple
) container with \Charcoal\Email\ServiceProvider\EmailServiceProvider
.
Provided services:
Service | Type | Description |
---|---|---|
Email 1 |
An email object (factory). | |
email/factory | FactoryInterface 2 |
An email factory, to create email objects. |
1 \Charcoal\Email\Email
.
2 Charcoal\Factory\FactoryInterface
.
Also available are the following helpers:
Helper Service | Type | Description |
---|---|---|
email/config | EmailConfig 3 |
Email configuration. |
email/view | ViewInterface 4 |
The view object to render email templates ($container['view'] ). |
3 \Charcoal\Email\EmailConfig
.
4 \Charcoal\View\ViewInterface
.
👉 For charcoal projects, simply add this provider to your config to enable:
Service dependencies
For the email service provider to work properly, the following services are expected to e registerd on the same container:
config
view
Development
To install the development environment:
To run the scripts (phplint, phpcs and phpunit):
Development dependencies
phpunit/phpunit
squizlabs/php_codesniffer
satooshi/php-coveralls
Continuous Integration
Service | Badge | Description |
---|---|---|
Travis | Runs code sniff check and unit tests. Auto-generates API documentation. | |
Scrutinizer | Code quality checker. Also validates API documentation quality. | |
Coveralls | Unit Tests code coverage. | |
Sensiolabs | Another code quality checker, focused on PHP. |
Coding Style
The Charcoal-Email module follows the Charcoal coding-style:
- PSR-1
- PSR-2
- PSR-4, autoloading is therefore provided by Composer.
- phpDocumentor comments.
- Read the phpcs.xml file for all the details on code style.
Coding style validation / enforcement can be performed with
composer phpcs
. An auto-fixer is also available withcomposer phpcbf
.
Authors
License
Charcoal is licensed under the MIT license. See LICENSE for details.
All versions of charcoal-email with dependencies
psr/log Version ^1.0
phpmailer/phpmailer Version ~6.0
locomotivemtl/charcoal-config Version ~0.6
locomotivemtl/charcoal-app Version ~0.6
locomotivemtl/charcoal-queue Version ~0.5
seld/jsonlint Version ^1.7
ext-pdo Version *