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

获取帮助

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

在 StackOverflow 上提问，并使用标签 aws-php-sdk
加入AWS SDK for PHP gitter
通过 AWS支持提交支持工单
如果发现可能存在错误，请提交问题

提交问题

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

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

功能

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

入门

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

luoyy / aws-sdk-php

维护者

详情