bravesheep / mailer-url-bundle
Determine Symfony2 mailer settings from a single URL-based parameter
Installs: 27 412
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 4
Forks: 1
Open Issues: 0
Requires
- symfony/config: ~3.4|^4.0
- symfony/dependency-injection: ~3.4|^4.0
- symfony/http-kernel: ~3.4|^4.0
Requires (Dev)
- phpspec/phpspec: ^5.1
This package is auto-updated.
Last update: 2023-03-25 20:56:58 UTC
README
A Symfony2 bundle for parsing the contents of a url that specifies which mailer to use.
Installation and configuration
Using Composer add the bundle to your dependencies using the require
command: composer require bravesheep/mailer-url-bundle:dev-master
.
Add the bundle to your AppKernel
Add the bundle in your app/AppKernel.php
. Note: in order for the
parameters defined by this bundle to be picked up by Swiftmailer, you need to
include this bundle before including the
Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle
bundle.
public function registerBundles() { return array( // ... new Bravesheep\MailerUrlBundle\BravesheepMailerUrlBundle(), // ... ); }
Configure which urls should be rewritten to parameters
For this bundle to work you need to specify which urls need to be rewritten to
basic parameters. This bundle can handle any number of urls by configuring the
correct properties under bravesheep_mailer_url.urls
. Take a look at this
example configuration:
bravesheep_mailer_url: urls: default: url: %mailer_url% prefix: mailer_
In this case we take the value of the mailer_url
parameter and create
parameters from it prefixed with mailer_
.
Usage
Take a look at this parameters.yml.dist
which is distributed by the Symfony2
Standard Edition:
parameters: database_driver: pdo_mysql database_host: 127.0.0.1 database_port: ~ database_name: symfony database_user: root database_password: ~ mailer_transport: smtp mailer_host: 127.0.0.1 mailer_user: ~ mailer_password: ~ locale: en secret: ThisTokenIsNotSoSecretChangeIt debug_toolbar: true debug_redirects: false use_assetic_controller: true
As you can see we need 4 parameters to specify the smtp settings, and that doesn't even include setting the port, encryption or authentication methods in the case of SMTP (which might actually vary on different environments). It would be nice if we could reduce the number of parameters required and specify which mailer to use by specifying a single URL:
parameters: database_driver: pdo_mysql database_host: 127.0.0.1 database_port: ~ database_name: symfony database_user: root database_password: ~ mailer_url: smtp://127.0.0.1 locale: en secret: ThisTokenIsNotSoSecretChangeIt debug_toolbar: true debug_redirects: false use_assetic_controller: true
Still easily readable, but a lot more concise. The BravesheepMailerUrlBundle can
do exactly this. Given the configuration as shown in the previous section and
this configuration the bundle uses mailer_url
to create the
mailer_transport
and mailer_host
with the correct data.
In general this bundle takes any valid mailer url and creates the following
parameters, prefixed with the specified prefix: transport
, host
, port
,
user
, password
, encryption
and auth_mode
.
Accepted URLs
URLs are generally formatted in scheme://user:password@host:port
format. The
following schemes are understood:
smtp
for basic SMTPsmtp+ssl
orssl+smtp
for SMTP with SSL encryptionsmtp+tls
ortls+smtp
for SMTP with TLS encryptiongmail
for the GMail mail transport provided by Symfonymail
for using the internalmail()
function in PHPsendmail
for using the sendmail binary your system provides
The encryption
(besides using the scheme, which is preferred) and
auth_mode
parameters can be specified via query parameters, for example:
smtp://user:pass@localhost/?encryption=tls&auth_mode=plain
. Valid values for
auth_mode
are plain
, login
and cram-md5
.
Gmail URLs may be specified by leaving the everything after the authentication
string out, for example: gmail://user@gmail.com:password
. For mail and
sendmail you can use: mail://
or mail
, and sendmail://
or sendmail
respectively.