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 >= 7.2.5。我们强烈建议使用编译了cURL扩展和cURL 7.16.2+（例如，使用NSS或OpenSSL）TLS后端的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的方式是阅读用户指南。《入门指南》将帮助您了解基本概念。
Beta: 移除未使用的服务 — 到目前为止，该SDK支持超过300个AWS服务。您可能不需要所有这些服务。如果您使用Composer并且想了解更多关于此功能的信息，请阅读相关文档。

快速示例

创建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 服务及其限制的一般问题，您还可以查看 Amazon Web Services 讨论论坛。

SDK 主版本的维护和支持

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

打开问题

如果您在使用 aws-sdk-php 时遇到错误，我们希望了解。搜索现有的问题，并在提交新问题时确保您的问题尚未存在。如果适当，请包括 aws-sdk-php 的版本、PHP 版本和您正在使用的操作系统。如果合适，请包括堆栈跟踪和简单的流程来重现问题。

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

功能

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

贡献

我们努力为AWS服务提供高质量且实用的SDK，并高度重视社区反馈和贡献。在提交任何问题或拉取请求之前，请查看我们的贡献指南，以确保我们有足够的信息来有效地响应您的错误报告或贡献。

资源

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

aws / aws-sdk-php

维护者

详细信息