README

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

跳转到

入门
快速示例
获取帮助
特性
贡献
更多资源
相关AWS项目

入门

注册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";
}

获取帮助

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

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

此SDK实现了AWS服务API。有关AWS服务及其限制的一般问题，您还可以查看亚马逊网络服务讨论论坛。

SDK主要版本的维护和支持

有关SDK主要版本及其底层依赖的维护和支持信息，请参阅AWS SDKs和工具共享配置和凭证参考指南中的以下内容。

开放问题

如果您遇到aws-sdk-php的bug，我们希望听到您的反馈。在打开新问题之前，请搜索现有问题，并确保您的问题尚未存在。如果您能包括aws-sdk-php的版本、PHP版本和您正在使用的操作系统，那将非常有帮助。在适当的情况下，请包括堆栈跟踪和简单的工作流程以重现案例。

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

特性

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

贡献

我们努力为我们AWS服务提供高质量和有用的SDK，并高度重视社区反馈和贡献。在提交任何问题或拉取请求之前，请先查看我们的贡献指南，以确保我们拥有处理您的bug报告或贡献所需的所有必要信息。

资源

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

darkmatus / aws-sdk-php

维护者

详细信息