PharData::addFromString

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

PharData::addFromStringファイルシステム上のファイルを tar/zip アーカイブに追加する

説明

public PharData::addFromString(string $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() を使うべきです。

参考

  • PharData::offsetSet() - tar/zip の内部のファイルに、外部ファイルあるいは文字列の内容を設定する
  • Phar::addFromString() - 文字列から、ファイルを phar アーカイブに追加する
  • PharData::addFile() - ファイルシステム上のファイルを tar/zip アーカイブに追加する
  • PharData::addEmptyDir() - 空のディレクトリを tar/zip アーカイブに追加する

関連キーワード:  PharData, アーカイブ, 追加, tar, addFromString, ファイル, addFile, 注意, Phar, 内容