Works with Multiple Email Config

[warcooft]

Run

php spark make:config MultiEmail

Then paste this.

<?php

/**
 * This file is part of CodeIgniter 4 framework.
 *
 * (c) 2024 CodeIgniter Foundation <syamsuddine9@icloud.com>
 *
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

namespace Config;

use CodeIgniter\Config\BaseConfig;

class MultiEmail extends BaseConfig
{
    public string $defaultGroup = 'default';

    public array $default = [
        'fromEmail'     => '', //Your Email
        'fromName'      => '', //Your Name
        'recipients'    => '',
        'userAgent'     => 'CodeIgniter',
        'protocol'      => 'smtp',
        'mailPath'      => '/usr/sbin/sendmail',
        'SMTPHost'      => 'smtp.gmail.com',
        'SMTPUser'      => '', //Your User. Example: jhon@gmail.com
        'SMTPPass'      => '', //Email Password 
        'SMTPPort'      => 587,
        'SMTPTimeout'   => 30,
        'SMTPKeepAlive' => false,
        'SMTPCrypto'    => 'tls',
        'wordWrap'      => true,
        'wrapChars'     => 76,
        'mailType'      => 'html',
        'charset'       => 'UTF-8',
        'validate'      => false,
        'priority'      => 3,
        'CRLF'          => "\r\n",
        'newline'       => "\r\n",
        'BCCBatchMode'  => false,
        'BCCBatchSize'  => 200,
        'DSN'           => false,
    ];

    public array $outlook = [
       'fromEmail'     => '', //Your Email
        'fromName'      => '', //Your Name
        'recipients'    => '',
        'userAgent'     => 'CodeIgniter',
        'protocol'      => 'smtp',
        'mailPath'      => '/usr/sbin/sendmail',
        'SMTPHost'      => 'smtp.office365.com',
        'SMTPUser'      => '', //Your User. Example: jhon@gmail.com
        'SMTPPass'      => '', //Email Password 
        'SMTPPort'      => 587,
        'SMTPTimeout'   => 30,
        'SMTPKeepAlive' => false,
        'SMTPCrypto'    => 'tls',
        'wordWrap'      => true,
        'wrapChars'     => 76,
        'mailType'      => 'html',
        'charset'       => 'UTF-8',
        'validate'      => false,
        'priority'      => 3,
        'CRLF'          => "\r\n",
        'newline'       => "\r\n",
        'BCCBatchMode'  => false,
        'BCCBatchSize'  => 200,
        'DSN'           => false,
    ];
}

in app/Helpers create file multi_email_helper.php then paste this function.

<?php

declare(strict_types=1);

/**
 * This file is part of CodeIgniter Shield.
 *
 * (c) CodeIgniter Foundation <admin@codeigniter.com>
 *
 * For the full copyright and license information, please view
 * the LICENSE file that was distributed with this source code.
 */

use CodeIgniter\Email\Email;

if (! function_exists('multi_email')) {
    /**
     * Provides convenient access to the CodeIgniter Email class.
     *
     * @param array<string, mixed> $overrides Email preferences to override.
     *
     * @internal
     */
    function multi_email(array $overrides = [], string $group = ''): Email
    {
        if (!setting('MultiEmail.' . $group)) {
            throw new Exception("Cannot send email from 'multi_email' helper.\n Undefined group name:  $group");
        }

        $defaultGroup  = !empty($group) ? $group : setting('MultiEmail.defaultGroup');

        $config = [
            'fromEmail'     => setting('MultiEmail.' . $defaultGroup)['fromEmail'],
            'fromName'      => setting('MultiEmail.' . $defaultGroup)['fromName'],
            'userAgent'     => setting('MultiEmail.' . $defaultGroup)['userAgent'],
            'protocol'      => setting('MultiEmail.' . $defaultGroup)['protocol'],
            'mailPath'      => setting('MultiEmail.' . $defaultGroup)['mailPath'],
            'SMTPHost'      => setting('MultiEmail.' . $defaultGroup)['SMTPHost'],
            'SMTPUser'      => setting('MultiEmail.' . $defaultGroup)['SMTPUser'],
            'SMTPPass'      => setting('MultiEmail.' . $defaultGroup)['SMTPPass'],
            'SMTPPort'      => setting('MultiEmail.' . $defaultGroup)['SMTPPort'],
            'SMTPTimeout'   => setting('MultiEmail.' . $defaultGroup)['SMTPTimeout'],
            'SMTPKeepAlive' => setting('MultiEmail.' . $defaultGroup)['SMTPKeepAlive'],
            'SMTPCrypto'    => setting('MultiEmail.' . $defaultGroup)['SMTPCrypto'],
            'wordWrap'      => setting('MultiEmail.' . $defaultGroup)['wordWrap'],
            'wrapChars'     => setting('MultiEmail.' . $defaultGroup)['wrapChars'],
            'mailType'      => setting('MultiEmail.' . $defaultGroup)['mailType'],
            'charset'       => setting('MultiEmail.' . $defaultGroup)['charset'],
            'validate'      => setting('MultiEmail.' . $defaultGroup)['validate'],
            'priority'      => setting('MultiEmail.' . $defaultGroup)['priority'],
            'CRLF'          => setting('MultiEmail.' . $defaultGroup)['CRLF'],
            'newline'       => setting('MultiEmail.' . $defaultGroup)['newline'],
            'BCCBatchMode'  => setting('MultiEmail.' . $defaultGroup)['BCCBatchMode'],
            'BCCBatchSize'  => setting('MultiEmail.' . $defaultGroup)['BCCBatchSize'],
            'DSN'           => setting('MultiEmail.' . $defaultGroup)['DSN'],
        ];

        if ($overrides !== []) {
            $config = array_merge($config, $overrides);
        }

        /** @var Email $email */
        $email = service('email');

        return $email->initialize($config);
    }
}

Usage

helper('multi_email');

$email = multi_email(['mailType' => 'html']);
$email->setTo('example@gmail.com');
$email->setSubject("Test Send");
$email->setMessage('Hi, .. ');

if ($email->send(false) === false) {
       throw new Exception('Cannot send emai:' . $email->printDebugger(['headers']));
}

// Clear the email
$email->clear();

You can use a different vendor/driver by providing the group name in the second parameter.

helper('multi_email');

$email = multi_email(['mailType' => 'html'], 'outlook');
$email->setTo('example@gmail.com');
$email->setSubject("Test Send");
$email->setMessage('Hi, .. ');

if ($email->send(false) === false) {
       throw new Exception('Cannot send emai:' . $email->printDebugger(['headers']));
}

// Clear the email
$email->clear();

That's it.

[warcooft]

Alternatively, you can install it directly from this package. https://github.com/warcooft/codeigniter4-multi-smtp-config