(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::addFromString — ファイルシステム上のファイルを tar/zip アーカイブに追加する
$localName, string $contents): void
このメソッドを使用すると、任意の文字列を tar/zip アーカイブに追加することができます。
アーカイブ内のファイル名は localname で指定したものとなります。
このメソッドは ZipArchive::addFromString() と同じようなものです。
localNameファイルをアーカイブ内に格納するときのパス。
contentsファイルに保存する内容。
戻り値はありません。失敗時には例外をスローします。
例1 PharData::addFromString() の例
<?php
try {
$a = new PharData('/path/to/my.tar');
$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) {
// ここでエラー処理をします
}
?>
注意: PharData::addFile(), PharData::addFromString(), PharData::offsetSet() は、呼び出されるたびに新しいPharアーカイブを生成します。パフォーマンスを気にするなら、代わりに PharData::buildFromDirectory() や PharData::buildFromIterator() を使うべきです。