README

注意

这个包与原始包相同，唯一不同的是命名空间。如果您正在开发系统，它使用旧的psr7版本或导致冲突，或者您无法在核心应用程序中升级包版本，则可以使用此包。此包版本为3.255.4。

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扩展和编译了TLS后端（例如，NSS或OpenSSL）的cURL 7.16.2+进行编译。
安装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 HeAws\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 (HeAws\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 提交支持工单
如果您发现可能是 bug，请提交问题

此 SDK 实现了 AWS 服务 API。关于 AWS 服务及其限制的通用问题，您还可以查看 Amazon Web Services 讨论论坛。

SDK 主版本的维护和支持

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

打开问题

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

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

功能

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

贡献

我们努力为AWS服务提供高质量和实用的SDK，我们非常重视来自社区的建议和贡献。在提交任何问题或拉取请求之前，请先审查我们的贡献指南，以确保我们拥有所有必要的详细信息，以便有效响应您的错误报告或贡献。

资源

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

hashhesh / aws-sdk-php

维护者

详细信息