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

# Phar::addFromString

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

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

### Описание

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

> Замечание: Для корректной работы метода с объектами Phar потребуется установить для директивы `phar.readonly` в файле php.ini значение `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-архив пустую директорию

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open