(No version information available, might be only in CVS)
Phar::convertToPhar — Convert the phar archive to the phar file format
Note: This method requires the php.ini setting phar.readonly to be set to 0 in order to work for Phar objects. Otherwise, a PharException will be thrown.
This method is used to convert a phar archive in tar or zip format to the phar file format.
By default, the extension is .phar for converting from uncompressed tar archives or any zip archive, .phar.gz for conversion from zlib-compressed tar archives, or .phar.bz2 for conversion from bzip2-compressed tar archives.
The method returns a Phar object on success and throws an exception on failure.
This method throws BadMethodCallException when unable to compress, an unknown compression method has been specified, the requested archive is buffering with Phar::startBuffering() and has not concluded with Phar::stopBuffering(), an UnexpectedValueException if write support is disabled, and a PharException if any problems are encountered during the phar creation process.
Example#1 A Phar::convertToPhar() example
Using Phar::convertToPhar():
<?php
try {
$tarphar = new Phar('myphar.tar.phar');
// convert it to the phar file format
// note that myphar.tar.phar is *not* unlinked
$phar = $tarphar->convertToPhar();
$phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
} catch (Exception $e) {
// handle the error here
}
?>