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-архив пустую директорию