Phar::addFromString
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFromString — Add a file from a string to the phar archive
Beschreibung
$localName
, string $contents
): voidHinweis:
Diese Methode des Phar-Objekts funktioniert nur wenn die php.ini-Einstellung
phar.readonly
auf 0 gesetzt ist, sonst wird eine PharException geworfen.
With this method, any string can be added to the phar archive.
The file will be stored in the archive with localname
as its
path. This method is similar to ZipArchive::addFromString().
Parameter-Liste
-
localName
-
Path that the file will be stored in the archive.
-
contents
-
The file contents to store
Rückgabewerte
no return value, exception is thrown on failure.
Beispiele
Beispiel #1 A Phar::addFromString() example
<?php
try {
$a = new Phar('/path/to/phar.phar');
$a->addFromString('path/to/file.txt', 'my simple file');
$b = $a['path/to/file.txt']->getContent();
// to add contents from a stream handle for large files, use offsetSet()
$c = fopen('/path/to/hugefile.bin');
$a['largefile.bin'] = $c;
fclose($c);
} catch (Exception $e) {
// handle errors here
}
?>
Anmerkungen
Hinweis: Die Funktionen Phar::addFile(), Phar::addFromString() und Phar::offsetSet() speichern bei jedem Aufruf ein neues phar-Archiv. Wenn die Leistung ein wichtiger Faktor ist, sollte stattdessen Phar::buildFromDirectory() oder Phar::buildFromIterator() verwendet werden.
Siehe auch
- Phar::offsetSet() - Set the contents of an internal file to those of an external file
- PharData::addFromString() - Add a file from the filesystem to the tar/zip archive
- Phar::addFile() - Add a file from the filesystem to the phar archive
- Phar::addEmptyDir() - Add an empty directory to the phar archive