Phar::addEmptyDir
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addEmptyDir — Add an empty directory to the phar archive
Description
$directory
): voidNote:
This method requires the php.ini setting
phar.readonly
to be set to0
in order to work for Phar objects. Otherwise, a PharException will be thrown.
With this method, an empty directory is created with path dirname
.
This method is similar to ZipArchive::addEmptyDir().
Parameters
-
directory
-
The name of the empty directory to create in the phar archive
Return Values
no return value, exception is thrown on failure.
Examples
Example #1 A Phar::addEmptyDir() example
<?php
try {
$a = new Phar('/path/to/phar.phar');
$a->addEmptyDir('/full/path/to/file');
// demonstrates how this file is stored
$b = $a['full/path/to/file']->isDir();
} catch (Exception $e) {
// handle errors here
}
?>
See Also
- PharData::addEmptyDir() - Add an empty directory to the tar/zip archive
- Phar::addFile() - Add a file from the filesystem to the phar archive
- Phar::addFromString() - Add a file from a string to the phar archive