PHP 8.3.4 Released!

Phar::addFromString

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

Phar::addFromStringДобавляет в phar-архив файл из строки

Описание

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

Замечание:

Для корректной работы с объектами 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().

Смотрите также

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top