README


AWS SDK for PHP使开发者能够轻松地在PHP代码中访问Amazon Web Services，并使用Amazon S3、Amazon DynamoDB、Amazon Glacier等服务等构建健壮的应用程序和软件。您可以通过使用Composer安装SDK或从我们的最新版本下载单个zip或phar文件来在几分钟内开始使用。

资源

• 用户指南 – 适用于入门和深入SDK使用信息
• API文档 – 有关操作、参数和响应的详细信息
• 博客 – 技巧、文章和公告
• 示例项目 - 一个快速示例项目，帮助您入门
• 论坛 – 提出问题、获取帮助和提供反馈
• 问题 – 报告问题、提交拉取请求并参与（请参阅Apache 2.0许可证）
• @awsforphp – 关注我们的Twitter
• SDK的第二个版本
  • 用户指南
  • API文档

功能

• 为所有支持的AWS[服务][docs-services]、[区域][docs-regions]和身份验证协议提供易于使用的HTTP客户端。
• 基于Guzzle构建，并利用其许多功能，包括持久连接、异步请求、中间件等。
• 提供便利功能，包括通过分页器轻松进行结果分页、等待器和简单的结果对象。
• 提供用于Amazon S3和Amazon Glacier的分片上传工具，支持暂停和恢复。
• 提供Amazon S3流包装器，使您可以使用PHP的本地文件处理函数像本地文件系统一样与S3存储桶和对象交互。
• 提供Amazon DynamoDB会话处理器，便于在快速、NoSQL数据库上扩展会话。
• 在配置的Amazon EC2实例上自动使用IAM实例配置文件凭证。

入门指南

1. 注册AWS – 在开始之前，您需要注册AWS账户并获取您的AWS凭证。
2. 最低要求 – 运行SDK，您的系统需要满足最低要求，包括安装编译了cURL扩展和cURL 7.16.2+编译带有TLS后端（例如，NSS或OpenSSL）的PHP >= 5.5。
3. 安装SDK – 使用Composer是安装PHP AWS SDK的推荐方式。SDK可通过Packagist在aws/aws-sdk-php软件包下获取。有关通过Composer和其他方式安装SDK的更详细信息，请参阅用户指南中的安装部分。
4. 使用SDK – 熟悉如何使用SDK的最佳方式是阅读用户指南。入门指南将帮助您熟悉基本概念。

快速示例

创建Amazon S3客户端

<?php
// Require the Composer autoloader.
require 'vendor/autoload.php';

use Aws\S3\S3Client;

// Instantiate an Amazon S3 client.
$s3 = new S3Client([
    'version' => 'latest',
    'region'  => 'us-west-2'
]);

将文件上传到Amazon S3

<?php
// Upload a publicly accessible file. The file size and type are determined by the SDK.
try {
    $s3->putObject([
        'Bucket' => 'my-bucket',
        'Key'    => 'my-object',
        'Body'   => fopen('/path/to/file', 'r'),
        'ACL'    => 'public-read',
    ]);
} catch (Aws\Exception\S3Exception $e) {
    echo "There was an error uploading the file.\n";
}

相关项目

• Laravel的AWS服务提供商
• AWS SDK ZF2模块
• Silex的AWS服务提供商
• Symfony的AWS SDK包
• Guzzle版本6 – PHP HTTP客户端和框架
• 其他AWS SDK和工具（例如，js、cli、ruby、python、java等）