View a markdown version of this page

安装 AWS SDK for PHP 版本 3 - AWS SDK for PHP

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

安装 AWS SDK for PHP 版本 3

你可以安装 AWS SDK for PHP 版本 3:

  • 作为依赖项(通过 Composer)

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

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

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

注意

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

通过 Composer AWS SDK for PHP 作为依赖项安装

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

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

安装 Composer

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

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

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

通过 Composer 添加 AWS SDK for PHP 为依赖项

如果您的系统上已经全局安装了 Composer,请在项目的基目录中运行以下命令以 AWS SDK for PHP 作为依赖项进行安装:

$ composer require aws/aws-sdk-php

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

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

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

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

要在脚本 AWS SDK for PHP 中使用,请在脚本中加入自动加载器,如下所示。

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

使用打包的 Phar 进行安装

的每个版本都 AWS SDK for PHP 包含一个预打包的 phar(PHP 存档),其中包含运行 SDK 所需的所有类和依赖项。此外,phar 会自动为 AWS 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 文件进行安装

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

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

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