组合模式适合文件系统建模，因为文件和目录可通过统一接口（如FileSystemNode）抽象，支持遍历、删除、获取大小等一致操作，避免类型判断；核心是定义抽象组件并让File和Directory共同实现，结合访问者模式解耦行为，提升扩展性与可维护性。
为什么组合模式适合文件系统建模
因为文件和目录在行为上高度一致：都能被遍历、都能返回大小、都能被删除——只是实现方式不同。用 File 和 Directory 共同实现一个统一接口，就避免了每次调用前反复判断类型。
必须定义的统一接口与两个具体类
核心是抽象出 FileSystemNode 接口（或抽象类），强制约定关键行为。不定义它，后续扩展会不断加 if ($node instanceof Directory) 这类分支，很快失控。
常见错误是把路径拼接逻辑写死在 Directory::add() 里，导致子节点无法感知父级路径；正确做法是让 accept() 或 getSize() 等方法接收上下文路径作为参数，或由节点自己维护 $path 属性（初始化时传入）。
interface FileSystemNode
{
public function getName(): string;
public function getSize(): int;
public function isDirectory(): bool;
public function accept(FileSystemVisitor $visitor, string $basePath = '');
}
class File implements FileSystemNode
{
private string $name;
private int $size;
private string $path;
public function __construct(string $name, int $size, string $path) {
$this->name = $name;
$this->size = $size;
$this->path = $path;
}
public function getName(): string { return $this->name; }
public function getSize(): int { return $this->size; }
public function isDirectory(): bool { return false; }
public function accept(FileSystemVisitor $visitor, string $basePath = ''): void {
$visitor->visitFile($this, $basePath);
}
}
class Directory implements FileSystemNode
{
private string $name;
private array $children = [];
private string $path;
public function __construct(string $name, string $path) {
$this->name = $name;
$this->path = $path;
}
public function add(FileSystemNode $node): void {
$this->children[] = $node;
}
public function getName(): string { return $this->name; }
public function getSize(): int {
return array_sum(array_map(fn($c) => $c->getSize(), $this->children));
}
public function isDirectory(): bool { return true; }
public function accept(FileSystemVisitor $visitor, string $basePath = ''): void {
$visitor->visitDirectory($this, $basePath);
foreach ($this->children as $child) {
$child->accept($visitor, $this->path); // 关键：子节点继承当前目录路径
}
}
}
遍历时用访问者模式解耦操作逻辑
直接在 File/Directory 里写打印、统计、压缩等逻辑，会导致类迅速膨胀。把操作抽成 FileSystemVisitor，就能复用同一棵树执行不同任务。
立即学习“PHP免费学习笔记（深入）”；
容易忽略的是路径传递细节：Directory::accept() 调用子节点时，必须把自身完整路径传下去，否则 File::accept() 拿不到真实磁盘路径；而 visitFile() 方法签名里必须接收 $basePath，再拼出 $basePath . '/' . $this->name。
示例访问者只做打印，但实际可轻松换成 SizeCalculatorVisitor 或 SearchVisitor：
interface FileSystemVisitor
{
public function visitFile(File $file, string $basePath): void;
public function visitDirectory(Directory $dir, string $basePath): void;
}
class PrintVisitor implements FileSystemVisitor
{
public function visitFile(File $file, string $basePath): void {
echo "FILE: {$basePath}/{$file->getName()} ({$file->getSize()} bytes)\n";
}
public function visitDirectory(Directory $dir, string $basePath): void {
echo "DIR: {$basePath}/{$dir->getName()}\n";
}
}
真实使用时要注意的三个硬约束
组合模式不是银弹。实际集成到 PHP 文件系统管理中，必须面对这些限制：
- PHP 的
opendir()/scandir()是阻塞 IO，构建大目录树时别在请求周期内同步加载全部节点——应惰性加载（Directory::getChildren()延迟到首次遍历时才读取） -
Directory类不能自动监听磁盘变更；若需实时响应，得配合inotify扩展或轮询，组合结构本身不解决这个问题 - 权限校验必须在每个
accept()调用前显式检查（比如is_readable($path)），组合模式不携带权限语义，漏掉就会触发Warning: opendir(): Permission denied
最常被跳过的环节，是在构造 Directory 实例时没验证路径是否存在或是否可读——结果第一次 accept() 就崩，而不是延迟到真正访问子节点时才暴露问题。
