单独执行 composer require league/flysystem 不能解决 FTP 文件传输问题——必须补装 league/flysystem-ftp 才能使用 FtpAdapter 类；v3 中 FTP 非开箱即用，FtpAdapter 构造参数须为 FtpConnectionOptions 实例，且需显式配置 host、username、password 等必填项，root 路径建议显式指定以避免上传路径错位。
单独执行 composer require league/flysystem 不能解决 FTP 文件传输问题——它只装了核心抽象层，没装 FTP 适配器，连 FtpAdapter 类都不存在，代码直接报错 Class "League\Flysystem\Ftp\FtpAdapter" not found。
必须补装 league/flysystem-ftp 才能用 FTP
Flysystem v3 把协议适配器全部拆成独立包，FTP 不是开箱即用的。漏掉这步，new FtpAdapter(...) 会 fatal error。
-
composer require league/flysystem-ftp是硬性前提，和 core 包平级，不是可选依赖 - 如果项目已存在旧版
league/flysystem（v1/v2），先运行composer remove league/flysystem再重装，避免版本冲突导致FtpConnectionOptions找不到 - 注意：v3 的
FtpAdapter构造参数必须是FtpConnectionOptions实例，传数组会抛TypeError
FtpConnectionOptions 配置写错会导致连接超时或认证失败
常见错误是把 host、username 等字段直接塞进 new FtpAdapter([...])，而 v3 要求先调用 FtpConnectionOptions::fromArray() 封装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必填项只有
host、username、password；root和port是可选的，但生产环境建议显式指定 -
ssl => true时，底层用ftp_ssl_connect()，若服务器不支持会卡住，建议先用ssl => false测试通路 -
passive => false可能解决某些 NAT 环境下的数据通道失败，但多数公网 FTP 服务器要求 passive 模式开启
上传失败却没报错？检查路径是否带 root 前缀
$filesystem->write('test.txt', 'content') 看似成功，但文件实际出现在 FTP 根目录外的某个不可见位置——因为 FtpAdapter 的 root 参数默认为空，而 FTP 协议本身没有“绝对路径”概念，它依赖登录后的初始工作目录。
- 在
FtpConnectionOptions::fromArray()中明确传'root' => '/var/www/uploads'，否则上传路径会被解释为相对于当前工作目录（可能因 FTP 服务配置而异） - 不要依赖相对路径如
./uploads/test.txt，FTP 服务器对.和..的解析不一致，本地测试通 ≠ 上线通 - 用
$filesystem->listContents('')验证根目录内容，确认文件真正在预期位置
最易被忽略的是：Flysystem 的 FTP 适配器不自动创建不存在的父目录。如果写 $filesystem->write('logs/2026/04/app.log', $data) 而 logs/2026/04 不存在，操作静默失败（返回 false，不抛异常）。必须提前用 $filesystem->createDirectory('logs/2026/04')。
