Amazon Simple Storage Service
开发人员指南 (API Version 2006-03-01)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

使用适用于 PHP 的 AWS 开发工具包和运行 PHP 示例

适用于 PHP 的 AWS 开发工具包提供对用于 Amazon S3 存储桶和对象操作的 API 的访问。该开发工具包为您提供了使用服务的低级别 API 或使用高级别抽象的选项。

您可以在适用于 PHP 的 AWS 开发工具包中找到该开发工具包,其中还包括该开发工具包的安装和入门相关说明。

注意

适用于 PHP 的 AWS 开发工具包使用的相关设置取决于您的环境以及您要如何运行自己的应用程序。要设置您的环境以运行本文档中的示例,请参阅 适用于 PHP 的 AWS 开发工具包 Getting Started Guide

适用于 PHP 的 AWS 开发工具包级别

低级别 API。

低级别 API 对应于底层 Amazon S3 REST 操作,包括对存储桶和对象执行的创建、更新和删除操作。低级别 API 提供了对这些操作的更多控制。例如,可以批处理您的请求及并行执行它们,或者当使用分段上传 API 时 (请参阅使用分段上传 API 上传对象),可以分别管理对象段。请注意,这些低级别 API 调用将返回包括所有 Amazon S3 响应详细信息的结果。

高级别抽象

高级别抽象旨在简化常用情况。例如,要使用低级别 API 上传大型对象,您必须先调用 Aws\S3\S3Client::createMultipartUpload(),然后调用 Aws\S3\S3Client::uploadPart() 方法以上传各个对象段,再调用 Aws\S3\S3Client::completeMultipartUpload() 方法以完成上传。而使用高级别 Aws\S3\Model\MultipartUpload\UploadBuilder 对象可简化分段上传的创建。

使用高级别抽象的另一个示例是在枚举存储桶中的对象时,可以使用适用于 PHP 的 AWS 开发工具包的迭代器功能返回所有对象键 (无论存储桶中存储了多少对象)。如果您使用低级别 API,该响应将仅返回最多 1000 个键的响应,且如果您在存储桶中具有超过 1000 个对象,则结果将被截断,您需要管理响应并检查任何截断。

运行 PHP 示例

以下过程介绍如何运行本指南中的 PHP 代码示例。

运行 PHP 代码示例

1

下载并安装适用于 PHP 的 AWS 开发工具包,然后验证环境是否满足最低要求,如 适用于 PHP 的 AWS 开发工具包 Getting Started Guide 所述。

2

根据 适用于 PHP 的 AWS 开发工具包 Getting Started Guide 中的说明安装适用于 PHP 的 AWS 开发工具包。您可能需要修改代码,以处理 PHP 扩展程序之间的依存关系 (是否需要修改代码取决于您使用的安装方法)。

本文档中的所有 PHP 代码示例都使用 Composer 依存关系管理器 (有关详情,请参阅 适用于 PHP 的 AWS 开发工具包 Getting Started Guide)。每个代码示例都包括下面这行代码来包含其依存关系:

Copy
require 'vendor/autoload.php';

3

为 AWS 凭证创建凭证配置,如适用于 PHP 的 AWS 开发工具包主题使用 AWS 凭证文件和凭证配置所述。在运行时,当创建新 Amazon S3 客户端对象时,该客户端将从凭证配置获取 AWS 凭证。

4

将文档中的示例代码复制到您的项目。您可能需要向代码示例中添加几行代码来参考配置和开发工具包文件 (是否需要添加代码取决于您的环境)。

例如,要在浏览器中加载某个 PHP 示例,需要在 PHP 代码顶部添加以下内容,然后将其保存为 Web 应用程序目录 (例如 wwwhtdocs) 中的 PHP 文件 (扩展程序 .php) :

Copy
<?php header('Content-Type: text/plain; charset=utf-8'); // Include the AWS SDK using the Composer autoloader require 'vendor/autoload.php';

5

根据您的设置测试示例。

相关资源