5分钟上手Flysystem-aws-s3-v3：PHP连接AWS S3的极简教程
项目地址: https://gitcode.com/gh_mirrors/fl/flysystem-aws-s3-v3 Flysystem-aws-s3-v3是一款专为PHP开发者设计的高效AWS S3文件系统适配器，它能帮助你轻松实现与Amazon S3云存储的无缝对接。本教程将带你快速掌握这个强大工具的使用方法，让你的PHP应用程序在5分钟内具备专业的云存储能力。
📋 准备工作：环境要求速览
在开始之前，请确保你的开发环境满足以下条件：
- PHP版本 ≥ 8.0.2
- Composer包管理工具
- AWS账号及S3存储桶
- 安装aws/aws-sdk-php（≥ 3.295.10版本）
⚡ 一键安装：快速集成到项目
使用Composer进行安装是最简单直接的方式，在项目根目录执行以下命令：
composer require league/flysystem-aws-s3-v3
这条命令会自动安装最新稳定版本的适配器，以及所有必要的依赖包，包括league/flysystem核心库和AWS SDK。
🔧 基础配置：3步完成初始化
1. 创建S3客户端实例
首先需要初始化AWS S3客户端，配置你的AWS访问凭证和区域信息：
use Aws\S3\S3Client;
$client = new S3Client([
'version' => 'latest',
'region' => 'your-aws-region',
'credentials' => [
'key' => 'your-aws-access-key',
'secret' => 'your-aws-secret-key',
]
]);
2. 实例化适配器
使用S3客户端创建适配器实例，指定你的存储桶名称：
use League\Flysystem\AwsS3V3\AwsS3V3Adapter;
$adapter = new AwsS3V3Adapter(
$client,
'your-bucket-name'
);
3. 创建文件系统实例
最后将适配器传入Flysystem的Filesystem类：
use League\Flysystem\Filesystem;
$filesystem = new Filesystem($adapter);
现在你已经拥有了一个功能完备的S3文件系统操作对象！
🚀 核心功能：常用操作指南
文件上传：轻松存储数据
上传文件到S3存储桶只需一行代码：
// 字符串内容上传
$filesystem->write('path/to/file.txt', 'Hello, S3!');
// 本地文件上传
$filesystem->writeStream('path/to/large-file.zip', fopen('/local/path/file.zip', 'r'));
文件读取：便捷获取内容
读取S3中的文件内容同样简单：
// 读取为字符串
$content = $filesystem->read('path/to/file.txt');
// 读取为流资源
$stream = $filesystem->readStream('path/to/large-file.zip');
文件管理：完整的CRUD操作
Flysystem提供了直观的文件管理方法：
// 检查文件是否存在
$exists = $filesystem->fileExists('path/to/file.txt');
// 获取文件元数据
$metadata = $filesystem->lastModified('path/to/file.txt');
$size = $filesystem->fileSize('path/to/file.txt');
$mimeType = $filesystem->mimeType('path/to/file.txt');
// 删除文件
$filesystem->delete('path/to/file.txt');
// 移动/重命名文件
$filesystem->move('old/path.txt', 'new/path.txt');
// 复制文件
$filesystem->copy('source.txt', 'target.txt');
目录操作：组织你的文件
管理目录结构也非常方便：
// 创建目录
$filesystem->createDirectory('new-directory');
// 检查目录是否存在
$dirExists = $filesystem->directoryExists('new-directory');
// 删除目录
$filesystem->deleteDirectory('old-directory');
// 列出目录内容
$contents = $filesystem->listContents('directory', true);
foreach ($contents as $item) {
echo $item->path();
}
访问控制：管理文件可见性
通过可见性设置控制文件访问权限：
use League\Flysystem\Visibility;
// 上传时设置可见性
$filesystem->write('public-file.txt', 'content', [
'visibility' => Visibility::PUBLIC
]);
// 修改现有文件可见性
$filesystem->setVisibility('private-file.txt', Visibility::PRIVATE);
// 获取文件可见性
$visibility = $filesystem->visibility('file.txt');
💡 高级功能：释放S3全部潜力
URL生成：访问你的文件
生成公共URL或临时访问URL：
// 获取公共URL
$publicUrl = $filesystem->publicUrl('path/to/file.txt');
// 生成临时访问URL（有效期1小时）
$temporaryUrl = $filesystem->temporaryUrl(
'path/to/file.txt',
(new \DateTime())->modify('+1 hour')
);
分块上传：处理大文件
适配器内置支持大文件分块上传，无需额外配置：
$stream = fopen('/path/to/very-large-file.iso', 'r');
$filesystem->writeStream('large-file.iso', $stream);
系统会自动检测文件大小并使用分块上传功能，确保大文件传输的稳定性。
📚 进一步学习资源
- 官方文档：完整API参考
- 适配器源代码：AwsS3V3Adapter.php
- 测试用例：AwsS3V3AdapterTest.php
通过本教程，你已经掌握了Flysystem-aws-s3-v3的核心使用方法。这个强大的适配器让PHP与AWS S3的集成变得前所未有的简单，无论是小型项目还是大型应用，都能从中受益。现在就开始在你的项目中使用它，体验专业云存储带来的便利吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
