PharData::convertToExecutable
Convert a non-executable tar/zip archive to an executable phar archive
&reftitle.description;
public PharnullPharData::convertToExecutable
intnullformat&null;
intnullcompression&null;
stringnullextension&null;
&phar.write;
This method is used to convert a non-executable tar or zip archive to an
executable phar archive. Any of the three executable file formats
(phar, tar or zip) can be used, and whole-archive compression can also be performed.
If no changes are specified, this method throws a BadMethodCallException.
If successful, the method creates a new archive on disk and returns a Phar
object. The old archive is not removed from disk, and should be done manually after
the process has finished.
&reftitle.parameters;
format
This should be one of Phar::PHAR, Phar::TAR,
or Phar::ZIP. If set to &null;, the existing file format
will be preserved.
compression
This should be one of Phar::NONE for no whole-archive
compression, Phar::GZ for zlib-based compression, and
Phar::BZ2 for bzip-based compression.
extension
This parameter is used to override the default file extension for a
converted archive. Note that all zip- and tar-based phar archives must contain
.phar in their file extension in order to be processed as a
phar archive.
If converting to a phar-based archive, the default extensions are
.phar, .phar.gz, or .phar.bz2
depending on the specified compression. For tar-based phar archives, the
default extensions are .phar.tar, .phar.tar.gz,
and .phar.tar.bz2. For zip-based phar archives, the
default extension is .phar.zip.
&reftitle.returnvalues;
The method returns a Phar object on success,
or &null; on failure.
&reftitle.errors;
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.
&reftitle.changelog;
&Version;
&Description;
8.0.0
format, compression, and localName are now nullable.
&reftitle.examples;
A <function>PharData::convertToExecutable</function> example
Using PharData::convertToExecutable():
convertToExecutable(Phar::PHAR); // creates myphar.phar
$phar->setStub($phar->createDefaultStub('cli.php', 'web/index.php'));
// creates myphar.phar.tgz
$compressed = $tarphar->convertToExecutable(Phar::TAR, Phar::GZ, '.phar.tgz');
} catch (Exception $e) {
// handle the error here
}
?>
]]>
&reftitle.seealso;
Phar::convertToExecutable
Phar::convertToData
PharData::convertToData