Phar::offsetUnset

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

Phar::offsetUnset — Efface un fichier d'un phar

Description

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

Note:
Cette méthode nécessite que la variable de configuration INI phar.readonly soit définie à 0 pour fonctionner avec les objets Phar. Sinon, une exception PharException sera lançée.

C'est une implémentation de l'interface ArrayAccess qui permet la manipulation directe du contenu d'une archive Phar en utilisant les crochets d'accès au tableau. offsetUnset est utilisé pour supprimer un fichier existant et est appelé par la fonction unset().

Retour à la première page de Manuel PHP Table des matières Haut

Liste de paramètres

offset: Le nom de fichier (en chemin relatif) à chercher dans le Phar.

Retour à la première page de Manuel PHP Table des matières Haut

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Retour à la première page de Manuel PHP Table des matières Haut

Erreurs / Exceptions

Si phar.readonly est à 1, une exception BadMethodCallException est levée, car modifier un Phar n'est permis que quand phar.readonly est à 0.Une exception PharException est levée s'il y a eu un problème lors de l'écriture des changements de l'archive Phar sur le disque.

Retour à la première page de Manuel PHP Table des matières Haut

Exemples

Exemple #1 Un exemple avec Phar::offsetUnset()


<?php
$p = new Phar('/chemin/vers/mon.phar', 0, 'mon.phar');
try {
    // efface fichier.txt de mon.phar en appelant offsetUnset
    unset($p['fichier.txt']);
} catch (Exception $e) {
    echo 'Ne peut pas effacer fichier.txt: ', $e;
}
?>

Retour à la première page de Manuel PHP Table des matières Haut

Voir aussi

Phar::offsetExists() - Détermine si un fichier existe dans le phar
Phar::offsetGet() - Obtient un objet PharFileInfo à partir d'un fichier
Phar::offsetSet() - Met le contenu d'un fichier interne à l'archive à l'identique du contenu d'un fichier externe
Phar::unlinkArchive() - Efface complètement une archive phar du disque et de la mémoire
Phar::delete() - Efface un fichier au sein d'une archive phar

Rechercher une fonction PHP

Version en cache

23/12/2024 00:23:57 Cette version de la page est en cache (à la date du 23/12/2024 00:23:57) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-phar.offsetunset.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut