PharData::addFromString
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::addFromString — Add a file from the filesystem to the tar/zip archive
Beschreibung
$localName, string $contents): void
With this method, any string can be added to the tar/zip 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 PharData::addFromString() example
<?php
try {
$a = new PharData('/path/to/my.tar');
$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 PharData::addFile(), PharData::addFromString() und PharData::offsetSet() speichern bei jedem Aufruf ein neues phar-Archiv. Wenn die Leistung ein wichtiger Faktor ist, sollte stattdessen PharData::buildFromDirectory() oder PharData::buildFromIterator() verwendet werden.
Siehe auch
- PharData::offsetSet() - Set the contents of a file within the tar/zip to those of an external file or string
- Phar::addFromString() - Add a file from a string to the phar archive
- PharData::addFile() - Add a file from the filesystem to the tar/zip archive
- PharData::addEmptyDir() - Add an empty directory to the tar/zip archive
