安装适用于 PHP 的 Amazon SDK 版本 3 - 适用于 PHP 的 Amazon SDK
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

安装适用于 PHP 的 Amazon SDK 版本 3

您可以安装适用于 PHP 的 Amazon SDK 版本 3:

  • 作为依赖项(通过 Composer)

  • 作为开发工具包的自带 phar

  • 作为开发工具包的 ZIP 文件

在安装适用于 PHP 的 Amazon SDK版本 3 之前,请确保您的环境使用的是 PHP 版本 8.1 或更高版本。了解有关环境要求和建议的更多信息。

注意

通过 .phar 和 .zip 方法安装 SDK,需要单独安装和启用多字节字符串 PHP 扩展

安装适用于 PHP 的 Amazon SDK作为依赖项(通过 Composer)

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

有关如何安装 Composer、配置自动加载并遵循定义依赖关系的其他最佳实践的更多信息,请参阅 getcomposer.org

安装 Composer

如果 Composer 未在您的项目中,请从 Download Composer 页面下载并安装 Composer。

  • 对于 Windows,请按照 Windows 安装程序说明进行操作。

  • 对于 Linux,请按照命令行安装说明进行操作。

添加适用于 PHP 的 Amazon SDK作为依赖项(通过 Composer)

如果已在系统上全局安装 Composer,请在项目的基目录中运行以下内容来安装适用于 PHP 的 Amazon SDK作为依赖项:

$ composer require aws/aws-sdk-php

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

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

将自动加载工具添加到 php 脚本

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

要在脚本中使用适用于 PHP 的 Amazon SDK,请在脚本中包含自动加载工具,如下所示。

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

使用打包的 Phar 进行安装

适用于 PHP 的 Amazon SDK 的每个版本都自带 phar(PHP 存档文件),其中包含运行开发工具包所需的所有类和依赖项。此外,phar 会自动为 适用于 PHP 的 Amazon SDK 和它的所有依赖项注册一个类自动加载工具。

您可以下载打包的 phar 并把它包含到您的脚本中。

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

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

suhosin.executor.include.whitelist = phar

使用 ZIP 文件进行安装

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

要安装开发工具包,请下载 .zip 文件,然后在项目中的选定位置进行解压缩。然后将自动加载工具包含到您的脚本中,如下所示。

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