亚马逊网络服务(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 的其他文章。
以上就是使用 S3 配置适用于 PHP 的 AWS 开发工具包的详细内容,更多请关注本网内其它相关文章!