(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFromString — 從字串新增檔案到 phar 封存
注意事項:
此方法需要將 php.ini 設定
phar.readonly
設為0
,才能讓 Phar 物件正常運作。否則會擲出 PharException 例外。
使用此方法,可以將任何字串新增至 phar 封存。檔案將以 localname
作為其路徑儲存在封存中。此方法類似於 ZipArchive::addFromString()。
localName
檔案將儲存在封存中的路徑。
contents
要儲存的檔案內容
無傳回值,失敗時會拋出例外。
範例 #1 Phar::addFromString() 範例
<?php
try {
$a = new Phar('/path/to/phar.phar');
$a->addFromString('path/to/file.txt', 'my simple file');
$b = $a['path/to/file.txt']->getContent();
// 若要從大型檔案的串流控制代碼新增內容,請使用 offsetSet()
$c = fopen('/path/to/hugefile.bin');
$a['largefile.bin'] = $c;
fclose($c);
} catch (Exception $e) {
// 在此處處理錯誤
}
?>
注意:每次呼叫 Phar::addFile()、Phar::addFromString() 和 Phar::offsetSet() 時,都會儲存一個新的 phar 封存。如果考量效能,則應改用 Phar::buildFromDirectory() 或 Phar::buildFromIterator()。