有效，但需注意版本兼容性：PHP 7.4 及以下须用 composer require league/flysystem:^2.5，PHP 8.0+ 可用 v3；v2 与 v3 在适配器安装、实例化方式、路径处理及权限控制上存在显著差异。
Composer install flysystem 命令是否还有效
直接运行 composer require league/flysystem 仍可安装，但要注意：自 v3 起，league/flysystem 已拆分为核心包 + 适配器包，单独装这个会默认拉取 v3.x（PHP 8.0+），若项目用 PHP 7.4 或更早，必须锁定 v2：composer require league/flysystem:^2.5。
常见错误现象：Class 'League\Flysystem\Filesystem' not found，大概率是装了 v3 却用了 v2 的写法，或漏装适配器。
- v2 写法依赖
league/flysystem+ 具体适配器（如league/flysystem-aws-s3-v3） - v3 写法需额外装
league/flysystem-local、league/flysystem-s3等对应驱动 - 检查 PHP 版本与
composer show league/flysystem输出的版本是否匹配
本地文件系统适配器怎么配（v2 和 v3 差异在哪）
v2 中 LocalAdapter 是内置的，v3 则必须显式安装 league/flysystem-local 并手动构造适配器实例。
v2 示例：
use League\Flysystem\Filesystem;
use League\Flysystem\Adapter\Local;
$adapter = new Local('/path/to/root');
$filesystem = new Filesystem($adapter);
v3 示例：
use League\Flysystem\Filesystem;
use League\Flysystem\Local\LocalFilesystemAdapter;
use League\Flysystem\UnixVisibility\PortableVisibilityConverter;
$adapter = new LocalFilesystemAdapter(
'/path/to/root',
PortableVisibilityConverter::fromArray()
);
$filesystem = new Filesystem($adapter);
- v3 默认启用可见性控制，不传
PortableVisibilityConverter可能报错或权限异常 - v2 的
Local构造器第二个参数是权限掩码（如0755），v3 改为通过VisibilityConverter控制 - 路径末尾斜杠不影响行为，但建议统一用绝对路径，避免相对路径在 CLI/Web 下行为不一致
如何让 Flysystem 自动加载 S3 或 FTP 适配器
不是装完包就能用 —— 必须确保适配器类被自动加载，且构造时传入正确依赖（如 AWS SDK v3、ext-ftp）。
以 S3 为例（v3）：
- 先装驱动：
composer require league/flysystem-s3 aws/aws-sdk-php - 确保
aws/aws-sdk-php≥ 3.270（低版本与 Flysystem v3 不兼容） - 构造前需初始化
Aws\S3\S3Client实例，再传给S3Adapter - FTP 适配器（
league/flysystem-ftp）要求服务器开启 passive 模式，否则listContents()可能卡住或超时
典型错误信息：Class 'Aws\S3\S3Client' not found（漏装 aws-sdk-php），或 Connection refused（FTP 防火墙/被动模式未开）。
为什么 $filesystem->write() 成功但文件没出现在预期目录
最常见原因是路径理解偏差：write('logs/app.log', $content) 中的 logs/app.log 是相对于 Flysystem 根目录的路径，不是当前工作目录或 webroot。
- 确认初始化适配器时传入的根路径（如
/var/www/myapp/storage），最终文件位置是该路径 + 相对路径 - Linux 下注意权限：Web 进程用户（如 www-data）需对根目录有写权限，否则静默失败（部分驱动不抛异常）
- v3 的
write()默认不创建父目录，需提前调用createDirectory('logs')，而 v2 的write()会自动创建 - 调试技巧：用
$filesystem->listContents('')查看实际挂载结构，比猜路径更可靠
复杂点往往不在配置本身，而在路径语义、权限边界和版本隐式行为差异 —— 尤其是混合使用 v2/v3 包或跨环境部署时，这些细节容易被忽略。
