Phar::addFromString
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFromString — Добавляет в phar-архив файл из строки
Описание
Замечание:
Для корректной работы с объектами Phar этому методу необходима установка значения php.ini
phar.readonlyв0. В противном случае, будет выброшено исключение PharException.
С помощью этого метода в phar-архив может быть добавлена любая строка.
Файл будет сохранён в архиве под именем, указанным в параметре localname.
Этот метод аналогичен ZipArchive::addFromString().
Список параметров
-
localName -
Путь, по которому файл будет сохранён в архиве.
-
contents -
Содержимое файла для сохранения.
Возвращаемые значения
Нет возвращаемого значения, в случае возникновения ошибки выбрасывается исключение.
Примеры
Пример #1 Пример использования Phar::addFromString()
<?php
try {
$a = new Phar('/путь/к/phar.phar');
$a->addFromString('путь/к/file.txt', 'мой простой файл');
$b = $a['путь/к/file.txt']->getContent();
// для добавления содержимого из дескриптора потока для больших файлов используйте offsetSet()
$c = fopen('/путь/к/hugefile.bin');
$a['largefile.bin'] = $c;
fclose($c);
} catch (Exception $e) {
// обработка ошибок
}
?>Примечания
Замечание: Phar::addFile(), Phar::addFromString() и Phar::offsetSet() сохраняет новый phar-архив каждый раз при их вызове. Если производительность вызывает беспокойство, вместо этого следует использовать Phar::buildFromDirectory() или Phar::buildFromIterator().
Смотрите также
- Phar::offsetSet() - Изменение содержимого файла
- PharData::addFromString() - Добавляет файл из строки в архив tar/zip
- Phar::addFile() - Добавляет в phar-архив файл из файловой системы
- Phar::addEmptyDir() - Добавляет в phar-архив пустую директорию
add a note
