Phar::delete
Phar::delete
(PHP >= 5.3.0, PECL phar >= 2.0.0)
Phar::delete — Delete a file within a phar archive
Description
public bool Phar::delete ( string $entry )
Note: This method requires the php.ini settingphar.readonlyto be set to0in order to work for Phar objects. Otherwise, a PharException will be thrown.
Delete a file within an archive. This is the functional equivalent of calling unlink() on the stream wrapper equivalent, as shown in the example below.
Parameters
entry
Path within an archive to the file to delete.
Return Values
returns TRUE on success, but it is better to check for thrown exception, and assume success if none is thrown.
Errors/Exceptions
Throws PharException if errors occur while flushing changes to disk.
Examples
Example #1 A Phar::delete() example
<?php
try {
$phar = new Phar('myphar.phar'
$phar->delete('unlink/me.php'
// this is equivalent to:
unlink('phar://myphar.phar/unlink/me.php'
} catch (Exception $e) {
// handle errors
}
?>
See Also
- PharData::delete() - Delete a file within a tar/zip archive
- Phar::unlinkArchive() - Completely remove a phar archive from disk and from memory
← Phar::delMetadata
Phar::extractTo →
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
