PharData::offsetSet
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::offsetSet — Remplit un fichier au sein de l'archive tar/zip avec le contenu d'un fichier externe ou d'une chaîne de caractères
Description
C'est une implémentation de l'interface ArrayAccess permettant la manipulation directe du contenu d'une archive tar/zip en utilisant les crochets, opérateurs d'accès au tableau. offsetSet est utilisé pour modifier un fichier existant ou pour ajouter un nouveau fichier à l'archive tar/zip.
Liste de paramètres
-
localName -
Le chemin (relatif) du fichier à modifier au sein de l'archive tar ou zip.
-
value -
Contenu du fichier.
Valeurs de retour
Aucune valeur de retour.
Erreurs / Exceptions
Soulève une exception PharException si des problèmes ont été rencontrés lors de l'écriture sur le disque des changements de l'archive tar/zip.
Exemples
Exemple #1 Un exemple avec PharData::offsetSet()
offsetSet ne doit pas être accédé directement, mais plutôt utilisé via
l'opérateur [].
<?php
$p = new PharData('/chemin/vers/mon.tar');
try {
// appelle offsetSet
$p['fichier.txt'] = 'Salut';
} catch (Exception $e) {
echo 'Ne peut pas modifier fichier.txt:', $e;
}
?>Notes
Note: Phar::addFile(), Phar::addFromString() et Phar::offsetSet() enregistre une nouvelle archive phar à chaque fois qu'elles sont appelées. Si les performances sont une préoccupation, Phar::buildFromDirectory() ou Phar::buildFromIterator() devraient être utilisé à la place.
Voir aussi
- Phar::offsetSet() - Met le contenu d'un fichier interne à l'archive à l'identique du contenu d'un fichier externe
add a note
