使用 S3 配置适用于 PHP 的 AWS 开发工具包

Amazon Web Services (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 和秘密访问密钥对其进行配置。您可以通过创建配置文件或设置环境变量来完成此操作。

配置文件

在项目中创建一个名为 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 访问密钥 ID 和秘密访问密钥设置为环境变量：

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 中将适用于 PHP 的 AWS 开发工具包与 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 Facade 与 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 对适用于 PHP 的 AWS 开发工具包的内置支持来简化您的代码并减少需要编写的样板代码量。
• 使用 Laravel 的队列系统异步执行 S3 操作，这可以提高 Laravel 应用程序的性能和可扩展性。
• 使用 Laravel 的 Flysystem 适配器自定义 Storage Facade 的行为，并将 S3 与其他 Laravel 功能集成，例如 Laravel 的缓存系统。
• 使用 Laravel 的队列系统异步执行 S3 操作，这可以提高 Laravel 应用程序的性能和可扩展性。
• 使用 Laravel 的加密功能对敏感数据进行加密，然后再将其存储在 S3 中。
• 使用 Laravel 的日志记录功能来记录在 S3 中使用适用于 PHP 的 AWS 开发工具包时发生的任何错误或异常。

结论

在本文中，我们介绍了使用 S3 配置适用于 PHP 的 AWS 开发工具包的基础知识，并提供了一些使用该开发工具包与 S3 的其他示例和最佳实践。我们还提供了一些在 Laravel 中将 SDK 与 S3 结合使用的额外提示。通过遵循这些准则，您可以确保您的 PHP 应用程序安全、高效且可扩展。

---

想要了解有关 AWS 和 PHP 的更多信息？查看我们关于 DevOps Mind 的其他文章。

以上是使用 S3 配置适用于 PHP 的 AWS 开发工具包的详细内容。更多信息请关注PHP中文网其他相关文章！