(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::addFile — 将文件系统中的文件添加到tar/zip存档
使用此方法，可以将任何文件或URL添加到tar/zip存档。如果指定可选的第二个参数localname，则该文件将使用该名称存储在存档中，否则将使用file参数作为存储在存档中的路径。URL必须具有localname，否则会抛出异常。此方法类似于ZipArchive::addFile()。
filename要添加到phar存档的磁盘上文件的完整路径或相对路径。
localName文件将在存档中存储的路径。
无返回值，失败时抛出异常。
| 版本 | 描述 |
|---|---|
| 8.0.0 |
localName现在可以为空。 |
示例 #1 一个 PharData::addFile() 示例
<?php
try {
$a = new PharData('/path/to/my.tar');
$a->addFile('/full/path/to/file');
// 演示此文件是如何存储的
$b = $a['full/path/to/file']->getContent();
$a->addFile('/full/path/to/file', 'my/file.txt');
$c = $a['my/file.txt']->getContent();
// 演示URL用法
$a->addFile('http://www.example.com', 'example.html');
} catch (Exception $e) {
// 在此处处理错误
}
?>注意: PharData::addFile()，PharData::addFromString() 和 PharData::offsetSet() 每次调用都会保存一个新的phar存档。如果性能是一个问题，则应改用 PharData::buildFromDirectory() 或 PharData::buildFromIterator()。