(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFromString — Ajoute un fichier depuis une chaîne de caractère à l'archive phar
Description
public
Phar::addFromString(string
$localName
, string
$contents
): void
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.
Grâce à cette méthode, toute chaîne peut être ajoutée à l'archive phar.
Le fichier sera stocké dans l'archive avec localname
en tant que
chemin. Cette méthode est identique à ZipArchive::addFromString().
Liste de paramètres
-
localName
-
Chemin dans lequel le fichier sera stocké dans l'archive.
-
contents
-
Le contenu de fichier à stocker
Valeurs de retour
Pas de valeur de retour, une exception est levée en cas d'échec.
Exemples
Exemple #1 Un exemple avec phar::addFromString()
<?php
try {
$a = new Phar('/chemin/vers/phar.phar');
$a->addFromString('chemin/vers/fichier.txt', 'mon fichier simple');
$b = $a['chemin/vers/fichier.txt']->getContent();
// pour ajouter du contenu à partir d'un descripteur de flux pour des gros fichiers, utilisez offsetSet()
$c = fopen('/chemin/vers/grosfichier.bin');
$a['grosfichier.bin'] = $c;
fclose($c);
} catch (Exception $e) {
// traite les erreurs ici
}
?>
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
- phardata::addFromString() - Ajoutez un fichier à partir d'une chaîne de caractères à l'archive tar/zip
- phar::addFile() - Ajoute un fichier du système de fichiers à l'archive phar
- phar::addEmptyDir() - Ajoute un répertoire vide à l'archive phar