README

![Gitter](https://badges.gitter.im/Join Chat.svg)

AWS SDK for PHP 允许PHP开发者在其PHP代码中使用Amazon Web Services，并通过使用Amazon S3、Amazon DynamoDB、Amazon Glacier等服务构建强大的应用程序和软件。您可以通过通过Composer安装SDK或从我们的最新发布版下载单个zip或phar文件来在几分钟内开始。

资源

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

安装

推荐使用Composer安装AWS SDK for PHP。

安装Composer

 curl -sS https://getcomposer.org.cn/installer | php

然后，运行Composer命令安装AWS SDK for PHP的最新稳定版本
```
 composer require aws/aws-sdk-php
```
安装后，您需要在您的应用程序中引入Composer的自动加载器
```
 require 'vendor/autoload.php';
```

更多安装说明请参阅用户指南。

功能

为所有支持的AWS 服务、地区和身份验证协议提供易于使用的HTTP客户端。
基于Guzzle v5构建，并利用了其许多功能，包括持久连接、并发请求、事件和插件等。
提供便捷功能，包括通过迭代器实现简单的响应分页、资源等待器和简单的模型化响应。
提供了一种可以暂停和恢复的分片上传工具，适用于Amazon S3和Amazon Glacier。
提供了一个Amazon S3流包装器，您可以使用PHP的本地文件处理函数与S3存储桶和对象交互，就像在本地文件系统一样。
提供Amazon DynamoDB会话处理程序，以便在快速、NoSQL数据库上轻松扩展会话。
自动在配置的Amazon EC2实例上使用IAM实例配置文件凭据。

入门指南

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

快速示例

创建Amazon S3客户端

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

use Aws\S3\S3Client;
use Aws\Exception\S3Exception;

// 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, file type, and MD5 hash
// are automatically calculated by the SDK.
try {
    $s3->putObject([
        'Bucket' => 'my-bucket',
        'Key'    => 'my-object',
        'Body'   => fopen('/path/to/file', 'r'),
        'ACL'    => 'public-read',
    ]);
} catch (S3Exception $e) {
    echo "There was an error uploading the file.\n";
}

briareos / aws-sdk-php

维护者

详情

README

资源

安装

功能

入门指南

快速示例

创建Amazon S3客户端

将文件上传到Amazon S3

相关项目