README

AWS SDK for PHP - 版本 3

AWS SDK for PHP 使得开发者能够轻松地将Amazon Web Services集成到PHP代码中，并使用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支持打开支持票据
如果您发现了一个错误，请打开一个问题

打开问题

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

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

功能

为所有支持的 AWS [服务][docs-services]、地区和身份验证协议提供易于使用的 HTTP 客户端。
基于 Guzzle 构建，并利用了许多其功能，包括持久连接、异步请求、中间件等。
提供便利功能，包括通过分页器、等待器和简单的结果对象实现轻松的结果分页。
为 Amazon S3 和 Amazon Glacier 提供 multipart 上传工具，可以暂停和恢复上传。
提供 Amazon S3 Stream Wrapper，使您可以使用 PHP 的本地文件处理函数像本地文件系统一样与您的 S3 存储桶和对象交互。
提供 Amazon DynamoDB Session Handler，以便在快速、NoSQL 数据库上轻松扩展会话。
在配置的 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 Aws3\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 (Aws3\S3\Exception\S3Exception $e) {
    echo "There was an error uploading the file.\n";
}

sampohaavisto / aws-sdk-php-forked-v3

维护者

详细信息