(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::buildFromIterator — 从迭代器构建 phar 存档
注意:
此方法需要 php.ini 设置
phar.readonly设置为0才能对 Phar 对象生效。否则，将抛出 PharException。
从迭代器填充 phar 存档。支持两种样式的迭代器：将 phar 中的文件名映射到磁盘上文件的名称的迭代器，以及返回 SplFileInfo 对象的迭代器，例如 DirectoryIterator。对于返回 SplFileInfo 对象的迭代器，需要第二个参数。
iterator任何迭代器，它要么将 phar 文件关联映射到位置，要么返回 SplFileInfo 对象
baseDirectory对于返回 SplFileInfo 对象的迭代器，每个文件的完整路径中要删除的部分，以便添加到 phar 存档
Phar::buildFromIterator() 返回一个关联数组，将文件的内部路径映射到文件系统上文件的完整路径。
当迭代器返回不正确的值时，此方法返回 UnexpectedValueException，例如整数键而不是字符串，当没有 baseDirectory 参数传递时返回 BadMethodCallException，或者如果保存 phar 存档时出错，则返回 PharException。
| 版本 | 描述 |
|---|---|
| 8.1.0 |
Phar::buildFromIterator() 不再返回 false。 |
| 8.0.0 |
baseDirectory 现在可以为 null。 |
示例 #1 使用 SplFileInfo 的 Phar::buildFromIterator()
对于大多数 phar 存档，存档将反映实际的目录布局，第二种样式是最有用的。例如，要创建一个包含以下样本目录布局中文件的 phar 存档
/path/to/project/
config/
dist.xml
debug.xml
lib/
file1.php
file2.php
src/
processthing.php
www/
index.php
cli/
index.php
此代码可用于将这些文件添加到 "project.phar" phar 存档
<?php
// 使用别名 "project.phar" 创建
$phar = new Phar('project.phar', 0, 'project.phar');
$phar->buildFromIterator(
new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('/path/to/project')),
'/path/to/project');
$phar->setStub($phar->createDefaultStub('cli/index.php', 'www/index.php'));
?>然后可以立即使用文件 project.phar。Phar::buildFromIterator() 不会设置压缩、元数据等值，这些可以在创建 phar 存档后完成。
值得注意的是，Phar::buildFromIterator() 也可用于复制现有 phar 存档的内容，因为 Phar 对象继承自 DirectoryIterator
<?php
// 使用别名 "project.phar" 创建
$phar = new Phar('project.phar', 0, 'project.phar');
$phar->buildFromIterator(
new RecursiveIteratorIterator(
new Phar('/path/to/anotherphar.phar')),
'phar:///path/to/anotherphar.phar/path/to/project');
$phar->setStub($phar->createDefaultStub('cli/index.php', 'www/index.php'));
?>示例 #2 使用其他迭代器的 Phar::buildFromIterator()
迭代器的第二种形式可用于任何返回键 => 值映射的迭代器，例如 ArrayIterator
<?php
// 使用别名 "project.phar" 创建
$phar = new Phar('project.phar', 0, 'project.phar');
$phar->buildFromIterator(
new ArrayIterator(
array(
'internal/file.php' => dirname(__FILE__) . '/somefile.php',
'another/file.jpg' => fopen('/path/to/bigfile.jpg', 'rb'),
)));
$phar->setStub($phar->createDefaultStub('cli/index.php', 'www/index.php'));
?>您必须在 RecursiveDirectoryIterator 上设置一个标志，因为默认情况下，当前 (".") 和父目录 ("..") 包含在列表中。这会导致类似 "returned a path ".." that is not in the base directory" 的错误消息。
要解决此问题，请使用 "SKIP_DOTS"
<?php
new RecursiveDirectoryIterator(
$srcRoot, FilesystemIterator::SKIP_DOTS
);
?>