README

PHP AWS SDK 使开发人员能够轻松地在他们的 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 Support 提交支持票据
如果您发现可能存在错误，请打开问题

打开问题

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

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

功能

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

入门指南

注册 AWS – 在开始之前，您需要注册 AWS 账户并获取您的 AWS 凭据。
最低要求 – 要运行 SDK，您的系统需要满足最低要求，包括拥有 PHP >= 5.5。我们强烈建议使用编译了 cURL 扩展和 cURL 7.16.2+ 以及编译了 TLS 后端（例如，NSS 或 OpenSSL）的 PHP。
安装 SDK – 使用 Composer 是安装 AWS SDK for PHP 的推荐方式。SDK 通过 Packagist 下的 aws/aws-sdk-php 包提供。如果 Composer 已在全球范围内安装到您的系统上，您可以在项目的根目录中运行以下命令来将 SDK 添加为依赖项
```
composer require 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";
}

hezachary / aws-sdk-php

维护者

详细信息