README

Laravel 包，用于通过此封装器处理 Mailjet API v3：https://github.com/mailjet/mailjet-apiv3-php

它还提供了Laravel 邮件功能的 mailjetTransport

安装

首先，在依赖中包含此包

composer require mailjet/laravel-mailjet

然后，您需要在配置文件中添加一些信息。您可以在此处找到您的 Mailjet API 密钥/密钥。请设置您的邮件发件人地址和姓名。

• 在 providers 数组中

'providers' => [
    ...
    Mailjet\LaravelMailjet\MailjetServiceProvider::class,
    ...
]

Laravel 11.0+

在文件 example-app/bootstrap/providers.php 中

use Mailjet\LaravelMailjet\MailjetServiceProvider;

return [
    App\Providers\AppServiceProvider::class,
    MailjetServiceProvider::class,
];

• 在 aliases 数组中

'aliases' => [
    ...
    'Mailjet' => Mailjet\LaravelMailjet\Facades\Mailjet::class,
    ...
]

• 在 services.php 文件中

'mailjet' => [
    'key' => env('MAILJET_APIKEY'),
    'secret' => env('MAILJET_APISECRET'),
]

• 在您的 .env 文件中

MAILJET_APIKEY=YOUR_APIKEY
MAILJET_APISECRET=YOUR_APISECRET
MAIL_FROM_ADDRESS=YOUR_EMAIL_FROM_ADDRESS
MAIL_FROM_NAME=YOU_FROM_NAME

完整配置

有关详细信息，请参阅配置文档。

邮件驱动配置

为了使用 Mailjet 作为您的邮件驱动，您需要更新您的 config/mail.php 或 .env 文件中的邮件驱动到 MAIL_MAILER=mailjet（对于 Laravel 6 及更早版本，请使用 MAIL_DRIVER 常量），并确保您正在使用在您的 Mailjet 账户上配置的有效且授权的发件人电子邮件地址。发送的电子邮件地址和域可以在此处管理

对于 Laravel 7+，您还需要在 config/mail.php 中指定新的可用邮件驱动

'mailers' => [
    ...

    'mailjet' => [
        'transport' => 'mailjet',
    ],
],

有关用法，请参阅Laravel 邮件文档

用法

为了使用此包，您首先需要将 Mailjet Facade 导入到您的代码中

use Mailjet\LaravelMailjet\Facades\Mailjet;

然后，在您的代码中，您可以使用 MailjetServices 中可用的一种方法。

低级 API 方法

• Mailjet::get($resource, $args, $options)
• Mailjet::post($resource, $args, $options)
• Mailjet::put($resource, $args, $options)
• Mailjet::delete($resource, $args, $options)

高级 API 方法

• Mailjet::getAllLists($filters)
• Mailjet::createList($body)
• Mailjet::getListRecipients($filters)
• Mailjet::getSingleContact($id)
• Mailjet::createContact($body)
• Mailjet::createListRecipient($body)
• Mailjet::editListrecipient($id, $body)

有关您可以在每个方法中使用的过滤器信息，请参阅Mailjet API 文档

所有方法返回 Mailjet\Response 或在 API 错误的情况下抛出 MailjetException

您还可以使用 getClient() 方法获取 Mailjet API 客户端，并向 Mailjet API 发送自定义请求。

如果您需要删除联系人，则需要注册 ContactsServiceProvider

• 在 providers 数组中

'providers' => [
    ...
    \Mailjet\LaravelMailjet\Providers\ContactsServiceProvider::class,
    ...
]

并使用它

public function handle(ContactsV4Service $contactsV4Service)
{
    $response = $contactsV4Service->delete(351406781);
    ...
}