README

此包可以帮助您从Laravel应用程序的多个邮箱账户发送邮件。

此包支持发送排队、本地化和批量邮件。

此包适用于SMTP和log驱动程序。

目录

• 要求
• 安装
• 使用
  • 基本示例
  • 排队邮件
  • 在可邮寄的类中指定
  • 批量消息
• 特殊设置
  • 多个邮件提供商
  • 默认邮件账户
  • 测试
  • 从数据库获取邮件
  • 故障排除
• 对于包开发者

要求

Laravel 5, 6或7

安装

使用composer将包安装到您的Laraval应用程序中

composer require iwasherefirst2/laravel-multimail

发布配置文件

php artisan vendor:publish --provider="IWasHereFirst2\LaravelMultiMail\MultiMailServiceProvider" --tag=config

在config/multimail.php中配置您的邮件客户端

'emails'  => [
    'office@example.net' =>
        [
          'pass'     => env('first_mail_password'),
          'from_name'     => "Max Musterman",
        ],
    'contact@example.net'  =>
        [
          'pass'     => env('second_mail_password')
        ],
],

请确保将凭据放入.env文件中，这样它们就不会在您的存储库中跟踪。

对于每封邮件，您可以指定多个列

使用

可以使用\MultiMail而不是\Mail发送邮件。方法to、cc、bcc、locale与mail facade提供的方法完全相同（注意，locale仅从Laravel 5.6开始可用）。

MultiMail的from方法需要一个在config/multimail.php中提供的电子邮件字符串。您可以传递第二个参数作为发件人名称，而不是使用配置中提供的默认值。当使用send或queue时，邮件将从cofing/multimail.php中指定的邮件账户发送。

基本示例

此示例假设office@example.net和contact@example.net已在config/multimail.php中指定。

// Send mail from office@example.net
\MultiMail::to($user)->from('office@example.com')->send(new \App\Mail\Invitation($user));

// Send from malaccount email@gmail.com
\MultiMail::to($user)->from('email@example.net')->locale('en')->send(new \App\Mail\Invitation($user));

排队邮件

排队邮件与正常Mail facade完全相同，即它们要么由queue方法显式发送，要么可邮寄的类实现了ShouldQueue合约。

// Queue Mail
\MultiMail::from('contact@foo.org')->queue(new \App\Mail\Invitation($user));

当然，有必要安装一个队列驱动程序。

在可邮寄的类中指定

您可以在可邮寄的类中设置to、cc、bcc、locale和from。在这种情况下，您可以将上面的基本示例缩减为

// Send mail from office@example.net
\MultiMail::send(new \App\Mail\Invitation($user));

可邮寄的

/**
 * Create a new message instance.
 *
 * @return void
 */
public function __construct($user)
{
  $this->to  = $user;
  $this->fromMailer = 'office@example.com'
  $this->locale('en');
}

/**
 * Build the message.
 *
 * @return $this
 */
public function build()
{
    return $this->markdown('emails.invitation')
                ->subject('Invitation mail');
}

批量消息

对于批量消息，您可能首先需要邮件对象。您可以在发送一定数量的邮件（$frequency）后定义一个暂停（$timeout）秒数。

$mailer = \MultiMail::getMailer('office@example.com' , $timeout, $frequency);

然后您可以遍历您的列表。

foreach($users as $user){
$mailer->send(new \App\Mail\Invitation($user));
};

特殊设置

多个邮件提供商

如果您希望使用不同的提供者发送邮件，则可以在provider数组中创建另一个提供者，并在emails数组内部引用它

'emails'  => [
    'office@example.net' =>
        [
          'pass'     => env('first_mail_password'),
          'username' => env('first_mail_username'),
          'from_name'     => "Max Musterman",   
                                                    // <------ no provider given because 'default' provider is used
        ],
    'contact@other_domain.net'  =>
        [
          'pass'     => env('second_mail_password'),
          'username' => env('second_mail_username'),
          'from_name'     => "Alice Armania",
          'provider' => 'new_provider',            // <------ specify new provider here
        ],
],

