告别文件存储切换噩梦：如何使用Composer和FlysystemStreamWrapper优雅地管理多源文件

<code class="bash">composer require twistor/flysystem-stream-wrapper</code>

<code class="bash">composer require league/flysystem-local</code>

<code class="bash">composer require league/flysystem-aws-s3-v3</code>

<code class="php"><?php

require 'vendor/autoload.php';

use League\Flysystem\Adapter\Local; // 引入本地文件系统适配器
use League\Flysystem\Filesystem;    // 引入Flysystem文件系统
use Twistor\FlysystemStreamWrapper;  // 引入流包装器

// 步骤1：实例化你的Flysystem文件系统
// 假设我们最初将文件存储在本地的 'data/' 目录下
$adapter = new Local(__DIR__ . '/data');
$filesystem = new Filesystem($adapter);

// 步骤2：注册Flysystem文件系统为一个自定义的流协议
// 'my_storage' 是你自定义的协议名称，你可以随意命名
FlysystemStreamWrapper::register('my_storage', $filesystem);

echo "--- 使用 my_storage:// 协议操作文件 ---\n";

// 现在，你可以像操作本地文件一样，使用PHP原生函数来操作你的Flysystem文件系统了！

$content = "Hello from Flysystem Stream Wrapper!\n";
file_put_contents('my_storage://documents/welcome.txt', $content);
echo "文件 'my_storage://documents/welcome.txt' 已写入。\n";

$readContent = file_get_contents('my_storage://documents/welcome.txt');
echo "从 'my_storage://documents/welcome.txt' 读取内容：\n" . $readContent;

mkdir('my_storage://uploads/images');
echo "目录 'my_storage://uploads/images' 已创建。\n";

if (file_exists('my_storage://documents/welcome.txt')) {
    echo "'my_storage://documents/welcome.txt' 文件存在。\n";
}

// 步骤3：当不再需要时，可以注销流协议（通常在应用生命周期结束时）
// FlysystemStreamWrapper::unregister('my_storage');

echo "\n--- 切换到云存储（无需修改原有文件操作代码）---\n";

// 假设现在我们要切换到AWS S3，你只需要修改实例化Flysystem的部分，而原有的file_*调用无需改动！
// 注：这里需要真实的S3配置，仅为演示
/*
use Aws\S3\S3Client;
use League\Flysystem\AwsS3v3\AwsS3Adapter;

$s3Client = new S3Client([
    'credentials' => [
        'key'    => 'YOUR_AWS_ACCESS_KEY_ID',
        'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',
    ],
    'region' => 'your-region',
    'version' => 'latest',
]);
$s3Adapter = new AwsS3Adapter($s3Client, 'your-bucket-name');
$s3Filesystem = new Filesystem($s3Adapter);

// 重新注册同一个协议名称，但指向新的文件系统
FlysystemStreamWrapper::unregister('my_storage'); // 先注销旧的
FlysystemStreamWrapper::register('my_storage', $s3Filesystem); // 再注册新的

// 奇迹发生了！你原有的 file_put_contents('my_storage://documents/welcome.txt', ...)
// 现在会直接操作你的S3存储桶，而无需改动任何一行调用代码！
file_put_contents('my_storage://documents/welcome_s3.txt', "Hello from S3!\n");
echo "文件 'my_storage://documents/welcome_s3.txt' 已写入S3。\n";
*/
?></code>