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 Support 打开支持票据
如果您发现可能存在错误，请打开一个问题

打开问题

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

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

功能

为所有支持的AWS 服务、区域和身份验证协议提供易于使用的HTTP客户端。
基于Guzzle构建，并利用了许多其特性，包括持久连接、异步请求、中间件等。
提供便捷特性，包括通过分页器实现轻松的结果分页、等待器以及简单的结果对象。
提供亚马逊S3和亚马逊冰川的分片上传工具，支持暂停和恢复上传。
提供亚马逊S3流包装器，使您可以使用PHP的本地文件处理函数像本地文件系统一样与S3存储桶和对象交互。
提供亚马逊DynamoDB会话处理器，以便在快速、NoSQL数据库上轻松扩展会话。
自动在配置的亚马逊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的最佳方式是阅读用户指南。《入门指南》将帮助您熟悉基本概念。

快速示例

创建亚马逊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'
]);

将文件上传到亚马逊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";
}

jppreusdev / aws-sdk-php

维护者

详细信息