Phar::offsetUnset

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

Phar::offsetUnset — Eliminar un fichero de un phar

Descripción

public Phar::offsetUnset(string $offset): bool

Nota:
Este método requiere que la opción de php.ini phar.readonly esté establecida a 0 para que trabaje con objetos Phar. De otra manera, se lanzará una excepción de tipo PharException.

Ésta 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 borrar un fichero existente, y es llamado por el constructor de lenguaje unset().

Parámetros

offset: El nombre del fichero (ruta relativa) a eliminar en un Phar.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Errores/Excepciones

Si phar.readonly es 1, lanza una excepción de tipo BadMethodCallException, ya que modificar un Phar sólo está permitido cuando phar.readonly está establecido a 0. Lanza un excepción de tipo PharException si existe cualquier problema volcando los cambios hechos al archivo Phar al disco.

Ejemplos

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

<?php
$p = new Phar('/ruta/a/mi.phar', 0, 'mi.phar');
try {
    // borra fichero.txt de mi.phar llamando a offsetUnset
    unset($p['fichero.txt']);
} catch (Exception $e) {
    echo 'No se pudo borrar fichero.txt: ', $e;
}
?>

Ver también

Phar::offsetExists() - Determina si un fichero existe en un phar
Phar::offsetGet() - Obtener un objeto de la clase PharFileInfo para un fichero específico
Phar::offsetSet() - Establecer el contenido de un fichero interno a aquel de un fichero externo
Phar::unlinkArchive() - Elimiar completamente un archivo phar del disco y de la memoria
Phar::delete() - Borrar 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.