Phar::addEmptyDir
(PHP 5 >= 5.3.0, PHP 7, PECL phar >= 2.0.0)
Phar::addEmptyDir — 空のディレクトリを phar アーカイブに追加する
説明
public Phar::addEmptyDir
( string $dirname
) : void
注意:
このメソッドは、
php.ini
のphar.readonly
が0
でないと Phar オブジェクトで動作しません。それ以外の場合は PharException がスローされます。
このメソッドを使用すると、空のディレクトリが dirname
に作成されます。このメソッドは ZipArchive::addEmptyDir()
と同じようなものです。
パラメータ
dirname
- phar アーカイブ内に作成する空のディレクトリの名前。
返り値
返り値はありません。失敗時には例外をスローします。
例
例1 Phar::addEmptyDir() の例
<?phptry { $a = new Phar('/path/to/phar.phar'); $a->addEmptyDir('/full/path/to/file'); // できあがったファイルを確認します $b = $a['full/path/to/file']->isDir();} catch (Exception $e) { // ここでエラー処理をします}?>
参考
- PharData::addEmptyDir() - 空のディレクトリを tar/zip アーカイブに追加する
- Phar::addFile() - ファイルシステム上のファイルを phar アーカイブに追加する
- Phar::addFromString() - 文字列から、ファイルを phar アーカイブに追加する