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文档

获取帮助

请使用这些社区资源来获取帮助。我们使用GitHub问题跟踪错误和功能请求，并且有限的能力来处理它们。

在StackOverflow上提问，并用aws-php-sdk标记
加入AWS SDK for PHP的gitter
通过AWS Support提交支持票证
如果您发现可能存在错误，请打开问题

打开问题

如果您在使用aws-sdk-php时遇到错误，我们希望了解它。搜索现有问题，并确保在打开新问题之前问题尚未存在。如果您包括aws-sdk-php版本、PHP版本和您使用的操作系统，这将很有帮助。在适当的情况下，请包括堆栈跟踪和简化的重现案例。

GitHub问题用于提交错误报告和功能请求。有关使用aws-sdk-php的帮助和问题，请参考“获取帮助”部分列出的资源。处理问题的资源有限，通过保持待解决问题列表精简，我们可以及时响应。

功能

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

入门

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

// 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\S3\Exception\S3Exception $e) {
    echo "There was an error uploading the file.\n";
}

aannnaa7 / aws-sdk-php-minimized

维护者

详情