README


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

资源

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

功能

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

入门指南

1. 注册AWS账户 – 在开始之前，您需要注册一个AWS账户并获取您的AWS凭证。
2. 最低要求 – 要运行SDK，您的系统需要满足最低要求，包括有PHP >= 5.5，并使用cURL扩展编译，以及cURL 7.16.2+使用TLS后端编译（例如，NSS或OpenSSL）。
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";
}

相关AWS项目

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