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

# 安装 适用于 PHP 的 AWS SDK 版本 3
<a name="getting-started_installation"></a>

你可以安装 适用于 PHP 的 AWS SDK 版本 3：
+ 作为依赖项（通过 Composer）
+ 作为开发工具包的自带 phar
+ 作为开发工具包的 ZIP 文件

在安装 适用于 PHP 的 AWS SDK 版本 3 之前，请确保您的环境使用的是 PHP 版本 8.1 或更高版本。了解有关[环境要求和建议](getting-started_requirements.md)的更多信息。

**注意**  
通过 .phar 和 .zip 方法安装 SDK，需要单独安装和启用[多字节字符串 PHP 扩展](https://www.php.net/manual/en/book.mbstring.php)。

## 通过 Composer 适用于 PHP 的 AWS SDK 作为依赖项安装
<a name="install-sdk-php-as-a-dependency-via-composer"></a>

 Composer 是安装 适用于 PHP 的 AWS SDK的推荐方式。Composer 是一款 PHP 工具，用于管理和安装项目的依赖项。

有关如何安装 Composer、配置自动加载并遵循定义依赖关系的其他最佳实践的更多信息，请参阅 [getcomposer.org](http://getcomposer.org)。

### 安装 Composer
<a name="install-composer"></a>

如果 Composer 未在您的项目中，请从 [Download Composer 页面](http://getcomposer.org/download)下载并安装 Composer。
+ 对于 **Windows**，请按照 Windows 安装程序说明进行操作。
+ 对于 **Linux**，请按照命令行安装说明进行操作。

### 通过 Composer 添加 适用于 PHP 的 AWS SDK 为依赖项
<a name="add-sdk-php-as-a-dependency-via-composer"></a>

如果您的系统上[已经全局安装了 Composer](https://getcomposer.org/doc/00-intro.md#globally)，请在项目的基目录中运行以下命令以 适用于 PHP 的 AWS SDK 作为依赖项进行安装：

```
$ composer require aws/aws-sdk-php
```

否则，请键入此 Composer 命令以安装最新版本的 适用于 PHP 的 AWS SDK 作为依赖项。

```
$ php -d memory_limit=-1 composer.phar require aws/aws-sdk-php
```

### 将自动加载工具添加到 php 脚本
<a name="add-autoloader-to-your-php-scripts"></a>

Installing Composer 在环境中创建多个文件夹和文件。您将使用的主要文件为 `autoload.php`，位于环境中的 `vendor` 文件夹中。

要在脚本 适用于 PHP 的 AWS SDK 中使用，请在脚本中加入自动加载器，如下所示。

```
<?php
   require '/path/to/vendor/autoload.php';
?>
```

## 使用打包的 Phar 进行安装
<a name="installing-by-using-the-packaged-phar"></a>

的每个版本都 适用于 PHP 的 AWS SDK 包含一个预打包的 phar（PHP 存档），其中包含运行 SDK 所需的所有类和依赖项。此外，phar 会自动为 适用于 PHP 的 AWS SDK 及其所有依赖项注册一个类自动加载器。

您可以[下载打包的 phar](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.phar) 并把它包含到您的脚本中。

```
<?php
   require '/path/to/aws.phar';
?>
```

**注意**  
不建议使用带有 Suhosin 补丁的 PHP，但这对于 Ubuntu 和 Debian 分发版是很常见的。在这种情况下，您可能需要在 suhosin.ini 中启用 phar。否则，在您的代码中包含 phar 文件将导致无错误提示的故障。要修改 suhosin.ini，请添加以下行。  

```
suhosin.executor.include.whitelist = phar
```

## 使用 ZIP 文件进行安装
<a name="installing-by-using-the-zip-file"></a>

 适用于 PHP 的 AWS SDK 包括一个 ZIP 文件，其中包含运行 SDK 所需的所有类和依赖关系。此外，这个 ZIP 文件还包含适用于 适用于 PHP 的 AWS SDK 及其依赖项的类自动加载工具。

要安装开发工具包，请[下载 .zip 文件](https://docs.aws.amazon.com/aws-sdk-php/v3/download/aws.zip)，然后在项目中的选定位置进行解压缩。然后将自动加载工具包含到您的脚本中，如下所示。

```
<?php
   require '/path/to/aws-autoloader.php';
?>
```