array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'phardata.addfromstring.php', 1 => 'PharData::addFromString', 2 => 'Ajoute un fichier à partir d\'une chaîne de caractères à l\'archive tar/zip', ), 'up' => array ( 0 => 'class.phardata.php', 1 => 'PharData', ), 'prev' => array ( 0 => 'phardata.addfile.php', 1 => 'PharData::addFile', ), 'next' => array ( 0 => 'phardata.buildfromdirectory.php', 1 => 'PharData::buildFromDirectory', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/phar/PharData/addFromString.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PharData::addFromString

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

PharData::addFromString — Ajoute un fichier à partir d'une chaîne de caractères à l'archive tar/zip

Description

public PharData::addFromString(string $localName, string $contents): void

Ajoute une chaîne de caractères à l'archive tar/zip. Le fichier sera stocké dans l'archive avec le chemin localname. Cette méthode est identique à ZipArchive::addFromString().

Liste de paramètres

localName

Chemin vers lequel le fichier sera stocké au sein de l'archive.

contents

Le contenu du fichier à stocker

Valeurs de retour

Aucune valeur de retour, une exception est levée en cas d'échec.

Exemples

Exemple #1 Exemple avec PharData::addFromString()

<?php
try {
$a = new PharData('/chemin/vers/mon.tar');

$a->addFromString('chemin/vers/fichier.txt', 'mon fichier simple');
$b = $a['chemin/vers/fichier.txt']->getContent();

// pour ajouter du contenu à partir d'un gestionnaire de flux pour des gros fichiers, utiliser offsetSet()
$c = fopen('/chemin/vers/grosfichier.bin');
$a['grosfichier.bin'] = $c;
fclose($c);
} catch (Exception $e) {
// les erreurs sont traitées 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