bf-dsf/aws-wrappers

AWS SDK 包装器

v2.14.5 2023-01-23 07:56 UTC

README

bf-dsf/aws-wrappers 组件提供了一系列面向对象的包装器,用于 Amazon 官方的 aws/aws-php-sdk

特性

  • 仅对少量广泛使用的 AWS 服务进行了包装。
  • 使用包装类的一个目的是为了避免在 AWS SDK 中记住太多的字符串常量。
  • 包装类通过牺牲原始 SDK 的许多高级特性,提供简单清晰的接口。
  • 包装类是可扩展的,如果可以帮助扩展包装器的功能,将会很受欢迎。

安装

bf-dsf/aws-wrappers 是一个开源组件,可在 packagist.org 上找到。要在项目中引入此包,请在项目目录中尝试以下操作

composer require bf-dsf/aws-wrappers

先决条件

凭证

因为 bf-dsf/aws-wrappers 是基于 aws/aws-php-sdk 的包装器,它依赖于官方 SDK 来验证客户端凭证。请参阅官方文档,了解如何将凭证指定给 SDK

最常用的凭证供应方法是使用 配置文件。您需要按照以下说明设置正确的 AWS 配置文件

请准备您的 ~/.aws/credentials 文件,权限为 600,内容如下

[tester]
aws_access_key_id = <YOUR AWS ACCESS KEY>
aws_secret_access_key = <YOUR AWS SECRET>

之后,您可以在构造包装客户端对象时指定配置文件名称,例如 "profile" => "tester"

注意:您还可以使用 "credentials" 参数使用其他认证/授权方法

注意:如果您的项目运行在 EC2 服务器上,并使用 EC2 服务器的 IAM 角色作为认证方法,您可以使用 "iamrole" => true 而不是指定 "profile""credentials"

策略权限

在使用 AWS SDK 时,最容易被忽视的一点是策略权限。您需要访问 AWS IAM 控制台,将正确的策略附加到配置文件中使用的 IAM 账户。有关如何使用策略生成器设置正确策略的详细讨论,请参阅此处

服务包装器