安装

运行环境

各个版本说明

安装总结

对于绝大多数用户而言，您只需要记住以下两个原则即可：

hyperf/laravel 用户

composer require yansongda/artful:~1.1.0 -vvv
composer require guzzlehttp/guzzle:^7.0 # 默认情况下，相关框架已自带，无需额外安装

其它框架/无框架 用户

composer require yansongda/artful:~1.1.0 -vvv
composer require guzzlehttp/guzzle:^7.0
composer require hyperf/pimple:~2.2.0  # 或者 composer require illuminate/container

详细安装介绍

composer require yansongda/artful:~1.1.0 -vvv

由于 yansongda/artful 支持 PSR2、PSR3、PSR4、PSR7、PSR11、PSR14、PSR18 等各项标准，因此这里额外介绍下 PSR-11、PSR-18 的安装与使用。

关于 Container（PSR-11）

TIP

如果您看不懂这部分内容:

1、hyperf/laravel 用户直接忽略此部分内容；

2、其它用户（包括 thinkphp 用户）在安装完 Pay 后直接无脑 composer require hyperf/pimple:~2.2.0 即可

hyperf/laravel 用户

Artful 会自动复用框架内的 Container, 无需您任何额外操作。

其它框架/无框架 用户

如果您不想操心那么多，SDK 自带了一套开箱即用的 Container，但仍然需要手动安装 container:

composer require hyperf/pimple:~2.2.0

如果您所使用的框架内有符合 PSR-11 的 Container，您需要在初始化 之前（即，调用 Artful::config() 方法之前）执行以下代码即可复用现有的 Container:

use Yansongda\Artful\Artful;
use Yansongda\Artful\Contract\HttpClientInterface;

// $container = 您现有的 container

// 方法一：
Artful::setContainer($container);
Artful::config($config);

// 方法二：
Artful::config($config, function () use ($container) {
    return $container;
});

关于 Guzzlehttp (PSR-18)

TIP

如果您看不懂这部分内容:

在安装完 Artful 后直接无脑 composer require guzzlehttp/guzzle:^7.0 即可

使用默认的 Client

SDK 自带了一套开箱即用的 HTTP 客户端，但仍然需要手动安装 Guzzlehttp:

composer require guzzlehttp/guzzle:^7.0

现有框架有 PSR-18 的 Client

如果您所使用的框架内有符合 PSR-18 的 HTTP Client，您需要在初始化 之后（即，调用 Artful::config() 方法后）执行以下代码即可复用现有的 Client:

use Yansongda\Artful\Artful;
use Yansongda\Artful\Contract\HttpClientInterface;

// $client = 您现有的 http client

Artful::config($config);
Artful::set(HttpClientInterface::class, $client);