PHP8 PharData::addFile
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
PharData：：addFile — 将文件系统中的文件添加到 tar/zip 存档中
说明
public PharData::addFile(string $filename, ?string $localName = null): void使用此方法，可以将任何文件或 URL 添加到 tar/zip 存档中。如果 指定了可选的第二个参数， 该文件将以该名称存储在存档中，否则该参数将用作存储在 存档。URL 必须具有 localname，否则会引发异常。 此方法类似于 ZipArchive：：addFile（）。localnamefile
参数
filename要添加的磁盘上文件的完整路径或相对路径 到Phar档案馆。
localName文件将存储在存档中的路径。
返回值
无返回值，失败时引发异常。
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 | localName现在是可为 null 的。 |
示例
示例 #1 A PharData::addFile() example
<?php
try {
$a = new PharData('/path/to/my.tar');
$a->addFile('/full/path/to/file');
// demonstrates how this file is stored
$b = $a['full/path/to/file']->getContent();
$a->addFile('/full/path/to/file', 'my/file.txt');
$c = $a['my/file.txt']->getContent();
// demonstrate URL usage
$a->addFile('http://www.example.com', 'example.html');
} catch (Exception $e) {
// handle errors here
}
?>注释
注意： PharData：：addFile（）， PharData：： addFromString（） 和 PharData：：offsetSet（） 每次调用它们时都会保存一个新的 phar 存档。如果性能是一个问题，则应改用 PharData：：buildFromDirectory（） 或 PharData：：buildFromIterator（）。
参见
- PharData：：offsetSet（） - 将 tar/zip 中文件的内容设置为外部文件或字符串的内容
- Phar::addFile() - 将一个文件从文件系统添加到 phar 档案中
- PharData：：addFromString（） - 将字符串中的文件添加到 tar/zip 存档中
- PharData：：addEmptyDir（） - 在 tar/zip 存档中添加一个空目录