(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 現在可以為 null。 |
範例 #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()。