免费AI编程助手
PHP8 PharData::buildFromIterator
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
PharData：：buildFromIterator — 从迭代器构造 tar 或 zip 存档
说明
public PharData::buildFromIterator(Traversable $iterator, ?string $baseDirectory = null): array从迭代器填充 tar 或 zip 存档。支持两种样式的迭代器， 将 tar/zip 中的文件名映射到磁盘上文件名的迭代器， 以及返回的迭代器，如 DirectoryIterator SplFileInfo 对象。对于返回 SplFileInfo 对象的迭代器，第二个 参数是必需的。
参数
iterator任何将 tar/zip 文件关联映射到位置或 返回 SplFileInfo 对象
baseDirectory对于返回 SplFileInfo 对象的迭代器，每个对象的部分 添加到 tar/zip 存档时要删除的文件的完整路径
返回值
PharData：：buildFromIterator（） 返回一个关联数组 将文件的内部路径映射到 文件系统。
错误／异常
此方法返回 UnexpectedValueException，当 迭代器返回不正确的值，例如整数键而不是 string，当 基于 SplFileInfo 的迭代器在不带参数的情况下传递，如果存在错误，则传递 PharException 保存 Phar 存档。baseDirectory
更新日志
| 版本 | 说明 |
|---|---|
| 8.1.0 | PharData：：buildFromIterator（） 不再返回 false。 |
| 8.0.0 | baseDirectory现在是可为 null 的。 |
示例
示例 #1 带有 SplFileInfo 的 PharData：：buildFromIterator（）
对于大多数 tar/zip 存档，存档将反映实际的目录布局，并且 第二种样式是最有用的。例如，创建一个 tar/zip 存档 包含此示例目录布局中的文件：
/path/to/project/
config/
dist.xml
debug.xml
lib/
file1.php
file2.php
src/
processthing.php
www/
index.php
cli/
index.php此代码可用于将这些文件添加到“project.tar”tar 存档中：
<?php
$phar = new PharData('project.tar');
$phar->buildFromIterator(
new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('/path/to/project')),
'/path/to/project');
?>然后可以立即使用该文件。PharData：：buildFromIterator（） 没有 设置压缩、元数据等值，这可以在创建 tar/zip 存档。project.tar
有趣的是，PharData：：buildFromIterator（） 也可以用于 复制现有 phar、tar 或 zip 存档的内容，因为 PharData 对象下降 来自 DirectoryIterator：
<?php
$phar = new PharData('project.tar');
$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 带有其他迭代器的 PharData：：buildFromIterator（）
迭代器的第二种形式可以与任何返回的迭代器一起使用 键 => 值映射，例如 ArrayIterator：
<?php
$phar = new PharData('project.tar');
$phar->buildFromIterator(
new ArrayIterator(
array(
'internal/file.php' => dirname(__FILE__) . '/somefile.php',
'another/file.jpg' => fopen('/path/to/bigfile.jpg', 'rb'),
)));
?>参见
- Phar：：buildFromIterator（） - 从迭代器构造 phar 存档
更多建议：