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.ini
のphar.readonly
が0
でないと 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 アーカイブに追加する