Phar::offsetUnset

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 1.0.0)

Phar::offsetUnset — Elimina un fichero de un phar

Descripción

public Phar::offsetUnset(string $localName): void

Nota:
Este método requiere que la variable de configuración INI phar.readonly esté definida a 0 para funcionar con los objetos Phar. De lo contrario, se lanzará una excepción PharException.

Esta es una implementación de la interfaz ArrayAccess que permite la manipulación directa del contenido de un archivo Phar utilizando los corchetes de acceso al array. offsetUnset se utiliza para eliminar un fichero existente y es llamado por la función unset().

Parámetros

localName: El nombre del fichero (en ruta relativa) a buscar en el Phar.

Valores devueltos

No se retorna ningún valor.

Errores/Excepciones

Si phar.readonly está a 1, se lanza una excepción BadMethodCallException, ya que modificar un Phar solo es permitido cuando phar.readonly está a 0. Se lanza una excepción PharException si ha habido un problema al escribir los cambios del archivo Phar en el disco.

Ejemplos

Ejemplo #1 Un ejemplo con Phar::offsetUnset()

<?php
$p = new Phar('/ruta/al/mon.phar', 0, 'mon.phar');
try {
    // elimina archivo.txt de mon.phar llamando a offsetUnset
    unset($p['archivo.txt']);
} catch (Exception $e) {
    echo 'No se puede eliminar archivo.txt: ', $e;
}
?>

Ver también

Phar::offsetExists() - Determina si un fichero existe en el phar
Phar::offsetGet() - Obtiene un objeto PharFileInfo a partir de un fichero
Phar::offsetSet() - Establece el contenido de un fichero interno en el archivo a partir del contenido de un fichero externo
Phar::unlinkArchive() - Elimina completamente un archivo phar del disco y de la memoria
Phar::delete() - Elimina un fichero dentro de un archivo phar

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.