PHPackages makinacorpus/drupal-netsmtp - 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. [Mail & Notifications](/categories/mail) 4. / 5. makinacorpus/drupal-netsmtp ActiveDrupal-module[Mail & Notifications](/categories/mail) makinacorpus/drupal-netsmtp =========================== Drupal SMTP module based upon PEAR::Net\_SMTP 2.2.0(7y ago)51103[3 issues](https://github.com/makinacorpus/drupal-netsmtp/issues)GPL-2.0-or-laterPHP Since Feb 16Pushed 7y ago21 watchersCompare [ Source](https://github.com/makinacorpus/drupal-netsmtp)[ Packagist](https://packagist.org/packages/makinacorpus/drupal-netsmtp)[ Docs](http://github.com/makinacorpus/drupal-netsmtp)[ RSS](/packages/makinacorpus-drupal-netsmtp/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (1)Versions (8)Used By (0) Net SMTP ======== [](#net-smtp) SMTP connector using Net\_SMTP PEAR library. Runtime configuration --------------------- [](#runtime-configuration) ### Drupal mail system configuration [](#drupal-mail-system-configuration) For your convenience, this module uses a specific Drupal mail system implementation that acts as a proxy which lets you use different formatter and mailer. In order to use it, simply add to your settings.php file: ``` $conf['mail_system'] = [ 'default-system' => '\\MakinaCorpus\\Drupal\\NetSmtp\\MailSystemProxy' ]; ``` Then you can set the formatter this way: ``` $conf['netsmtp_proxy'] = [ 'default' => 'MimeMailSystem', ]; ``` If you need to specify specific formatters for other modules, you can use this variable the exact same way you would use the core 'mail\_system' variable: ``` $conf['netsmtp_proxy'] = [ 'default' => 'MimeMailSystem', 'MYMODULE' => 'SomeOtherFormatter', 'MYMODULE_MYMAIL' => 'YetAnotherFormatter', ]; ``` And that's pretty much it. ### SMTP configuration [](#smtp-configuration) At minima you would need to specify your SMTP server host: ``` $conf['netsmtp'] = [ 'default' => [ 'hostname' => '1.2.3.4' ], ]; ``` Hostname can be an IP or a valid hostname. In order to work with SSL, just add the 'use\_ssl' key with true or false. You can set the port if you wish using the 'port' key. If you need authentication, use this: ``` $conf['netsmtp'] = [ 'default' => [ 'hostname' => 'smtp.provider.net', 'username' => 'john', 'password' => 'foobar', ], ]; ``` And additionnaly, if you need to advertise yourself as a different hostname than the current localhost.localdomain, you can set the 'localhost' variable. An complete example: ``` $conf['netsmtp'] = [ 'default' => [ 'hostname' => 'smtp.provider.net', 'port' => 465, 'use_ssl' => true, 'username' => 'john', 'password' => 'foobar', 'localhost' => 'host.example.tld', ], ]; ``` Note that for now this only supports the PLAIN and LOGIN authentication methods, I am definitly too lazy to include the Auth\_SASL PEAR package as well. Additionnaly, you can change the 'use\_ssl' paramater to the 'tls' value instead, and hope for the best to happen, it should force the Net::SMTP library to do a TLS connection instead. ### Advanced SMTP configuration [](#advanced-smtp-configuration) Additionnaly you can define a set of servers, for example if you need a mailjet or mandrill connection: ``` $conf['netsmtp'] = [ 'default' => [ 'host' => '1.2.3.4', 'ssl' => true, ], 'mailjet' => [ 'host' => '1.2.3.4', 'ssl' => true, 'user' => 'john', 'pass' => 'foobar', ], ]; ``` You can then force mails to go throught another server than default by setting the 'smtp\_provider' key in the Drupal $message array when sending mail. Identifying the project ----------------------- [](#identifying-the-project) If you need to identify mails from various projects and environments you may use one of, or any combination of the two the following variables: ``` $conf['netsmtp_project_name'] = 'My client business project'; $conf['netsmtp_project_env'] = 'staging'; ``` Both are arbitrary values that could be set to any value without creating any side effect to mail being sent. They both map to additional mail headers being added ot mails: - `X-Project-Name` will contain the `netsmtp_project_name` value, - `X-Project-Env` will contain the `netsmtp_project_env` value. There is one exception, if `netsmtp_project_env` begins with `prod` (case insensitive) then the `X-Project-Env` header will be dropped, and mail subject will be left untouched, no matter what other debug options are set. Per default, setting the environment to anything else than a string begining with the `prod` substring, subject will be altered and will start with a string containing the project name and project environment. To deactivate this alteration, just set: ``` $conf['netsmtp_project_expose_subject'] = false; ``` ### Add additional fixed headers to all outgoing mail [](#add-additional-fixed-headers-to-all-outgoing-mail) You may, for various purposes, need to add arbitrary platform driven headers to your mail, for this: ``` $conf['netsmtp_additional_headers'] = [ 'X-FORWARD' => 'some value', 'X-USERNAME' => '...', // ... ]; ``` ### Overriding the proxy [](#overriding-the-proxy) Additionnaly, if you have specific business needs, you can override the proxy class, start by writing your own such as: ``` use MakinaCorpus\Drupal\NetSmtp\MailSystemProxy MyProxy extends MailSystemProxy { // Do something } ``` Then register it in any autoloader. Then, tell the net-smtp module to use it instead of the stock provided one into your settings.php file: ``` $conf['mail_system'] = [ 'default-system' => 'MyProxy' ]; ``` ### Additional configuration [](#additional-configuration) Per default this module uses the Drupal native function correctly encode mail subjects, if you use a formatter that does the job for you, set the *netsmtp\_subject\_encode* to false to deactivate this behavior: ``` $conf['netsmtp_subject_encode'] = false; ``` Testing ------- [](#testing) ### Testing your Drupal configuration [](#testing-your-drupal-configuration) This module provide a drush command to test your configuration: ``` drush netsmtp-config-test mommy@myfamily.com ``` Please note that if you configured debug options, they will remain activated and mail will be routed accordingly if configured for. ### Testing an SMTP connection [](#testing-an-smtp-connection) This module provide a drush command to test your SMTP connection: ``` drush netsmtp-smtp-test \ --hostname=mail.makina-corpus.net --port=465 --use_ssl=tls --username=john.smith@example.com --password=ask mommy@myfamily.com ``` Only the `hostname` parameter is mandatory. If you set `ask` as the passowrd, drush will prompt it securely without displaying it. Please note that all of the module configuration will be bypassed, if you configured mail catching, it will be skipped and the test mail will really be sent. Debugging --------- [](#debugging) ### Re-route all outgoing mail [](#re-route-all-outgoing-mail) This feature is useful when working in a development phase where you don't want mails to be sent to their real recipients. In order to activate it just set: ``` $conf['netsmtp_catch'] = 'someuser@example.com'; ``` Moreover, you can set multiple recipients: ``` $conf['netsmtp_catch'] = [ 'user1@example.com', 'user2@example.com', 'user3@example.com', // ... ]; ``` Be careful that this is a debug feature and the recipient user addresses won't be processed in any way, which means that you can set a mail address containing a ',' character, it won't be escaped. ### Sent data dumping [](#sent-data-dumping) Additionally you can enable a debug output that will dump all MIME encoded messages this module will send onto the file system. Just set: ``` $conf['netsmtp_debug_mime'] = true; ``` And every mail will be dumped into the following Drupal temp folder: ``` temporary://netsmtp/YYYY-MM-DD/ ``` Additionnaly you can change the path using this variable: ``` $conf['netsmtp_debug_mime_path'] = 'private://netsmtp'; ``` ### Sent mail trace [](#sent-mail-trace) This probably should belong to another module, but if you need extensive mail tracing logging, you can enable: ``` $conf['netsmtp_debug_trace'] = true; ``` This will activate a *hook\_mail\_alter()* implementation that will log every mail activity sent by the plateform in a single file: ``` temporary://netsmtp/netsmtp-trace-YYYY-MM-DD.log ``` In this file you'll find various internal Drupal modules information about the mails being sent, including the stack trace at the time the mail is beint sent. Additionnaly you can change the path using this variable: ``` $conf['netsmtp_debug_trace_path'] = 'private://netsmtp'; ``` History ------- [](#history) Drupal contrib already has a nice SMTP module called "SMTP" which can be found at the following URL: ``` http://www.drupal.org/project/smtp ``` But in real life, this modules attempts to use the PHPMailer library to connect to the SMTP server, which can found at: ``` https://github.com/PHPMailer/PHPMailer ``` If you look at it a bit more, you'll see that PHPMailer is not an SMTP connector, while it can, its main goal is to format the MIME messages for you. Whenever you use Drupal with a module such as MIMEMail which can be found at: ``` http://www.drupal.org/project/mimemail ``` you'll notice that your messages are already well formatted in a very precise and valid MIME enveloppe. *What happens behind this scenario is that the SMTP module needs to deconstruct the valid MIME encoded message in order to be able to use the PHPMailer API which then will attempt to rebuild a MIME message.* In real life, it does not, it does deconstrut your MIME encoded message, but in a very wrong way, and breaks it in a lot cases. ### Health Score 30 — LowBetter than 65% of packages Maintenance8 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community17 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 97.4% 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 ~103 days Recently: every ~154 days Total 7 Last Release 2750d ago Major Versions 1.0.x-dev → 2.0.02017-02-17 ### Community Maintainers ![](https://www.gravatar.com/avatar/69252826f3a70a19fc5dcefb7ef9d26d465bb300245641abb4dd89d0ec391a66?d=identicon)[pounard](/maintainers/pounard) ![](https://www.gravatar.com/avatar/d21b98752b406528da88850922b1061f39bf72eb2126b413d5c12e275811a40b?d=identicon)[Makina Corpus](/maintainers/Makina%20Corpus) --- Top Contributors [![pounard](https://avatars.githubusercontent.com/u/341855?v=4)](https://github.com/pounard "pounard (37 commits)")[![joelpittet](https://avatars.githubusercontent.com/u/70129?v=4)](https://github.com/joelpittet "joelpittet (1 commits)") ### Embed Badge ![Health badge](/badges/makinacorpus-drupal-netsmtp/health.svg) ``` [![Health](https://phpackages.com/badges/makinacorpus-drupal-netsmtp/health.svg)](https://phpackages.com/packages/makinacorpus-drupal-netsmtp) ``` ### Alternatives [tijsverkoyen/css-to-inline-styles CssToInlineStyles is a class that enables you to convert HTML-pages/files into HTML-pages/files with inline styles. This is very useful when you're sending emails. 5.8k505.3M228](/packages/tijsverkoyen-css-to-inline-styles)[minishlink/web-push Web Push library for PHP 1.9k12.0M52](/packages/minishlink-web-push)[laravel-notification-channels/twilio Provides Twilio notification channel for Laravel 2587.7M12](/packages/laravel-notification-channels-twilio)[spatie/url-signer Generate a url with an expiration date and signature to prevent unauthorized access 4422.3M16](/packages/spatie-url-signer)[mattketmo/email-checker Throwaway email detection library 2742.0M5](/packages/mattketmo-email-checker)[eduardokum/laravel-mail-auto-embed Library for embed images in emails automatically 1702.0M5](/packages/eduardokum-laravel-mail-auto-embed) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)