'provider' => [
  'default' =>
    [
      'host'       => env('MAIL_HOST'),
      'port'       => env('MAIL_PORT'),
      'encryption' => env('MAIL_ENCRYPTION'),
      'driver'     => env('MAIL_DRIVER'),
    ],
  'new_provider' =>
    [
      'host'      => env('MAIL_HOST_PROVIDER_B'),
      'port'      => env('MAIL_PORT_PROVIDER_B'),
      'encryption' => env('MAIL_ENCRYPTION_PROVIDER_B'),
  'driver'     => env('MAIL_DRIVER_B'),
  // you may also add options like `stream`, `source_ip` and `local_domain`
    ]'
],

默认邮件账户

您可以从config/multimail.php中的email数组提供default凭据

'emails'  => [
    'office@example.net' =>
        [
          'pass'     => env('first_mail_password'),
          'username' => env('first_mail_username'),
          'from_name'     => "Max Musterman",
        ],
    'contact@example.net'  =>
        [
          'pass'     => env('second_mail_password'),
          'username' => env('second_mail_username'),
          'from_name'     => "Alice Armania",
        ],
    'default' =>
      [
        'pass'            => env('MAIL_PASSWORD'),
        'username'        => env('MAIL_USERNAME'),
      ]
],

当first_mail_password和first_mail_username为空时，office@example.net将使用default指定的凭据。这对于本地开发非常有用，当时您想要在测试时从单个邮件账户发送所有邮件。这样，您只需要在本地指定MAIL_PASSWORD和MAIL_USERNAME。

测试

不要将凭据放入本地env

不要在您的本地.env中指定任何电子邮件账户。否则，您可能会将测试邮件发送到实际用户。

使用一个假邮件账户或日志

使用 log 驱动程序或设置一个假邮件 SMTP 账户，例如 mailtrap 或类似服务。

不需要为所有电子邮件账户指定相同的凭据。相反，只需提供一个默认的邮件账户（见上面的 默认邮件账户）。

在测试中使用日志邮件驱动程序

为了防止延迟，我建议在 phpunit 运行时始终使用 log 邮件驱动程序。您可以在 phpunit.xml 文件中设置邮件驱动程序，如下所示：<env name="MAIL_DRIVER" value="log"/>。

使用模拟

如果您想在测试期间使用模拟功能 Mail fake，请在您的配置文件 config/multimail.php 中启用 use_default_mail_facade_in_tests。请注意，assertQueued 永远不会为真，因为 queued 邮件实际上是通过 sent 通过一个作业发送的。

从数据库获取邮件

如果您想从数据库加载您的邮件账户配置，请发布软件包迁移

php artisan vendor:publish --provider="IWasHereFirst2\LaravelMultiMail\MultiMailServiceProvider" --tag=migrations

在您的迁移文件夹中现在有两个表格，email_accounts 和 email_providers

电子邮件不应该添加到配置中，而应该添加到 email_accounts 表中。

请确保更新您的配置 config/multimail.php

<?php

return [
    
    'mail_settings_class' => \IWasHereFirst2\LaravelMultiMail\DatabaseConfigMailSettings::class,

    //...
];

电子邮件现在将从数据库而不是配置文件中读取。如果 email_accounts 中没有提供提供者（列 provider 可为空），则默认提供者将从 config/multimail.php 中考虑。

如果您想进行自定义设置，请将类 \IWasHereFirst2\LaravelMultiMail\DatabaseConfigMailSettings 复制到您的应用程序中的某个位置，调整命名空间，并在配置文件中更新引用 mail_settings_class。

故障排除

Laravel 7 不工作

请更新到版本 1.2.2 以支持 Laravel 7

对于包开发者

如果您计划为此软件包做出贡献，请确保单元测试以及集成测试都成功。为了测试集成测试，请创建一个免费的 mailtrap 账户，将 tests/.env.example 复制到 tests/.env，并在 tests/.env 中添加您的 mailtrap API 凭据。集成测试现在将向您的 mailtrap 账户发送测试电子邮件，并通过 API 验证邮件是否成功发送。

此软件包附带一个 Dockerfile，以便您可以轻松运行测试。只需按照以下步骤操作

docker-compose up --build 
docker-compose exec app bash 
composer install
./vendor/bin/phpunit