Flysystem 3.x中如何从FilesystemOperator获取根目录？

问题背景 #

将项目从Flysystem 1.x升级到3.x后，无法再通过getPathPrefix()方法从文件系统对象获取根目录。1.x中的实现如下：

$adapter = new League\Flysystem\Adapter\Local('/path/to/root');
$filesystem = new League\Flysystem\Filesystem($adapter);

echo $adapter->getPathPrefix(); // 输出 "/path/to/root"

而3.x中FilesystemOperator接口没有暴露获取根目录的直接方法，getPathPrefix()也已被移除，当前初始化代码：

use League\Flysystem\FilesystemOperator;
use League\Flysystem\Local\LocalFilesystemAdapter;

$adapter = new LocalFilesystemAdapter('/path/to/root');
$filesystem = new Filesystem($adapter);

针对你的疑问，解答如下：

1. Flysystem 3.x中获取根目录的推荐方式 #

Flysystem 3.x的设计更偏向抽象封装，不鼓励直接依赖适配器的内部细节，但针对LocalFilesystemAdapter，可以通过适配器自身的pathPrefix()方法获取根目录：

// 直接从适配器获取
echo $adapter->pathPrefix(); // 输出 "/path/to/root"

如果只能拿到FilesystemOperator对象，需要先获取其底层适配器并做类型判断，再调用方法：

use League\Flysystem\Filesystem;
use League\Flysystem\Local\LocalFilesystemAdapter;

if ($filesystem instanceof Filesystem) {
    $adapter = $filesystem->adapter();
    if ($adapter instanceof LocalFilesystemAdapter) {
        $rootPath = $adapter->pathPrefix();
    }
}

2. 关于私有属性$rootLocation #

LocalFilesystemAdapter中的$rootLocation是私有属性，这是Flysystem封装设计的一部分，不建议通过反射等方式强行访问，这会破坏封装性，导致代码依赖内部实现，后续版本更新时容易出现兼容性问题。

3. 符合新设计原则的简洁处理方案 #

最符合Flysystem 3.x设计原则的方式是在初始化时自行保存根路径，因为根路径是你自己传入的，完全可以在创建适配器时将其存入变量或配置中，后续直接使用：

$rootPath = '/path/to/root';
$adapter = new LocalFilesystemAdapter($rootPath);
$filesystem = new Filesystem($adapter);

// 后续需要时直接使用$rootPath即可
echo $rootPath;

这种方式无需依赖适配器的内部方法或属性，完全符合抽象封装的设计理念，同时代码简洁易维护。

内容的提问来源于stack exchange，提问作者skyhell