Phar::addEmptyDir

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

Phar::addEmptyDir — 空のディレクトリを phar アーカイブに追加する

説明

public function Phar::addEmptyDir(string $directory): void

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

このメソッドを使用すると、空のディレクトリが dirname に作成されます。このメソッドは ZipArchive::addEmptyDir() と同じようなものです。

パラメータ

directory: phar アーカイブ内に作成する空のディレクトリの名前。

戻り値

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

例

例1 Phar::addEmptyDir() の例

<?php
try {
    $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 アーカイブに追加する

関連キーワード:

Phar phar アーカイブ addEmptyDir path addFile directory readonly PharException dirname ZipArchive 確認 isDir catch Exception 参考 PharData ファイルシステム addFromString