PHP8 PharData::buildFromDirectory
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
PharData：：buildFromDirectory — 从目录中的文件构建一个 tar/zip 存档
说明
public PharData::buildFromDirectory(string $directory, string $pattern = ""): array从目录内容填充 tar/zip 存档。可选的第二个 参数是用于排除文件的正则表达式 （PCRE）。 将包含与正则表达式匹配的任何文件名，所有其他文件名都将包括 排除。如需更精细的控制，请使用 PharData：：buildFromIterator（）。
参数
directory包含所有文件的目录的完整路径或相对路径 添加到存档中。
pattern用于筛选 文件列表。仅与正则表达式匹配的文件路径 将包含在存档中。
返回值
Phar：：buildFromDirectory（） 返回一个关联数组 将文件的内部路径映射到 filesystem， 或者在失败时返回 false.
错误／异常
此方法在无法时引发 BadMethodCallException 实例化内部目录迭代器， 如果存在错误，则为 PharException 保存 Phar 存档。
更新日志
| 版本 | 说明 |
|---|---|
| 8.1.0 | PharData：：buildFromDirectory（） 不再返回 false。 |
示例
示例 #1 A PharData::buildFromDirectory() example
<?php
$phar = new PharData('project.tar');
// add all files in the project
$phar->buildFromDirectory(dirname(__FILE__) . '/project');
$phar2 = new PharData('project2.zip');
// add all files in the project, only include php files
$phar2->buildFromDirectory(dirname(__FILE__) . '/project', '/\.php$/');
?>参见
- Phar：：buildFromDirectory（） - 从目录中的文件构建 phar 存档
- PharData：：buildFromIterator（） - 从迭代器构造 tar 或 zip 存档