本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在适用于 PHP 的 AWS SDK 版本 3 的代码中配置服务客户端

除了（或作为替代方案）通过外部方式配置服务客户端之外，您还可以在代码中以编程方式对其进行配置。

通过在代码中配置服务客户端，您可以精细地控制许多可用的选项。可以通过外部方式设置的大多数配置也可以在代码中进行设置。

代码中的基本配置

您可以向客户端的构造函数传递选项的关联数组，从而在代码中创建和配置服务客户端。在以下示例中，关联数组仅包含客户端使用的“区域”选项：

require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

//Create an S3Client
$s3 = new S3Client([
    'region' => 'eu-south-2'
]);  

有关可选“版本”参数的信息，请参阅配置选项主题。

请注意，我们并未向客户端显式提供凭证。这是因为 SDK 使用默认凭证提供程序链来查找凭证信息。

在 适用于 PHP 的 AWS SDK 版本 3 的客户端构造函数选项 中详细介绍了所有通用的客户端配置选项。创建的客户端不同，提供的选项数组也不同。每个客户端的 API 文档中介绍了这些自定义客户端配置选项。

使用 Sdk 类

Aws\Sdk 类可作为客户端工厂，用于管理多个客户端的共享配置选项。许多可提供给特定客户端构造函数的选项也可提供给 Aws\Sdk 类。这些选项会应用于每个客户端构造函数。

导入。

require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

示例代码

// The same options that can be provided to a specific client constructor can also be supplied to the Aws\Sdk class.
// Use the us-west-2 region and latest version of each client.
$sharedConfig = [
    'region' => 'us-west-2'
];
// Create an SDK class used to share configuration across clients.
$sdk = new Aws\Sdk($sharedConfig);
// Create an Amazon S3 client using the shared configuration data.
$client = $sdk->createS3();

所有客户端均可共享的选项置于根级别的键值对中。可在与服务命名空间相同的键（例如“S3”、“DynamoDb”等）中以关联数组的形式提供特定于服务的配置数据。

$sdk = new Aws\Sdk([
    'region'   => 'us-west-2',
    'DynamoDb' => [
        'region' => 'eu-central-1'
    ]
]);

// Creating an Amazon DynamoDb client will use the "eu-central-1" AWS Region.
$client = $sdk->createDynamoDb();

特定于服务的配置值结合了特定于服务的值和根级值（即特定于服务的值浅合并到根级值）。