README

不建议在生产环境中使用此分支 - 此分支用于测试在PHP 8 (Laravel 8.x)上的aws sdk

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后端的cURL（例如，NSS或OpenSSL）。
安装SDK – 使用Composer是安装AWS SDK for PHP的推荐方法。SDK可以通过Packagist在aws/aws-sdk-php包中找到。如果Composer已在您的系统上全局安装，您可以在项目的根目录中运行以下命令来添加SDK作为依赖项
```
composer require aws/aws-sdk-php
```
有关通过Composer和其他方式安装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服务及其限制的一般问题，您还可以查看Amazon Web Services 讨论论坛。

SDK主要版本的维护和支持

有关SDK主要版本及其底层依赖项的维护和支持信息，请参阅AWS SDKs and Tools Shared Configuration and Credentials Reference Guide中的以下内容。

提交工单

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

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

功能

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

贡献

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

资源

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

rene-roscher / aws-sdk-php

维护者

详细信息