亚马逊网络服务（aws）是一个强大的平台，为开发人员和企业提供广泛的服务。在这些服务中，amazon simple storage service (s3) 是最受欢迎且使用最广泛的服务之一。要以编程方式与 s3 交互，您可以使用适用于 php 的 aws 开发工具包。在本文中，我们将指导您完成使用 s3 配置适用于 php 的 aws 开发工具包的过程。
先决条件
在我们开始之前，请确保您具备以下条件：
- aws 账户
- aws 访问密钥 id 和秘密访问密钥
- php 5.6 或更高版本
- 作曲家已安装
安装
要安装适用于 php 的 aws 开发工具包，您可以使用 composer。在终端中运行以下命令：
composer require aws/aws-sdk-php
此命令将在您的项目中安装最新版本的适用于 php 的 aws 开发工具包。
配置
安装 sdk 后，您需要使用您的 aws 访问密钥 id 和秘密访问密钥对其进行配置。您可以通过创建配置文件或设置环境变量来做到这一点。
立即学习“PHP免费学习笔记（深入）”；
配置文件
在项目中创建一个名为 config.php 的新文件，并添加以下代码：
<?php
require 'vendor/autoload.php';
use aws\sdk;
$sdk = new sdk([
'region' => 'us-east-1',
'version' => 'latest',
'credentials' => [
'key' => 'your_access_key_id',
'secret' => 'your_secret_access_key',
]
]);
$s3client = $sdk->creates3();
将 your_access_key_id 和 your_secret_access_key 替换为您的实际 aws 访问密钥 id 和秘密访问密钥。
环境变量
或者，您可以将 aws access key id 和 secret access key 设置为环境变量：
export aws_access_key_id=your_access_key_id export aws_secret_access_key=your_secret_access_key
然后，创建s3客户端如下：
<?php
require 'vendor/autoload.php';
use aws\sdk;
$sdk = new sdk([
'region' => 'us-east-1',
'version' => 'latest',
]);
$s3client = $sdk->creates3();
准备好了解有关 aws 和 php 的更多信息了吗？查看我们关于 aws 配置 sso 和修复 laravel 权限被拒绝错误的其他文章。
用法
现在您已经使用 s3 配置了适用于 php 的 aws 开发工具包，您可以开始使用它与 s3 存储桶进行交互。以下是如何列出帐户中所有存储桶的示例：
$buckets = $s3client->listbuckets();
foreach ($buckets['buckets'] as $bucket) {
echo $bucket['name'] . php_eol;
}
当然，这里有一些将适用于 php 的 aws 开发工具包与 s3 结合使用的其他示例和最佳实践。
上传文件
要将文件上传到s3存储桶，您可以使用putobject方法。这是一个例子：
$bucketname = 'my-bucket';
$keyname = 'my-file.txt';
$filepath = '/path/to/my-file.txt';
$result = $s3client->putobject([
'bucket' => $bucketname,
'key' => $keyname,
'sourcefile' => $filepath,
]);
echo $result['objecturl'] . php_eol;
此代码会将位于 /path/to/my-file.txt 的文件上传到 my-bucket 存储桶，并打印上传文件的 url。
下载文件
要从 s3 存储桶下载文件，可以使用 getobject 方法。这是一个例子：
$bucketname = 'my-bucket';
$keyname = 'my-file.txt';
$filepath = '/path/to/downloaded-file.txt';
$result = $s3client->getobject([
'bucket' => $bucketname,
'key' => $keyname,
'saveas' => $filepath,
]);
echo $result['contentlength'] . ' bytes downloaded.' . php_eol;
此代码将从 my-bucket 存储桶中下载带有 my-file.txt 密钥的文件，并将其保存到 /path/to/downloaded-file.txt。
列出对象
要列出s3存储桶中的对象，可以使用listobjects方法。这是一个例子：
$bucketname = 'my-bucket';
$result = $s3client->listobjects([
'bucket' => $bucketname,
]);
foreach ($result['contents'] as $object) {
echo $object['key'] . php_eol;
}
此代码将列出 my-bucket 存储桶中的所有对象并打印它们的密钥。
最佳实践 - aws sdk + php + s3
以下是将适用于 php 的 aws 开发工具包与 s3 结合使用时需要记住的一些最佳实践：
- 使用 iam 角色和策略来管理对 s3 资源的访问。
- 使用版本控制来保留对象的多个版本并防止意外删除。
- 使用生命周期策略自动管理对象的存储和保留。
- 使用传输加速来提高上传和下载的性能。
- 使用服务器端加密来保护您的静态数据。
- 使用事件通知根据 s3 对象的更改触发操作。
当然，这里有一些关于在 laravel 中使用 aws sdk for php 和 s3 的其他技巧。
将适用于 php 的 aws 开发工具包与 laravel 结合使用
laravel 内置了对 aws sdk for php 的支持，这使得您可以在 laravel 应用程序中轻松使用 s3。以下是在 laravel 中使用 sdk 的一些技巧：
- 通过 composer 安装适用于 php 的 aws 开发工具包：
composer require aws/aws-sdk-php
- 在 .env 文件中配置您的 aws 凭证：
aws_access_key_id=your_access_key_id aws_secret_access_key=your_secret_access_key aws_default_region=your_region
- 使用 storage 外观与 s3 交互：
use illuminate\support\facades\storage;
// upload a file
storage::disk('s3')->put('my-file.txt', file_get_contents('/path/to/my-file.txt'));
// download a file
storage::disk('s3')->download('my-file.txt', '/path/to/downloaded-file.txt');
// list the objects in a bucket
$objects = storage::disk('s3')->listcontents('my-bucket');
foreach ($objects as $object) {
echo $object['path'] . php_eol;
}
- 使用 laravel 的 flysystem 适配器来自定义 storage facade 的行为：
use illuminate\support\serviceprovider;
use league\flysystem\awss3v3\awss3v3adapter;
use aws\s3\s3client;
class s3serviceprovider extends serviceprovider
{
public function register()
{
$this->app->singleton('filesystems.disks.s3', function ($app) {
return new awss3v3adapter(
new s3client([
'region' => config('filesystems.disks.s3.region'),
'version' => 'latest',
'credentials' => [
'key' => config('filesystems.disks.s3.key'),
'secret' => config('filesystems.disks.s3.secret'),
],
]),
config('filesystems.disks.s3.bucket')
);
});
}
}
- 使用laravel的队列系统异步执行s3操作：
use Illuminate\Support\Facades\Storage;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
class UploadFile implements ShouldQueue
{
use InteractsWithQueue;
protected $filePath;
public function __construct($filePath)
{
$this->filePath = $filePath;
}
public function handle()
{
Storage::disk('s3')->put('my-file.txt', file_get_contents($this->filePath));
}
}
最佳实践 - aws sdk + php + laravel
在 laravel 中将适用于 php 的 aws 开发工具包与 s3 结合使用时，请记住以下一些最佳实践：
- 使用 laravel 对 aws sdk for php 的内置支持来简化您的代码并减少需要编写的样板代码量。
- 使用 laravel 的队列系统异步执行 s3 操作，这可以提高 laravel 应用程序的性能和可扩展性。
- 使用 laravel 的 flysystem 适配器自定义 storage facade 的行为，并将 s3 与其他 laravel 功能集成，例如 laravel 的缓存系统。
- 使用 laravel 的队列系统异步执行 s3 操作，这可以提高 laravel 应用程序的性能和可扩展性。
- 使用 laravel 的加密功能对敏感数据进行加密，然后再将其存储在 s3 中。
- 使用 laravel 的日志记录功能来记录将适用于 php 的 aws 开发工具包与 s3 结合使用时发生的任何错误或异常。
结论
在本文中，我们介绍了使用 s3 配置适用于 php 的 aws 开发工具包的基础知识，并提供了一些使用该开发工具包与 s3 的其他示例和最佳实践。我们还提供了一些有关在 laravel 中将 sdk 与 s3 一起使用的额外提示。通过遵循这些准则，您可以确保您的 php 应用程序安全、高效且可扩展。
想要了解有关 aws 和 php 的更多信息？查看我们关于 devops mind 的其他文章。
