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

Phar::addFromString

(PHP 5 >= 5.3.0, PHP 7, 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().

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

Phar::offsetSet() - Изменение содержимого файла
PharData::addFromString() - Создать файл с заданным содержимым в tar/zip-архиве
Phar::addFile() - Добавляет в phar-архив файл из файловой системы
Phar::addEmptyDir() - Добавляет в phar-архив пустую директорию