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

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

安装 Amazon SDK for PHP 版本 3

您可以安装Amazon SDK for PHP版本 3:

  • 作为依赖项(通过 Composer)

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

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

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

注意

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

安装Amazon SDK for PHP作为依赖项(通过 Composer)

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

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

安装 Composer

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

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

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

添加Amazon SDK for PHP作为依赖项(通过 Composer)

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

$ composer require aws/aws-sdk-php

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

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

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

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

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

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

使用打包的 Phar 进行安装

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

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

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

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

suhosin.executor.include.whitelist = phar

使用 ZIP 文件进行安装

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

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

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