Php/docs/phar.addfromstring

提供:Dev Guides
< Php
移動先:案内検索

Phar::addFromString

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

Phar::addFromString文字列から、ファイルを phar アーカイブに追加する


説明

public Phar::addFromString ( string $localname , string $contents ) : void

注意:

このメソッドは、php.iniphar.readonly0 でないと Phar オブジェクトで動作しません。それ以外の場合は PharException がスローされます。

このメソッドを使用すると、任意の文字列を phar アーカイブに追加することができます。 アーカイブ内のファイル名は localname で指定したものとなります。 このメソッドは ZipArchive::addFromString() と同じようなものです。


パラメータ

localname
ファイルをアーカイブ内に格納するときのパス。
contents
ファイルに保存する内容。


返り値

返り値はありません。失敗時には例外をスローします。


例1 Phar::addFromString() の例

<?phptry {    $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::offsetSet() - 内部ファイルに、外部ファイルの内容を設定する
  • PharData::addFromString() - ファイルシステム上のファイルを tar/zip アーカイブに追加する
  • Phar::addFile() - ファイルシステム上のファイルを phar アーカイブに追加する
  • Phar::addEmptyDir() - 空のディレクトリを phar アーカイブに追加する