Phar::offsetUnset

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

Phar::offsetUnset — Remove um arquivo de um phar

Descrição

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

Nota:
Este método requer que a configuração phar.readonly do php.ini seja definida como 0 para funcionar com objetos Phar. Caso contrário, uma exceção PharException será lançada.

Esta é uma implementação da interface ArrayAccess que permite a manipulação direta do conteúdo de um arquivo Phar usando colchetes de acesso a arrays. offsetUnset é usado para excluir um arquivo existente e é chamado pela construção de linguagem unset().

Parâmetros

localName: O nome do arquivo (caminho relativo) a ser modificado em um Phar.

Valor Retornado

Nenhum valor é retornado.

Erros/Exceções

Se phar.readonly for 1, BadMethodCallException será lançada, pois modificar um Phar só é permitido quando phar.readonly estiver definido como 0. Lança PharException se houver algum problema ao liberar as alterações feitas no arquivo Phar para o disco.

Exemplos

Exemplo #1 Um exemplo de Phar::offsetUnset()

<?php
$p = new Phar('/caminho/para/meu.phar', 0, 'meu.phar');
try {
    // exclui arquivo.txt de meu.phar chamando offsetUnset
    unset($p['arquivo.txt']);
} catch (Exception $e) {
    echo 'Não foi possível excluir arquivo.txt: ', $e;
}
?>

Veja Também

Phar::offsetExists() - Determina se um arquivo existe no phar
Phar::offsetGet() - Obtém um objeto PharFileInfo para um arquivo específico
Phar::offsetSet() - Define o conteúdo de um arquivo interno para o de um arquivo externo
Phar::unlinkArchive() - Remove completamente um arquivo phar do disco e da memória
Phar::delete() - Exclui um arquivo dentro de um arquivo phar

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.