PharData::buildFromIterator()
从一个可迭代对象中创建一个新的PharData对象，迭代对象必须返回一个或多个SplFileInfo对象，表示要添加到PharData对象中的文件
函数：PharData::buildFromIterator()
版本：PHP 5 >= 5.3.0, PHP 7, PHP 8
用法：
PharData::buildFromIterator( Iterator $iterator [, string $base_directory ] ) : bool
该函数从一个可迭代对象中创建一个新的PharData对象，迭代对象必须返回一个或多个SplFileInfo对象，表示要添加到PharData对象中的文件。
参数：
$iterator: 必需，一个实现了Iterator接口的可迭代对象，必须返回SplFileInfo对象。
$base_directory（可选）: 基本目录路径，用于在PharData对象中创建文件的相对路径。
返回值：
如果成功创建了PharData对象，则返回true；否则返回false。
示例：
$files = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator('/path/to/directory')
);
$phar = new PharData('/path/to/archive.tar');
$phar->buildFromIterator($files, '/path/to/directory');
// 添加文件到压缩包中
$phar->addFile('/path/to/file1.txt', 'file1.txt');
$phar->addFile('/path/to/file2.txt', 'file2.txt');
// 压缩整个目录到压缩包中
$phar->buildFromIterator(
new DirectoryIterator('/path/to/directory'),
'/path/to/directory'
);
// 压缩文件到压缩包中
$phar->buildFromIterator(
new ArrayIterator([
new SplFileInfo('/path/to/file1.txt'),
new SplFileInfo('/path/to/file2.txt'),
])
);
在上面的示例中，我们首先创建了一个可迭代对象$files，它包含了指定目录下的所有文件。然后，我们创建了一个名为archive.tar的PharData对象，并使用buildFromIterator()方法将$files中的所有文件添加到压缩包中。接下来，我们使用addFile()方法手动添加了一些其他文件。最后，我们还展示了另外两种使用buildFromIterator()方法的示例，分别是压缩整个目录和压缩指定文件列表。