moudarir / mailer

1.0.1 2026-11-10 19:01 UTC

Requires

• php: >=8.4
• ext-iconv: *
• moudarir/file: ^1.0
• moudarir/helpers: ^1.3

MIT

• Abdessamad MOUDARIR

• mailer
• php
• email
• html
• smtp
• plain text
• attachment

Published on Packagist.org on 2026-11-10 19:02 UTC

README

moudarir/mailer is a modern, dependency-light, and robust PHP package designed to handle email transmissions seamlessly. Whether you are working on a minimalist legacy project or a modern application, it provides a unified API to dispatch emails through multiple transport layers.

Key Features

• Multiple Transport Drivers: Switch effortlessly between different sending mechanisms:
  • PHP mail(): Native PHP mail function for standard setups.
  • Sendmail: Direct integration with local Sendmail binaries.
  • SMTP: Fully configurable SMTP transport supporting secure connections (TLS/SSL) and authentication.
• Modern PHP: Built with strict types and optimized for PHP 8.4+.
• RFC-Compliant: Proper handling of headers, encodings (like Q-encoding), and multi-part messages.
• Zero Bloat: Minimal external dependencies for maximum performance and security.

Requirements

• PHP 8.4+
• ext-iconv extension

Installation

composer require moudarir/mailer

Usage

Native PHP mail function

Default:

<?php

use Moudarir\Mailer\Mailer;
use Moudarir\Mailer\Exceptions\MailerException;

try {
    new Mailer()
        ->from('[e-mail]', 'No Reply')
        ->to('[e-mail]')
        ->subject($subject)
        ->body($html, $plain)
        ->send();
} catch (MailerException $exception) {
    error_log($exception->getMessage());
}

With attachment:

<?php

use Moudarir\Mailer\Mailer;
use Moudarir\Mailer\Exceptions\MailerException;

try {
    new Mailer()
        ->from('[e-mail]', 'No Reply')
        ->to('[e-mail]')
        ->subject($subject)
        ->body($html, $plain)
        ->attachments(['filepath' => '/path/to/picture.jpg'])
        ->send();
} catch (MailerException $exception) {
    error_log($exception->getMessage());
}

With multiple attachments:

<?php

use Moudarir\File\Enum\MimeType;
use Moudarir\Mailer\Mailer;
use Moudarir\Mailer\Exceptions\MailerException;

try {
    new Mailer()
        ->from('[e-mail]', 'No Reply')
        ->to('[e-mail]')
        ->subject($subject)
        ->body($html, $plain)
        ->attachments([
            ['filepath' => '/path/to/picture.jpg'],
            ['filepath' => '/path/to/document.docx', 'filename' => 'My document.docx'],
            ['filepath' => '/path/to/archive.zip', 'mimeType' => MimeType::ZIP],
        ])
        ->send();
} catch (MailerException $exception) {
    error_log($exception->getMessage());
}

Using local Sendmail binaries

<?php

use Moudarir\Mailer\Mailer;
use Moudarir\Mailer\MailerConfig;
use Moudarir\Mailer\Enums\Protocol;
use Moudarir\Mailer\Exceptions\MailerException;

try {
    new Mailer(config: new MailerConfig(protocol: Protocol::SENDMAIL, sendmailPath: '/usr/sbin/sendmail'))
        ->from('[e-mail]', 'No Reply')
        ->to('[e-mail]')
        ->subject($subject)
        ->body($html, $plain)
        ->send();
} catch (MailerException $exception) {
    error_log($exception->getMessage());
}

Using SMTP transport

<?php

use Moudarir\Mailer\Mailer;
use Moudarir\Mailer\MailerConfig;
use Moudarir\Mailer\Enums\Protocol;
use Moudarir\Mailer\Exceptions\MailerException;

try {
    $config = new MailerConfig(
        protocol: Protocol::SMTP,
        smtpHost: 'smtp.mailserver.com',
        smtpUser: '[e-mail]',
        smtpPass: 'your-password',
        smtpPort: 587,
        smtpCrypto: 'tls',
    );
    new Mailer(config: $config)
        ->from('[e-mail]', 'No Reply')
        ->to('[e-mail]')
        ->subject($subject)
        ->body($html, $plain)
        ->send();
} catch (MailerException $exception) {
    error_log($exception->getMessage());
}

License

This package is open-sourced software licensed under the MIT license.