README

Laravel 5 为 Mailchimp API 提供具有多个连接的包装器。

// Return the users on the Mailchimp account.
Mailchimp::users()

// Dependency injection example.
$mailchimpManager->users()

安装

使用 Composer 在项目的根目录中安装此包。

composer require bluebaytravel/mailchimp

将服务提供者添加到 config/app.php 中的 providers 数组。

BlueBayTravel\Mailchimp\MailchimpServiceProvider::class

如果您想使用 facade，您可以在 config/app.php 中将引用添加到您的别名数组。

'Mailchimp' => BlueBayTravel\Mailchimp\Facades\Mailchimp::class

配置

Laravel Mailchimp 需要连接配置。要开始，您需要发布所有供应商资产

php artisan vendor:publish

这将在您的应用中创建一个 ./config/mailchimp.php 文件，您可以根据需要修改此文件来设置配置。同时，请确保检查此包中原始配置文件之间的更改。

默认连接名称

此选项 default 是您指定要使用以下哪个连接作为默认连接以用于所有工作的地方。当然，您可以使用多个连接同时使用管理器类。此设置的默认值为 main。

Mailchimp 连接

此选项 connections 是为您的应用程序设置每个连接的地方。已包含示例配置，但您可以根据需要添加尽可能多的连接。

用法

Mailchimp

Mailchimp 类是围绕 mailchimp\mailchimp 包的包装器。

MailchimpManager

这是最感兴趣的类。它绑定到 ioc 容器为 mailchimp，并可以使用 Facades\Mailchimp facade 访问。此类通过扩展 AbstractManager 实现 ManagerInterface。接口和抽象类都是 Graham Campbell 的 Graham Campbell 的 Laravel Manager 包的一部分，因此您可能想要查看该存储库中的文档，了解如何使用管理器类。请注意，返回的连接类始终是 BlueBayTravel\Mailchimp\Mailchimp 的实例。

Facades\Mailchimp

此 facade 将动态将静态方法调用传递到 ioc 容器中的 mailchimp 对象，默认情况下是 MailchimpManager 类。

MailchimpServiceProvider

此类不包含任何感兴趣的公共方法。应将此类添加到 config/app.php 中的提供者数组。此类将设置 ioc 绑定。

示例

在这里，您可以看到这个包的使用是多么简单。默认情况下，适配器是 main。在配置文件中输入您的认证详情后，它将自动工作

// You can alias this in config/app.php.
use BlueBayTravel\Mailchimp\Facades\Mailchimp;

Mailchimp::users();

Mailchimp 管理器将表现得就像一个 BlueBayTravel\Mailchimp\Mailchimp。如果您想调用特定的连接，可以使用连接方法来实现

use BlueBayTravel\Mailchimp\Facades\Mailchimp;

// Writing this…
Mailchimp::connection('main')->users();

// ...is identical to writing this
Mailchimp::users();

// and is also identical to writing this.
Mailchimp::connection()->users();

// This is because the main connection is configured to be the default.
Mailchimp::getDefaultConnection(); // This will return main.

// We can change the default connection.
Mailchimp::setDefaultConnection('alternative'); // The default is now alternative.

如果您像我一样更喜欢使用依赖注入而不是外观（facade），那么您可以注入管理器

use BlueBayTravel\Mailchimp\MailchimpManager;

class Foo
{
    protected $mailchimp;

    public function __construct(MailchimpManager $mailchimp)
    {
        $this->mailchimp = $mailchimp;
    }

    public function bar($id)
    {
        $this->mailchimp->users();
    }
}

App::make('Foo')->bar();

许可证

Laravel Mailchimp 采用了 MIT 许可证 (MIT)。