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

php中文网 2024-10-15 11:47:48

亚马逊网络服务（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 awssdk;

$sdk = new sdk([
    'region' => 'us-east-1',
    'version' =&gt; 'latest',
    'credentials' =&gt; [
        'key' =&gt; 'your_access_key_id',
        'secret' =&gt; 'your_secret_access_key',
    ]
]);

$s3client = $sdk-&gt;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 awssdk;

$sdk = new sdk([
    'region' => 'us-east-1',
    'version' =&gt; 'latest',
]);

$s3client = $sdk-&gt;creates3();

准备好了解有关 aws 和 php 的更多信息了吗？查看我们关于 aws 配置 sso 和修复 laravel 权限被拒绝错误的其他文章。

用法

现在您已经使用 s3 配置了适用于 php 的 aws 开发工具包，您可以开始使用它与 s3 存储桶进行交互。以下是如何列出帐户中所有存储桶的示例：

$buckets = $s3client-&gt;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-&gt;putobject([
    'bucket' =&gt; $bucketname,
    'key' =&gt; $keyname,
    'sourcefile' =&gt; $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-&gt;getobject([
    'bucket' =&gt; $bucketname,
    'key' =&gt; $keyname,
    'saveas' =&gt; $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-&gt;listobjects([
    'bucket' =&gt; $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 illuminatesupportfacadesstorage;

// upload a file
storage::disk('s3')-&gt;put('my-file.txt', file_get_contents('/path/to/my-file.txt'));

// download a file
storage::disk('s3')-&gt;download('my-file.txt', '/path/to/downloaded-file.txt');

// list the objects in a bucket
$objects = storage::disk('s3')-&gt;listcontents('my-bucket');

foreach ($objects as $object) {
    echo $object['path'] . php_eol;
}

使用 laravel 的 flysystem 适配器来自定义 storage facade 的行为：

use illuminatesupportserviceprovider;
use leagueflysystemawss3v3awss3v3adapter;
use awss3s3client;

class s3serviceprovider extends serviceprovider
{
    public function register()
    {
        $this-&gt;app-&gt;singleton('filesystems.disks.s3', function ($app) {
            return new awss3v3adapter(
                new s3client([
                    'region' =&gt; config('filesystems.disks.s3.region'),
                    'version' =&gt; 'latest',
                    'credentials' =&gt; [
                        'key' =&gt; config('filesystems.disks.s3.key'),
                        'secret' =&gt; config('filesystems.disks.s3.secret'),
                    ],
                ]),
                config('filesystems.disks.s3.bucket')
            );
        });
    }
}

使用laravel的队列系统异步执行s3操作：

use IlluminateSupportFacadesStorage;
use IlluminateQueueInteractsWithQueue;
use IlluminateContractsQueueShouldQueue;

class UploadFile implements ShouldQueue
{
    use InteractsWithQueue;

    protected $filePath;

    public function __construct($filePath)
    {
        $this-&gt;filePath = $filePath;
    }

    public function handle()
    {
        Storage::disk('s3')-&gt;put('my-file.txt', file_get_contents($this-&gt;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 的其他文章。

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

本文地址： http://www.ipsmc.com/jishu/9831.html