如何使用PharData::buildFromIterator从目录构建.tar归档并排除指定文件

没问题，我来帮你搞定这个需求！你说得对，PharData::buildFromDirectory的正则匹配逻辑是包含符合规则的文件，确实没法直接实现排除指定文件的需求，而buildFromIterator因为可以自定义迭代器，正好能解决这个问题。

核心思路是用FilterIterator包装递归目录迭代器，在迭代过程中过滤掉你不需要的文件。下面是具体的实现步骤和完整代码：

步骤1：标准化排除文件路径 #

首先把要排除的文件路径标准化，避免因为路径格式差异（比如相对/绝对路径、末尾斜杠）导致过滤失效：

// 定义需要排除的文件列表，用realpath统一路径格式
$excludePaths = array_map(function ($path) {
    return realpath($path);
}, [
    '/path/to/project/file0.txt',
    '/path/to/project/file1.txt',
    '/path/to/project/file2.txt',
]);

步骤2：创建带过滤逻辑的迭代器 #

我们用PHP 7+支持的匿名类来实现FilterIterator，在accept方法里判断当前文件是否需要被排除：

// 初始化基础递归目录迭代器
$dirIterator = new RecursiveDirectoryIterator(
    '/path/to/project',
    FilesystemIterator::SKIP_DOTS // 跳过.和..目录
);
$recursiveIterator = new RecursiveIteratorIterator($dirIterator);

// 包装成带过滤逻辑的迭代器
$filteredIterator = new class($recursiveIterator, $excludePaths) extends FilterIterator {
    private $excludeList;

    public function __construct(Iterator $iterator, array $excludeList) {
        parent::__construct($iterator);
        $this->excludeList = $excludeList;
    }

    // 核心过滤逻辑：返回true表示保留当前文件，false表示排除
    public function accept() {
        $currentFileRealPath = realpath($this->current()->getPathname());
        // 检查当前文件是否在排除列表中，不在则保留
        return !in_array($currentFileRealPath, $this->excludeList, true);
    }
};

步骤3：用过滤后的迭代器构建归档 #

最后把这个过滤好的迭代器传给buildFromIterator即可：

// 初始化PharData对象（目标归档文件路径）
$pharArchive = new PharData('/path/to/your/target/archive.tar');
// 构建归档，第二个参数是基础目录，用于剥离归档内文件的前缀路径
$pharArchive->buildFromIterator($filteredIterator, '/path/to/project');

额外说明 #

• 如果需要排除整个目录，可以修改accept方法，比如判断当前路径是否是目录且包含在排除列表中：

  public function accept() {
      $currentPath = realpath($this->current()->getPathname());
      // 排除指定目录及其子内容
      foreach ($this->excludeList as $excludePath) {
          if (str_starts_with($currentPath, $excludePath . DIRECTORY_SEPARATOR)) {
              return false;
          }
      }
      return !in_array($currentPath, $this->excludeList, true);
  }
  

• 如果你还在使用PHP 5（不支持匿名类），只需要把上面的匿名类改成一个独立的子类即可，逻辑完全一致。
• 用realpath是为了确保路径格式统一，比如避免/path/to/project/file0.txt和/path/to/project//file0.txt（多了斜杠）被当成不同路径的问题。

内容的提问来源于stack exchange，提问作者Miloš Đakonović