Forum und email

Phar::offsetUnset

(PECL phar:1.0.0-1.2.1)

Phar::offsetUnset — remove a file from a phar

Leírás

bool Phar::offsetUnset ( string $offset )

This is an implementation of the ArrayAccess interface allowing direct manipulation of the contents of a Phar archive using array access brackets. offsetUnset is used for deleting an existing file, and is called by the unset() language construct.

Paraméterek

offset

The filename (relative path) to modify in a Phar.

Visszatérési értékek

Siker esetén TRUE értékkel tér vissza, ellenkező esetben FALSE értéket ad.

Hibák/Kivételek

if phar.readonly is 1, BadMethodCallException is thrown, as modifying a Phar is only allowed when phar.readonly is set to 0. Throws PharException if there are any problems flushing changes made to the Phar archive to disk.

Példák

Example#1 A Phar::offsetUnset() example

<?php
$p 
= new Phar('/path/to/my.phar'0'my.phar');
try {
    
// deletes file.txt from my.phar by calling offsetUnset
    
unset($p['file.txt']);
} catch (
Exception $e) {
    echo 
'Could not delete file.txt: '$e;
}
?>