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的版本2
  • 用户指南
  • API文档

特性

• 为所有支持的AWS [服务][docs-services]、[区域][docs-regions] 和身份验证协议提供易于使用的HTTP客户端。
• 基于 Guzzle 构建，并利用了许多其特性，包括持久连接、异步请求、中间件等。
• 提供便捷功能，包括通过分页器轻松进行结果分页、等待器以及简单的结果对象。
• 提供Amazon S3和Amazon Glacier的分片上传工具，支持暂停和恢复上传。
• 提供Amazon S3 Stream Wrapper，这样您就可以使用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";
}

相关AWS项目

• AWS Service Provider for Laravel
• AWS SDK ZF2模块
• AWS Service Provider for Silex
• AWS SDK Bundle for Symfony
• Amazon SNS Message Validator for PHP - 不需要SDK的SNS验证器
• Guzzle版本6 – PHP HTTP客户端和框架
• 其他AWS SDKs & Tools（例如，js、cli、ruby、python、java等）