PharData::addFile

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

PharData::addFile — Добавить существующие файлы к tar/zip-архиву

Описание

public function PharData::addFile(string $filename, ?string $localName = null): void

С помощью этого метода можно добавить к архиву любые файлы или URL. Если задан опциональный параметр localname, то файл будет добавлен в архив с указанным именем, иначе будет использовано оригинальное имя из параметра file. Для URL локальное имя должно быть указано в обязательном порядке, иначе будет выброшено исключение. Метод аналогичен ZipArchive::addFile().

Список параметров

filename: Полный или относительный путь до файла на диске.
localName: Путь, по которому файл необходимо добавить в архив.

Возвращаемые значения

Ничего не возвращает, а в случае возникновения ошибки выбрасывает исключение.

Список изменений

Версия	Описание
8.0.0	`localName` теперь допускает значение null.

Примеры

Пример #1 Пример использования PharData::addFile()

<?php
try {
    $a = new PharData('/path/to/my.tar');

    $a->addFile('/full/path/to/file');
    // добавление файла
    $b = $a['full/path/to/file']->getContent();

    $a->addFile('/full/path/to/file', 'my/file.txt');
    $c = $a['my/file.txt']->getContent();

    // добавление URL
    $a->addFile('http://www.example.com', 'example.html');
} catch (Exception $e) {
    // обработка ошибок
}
?>

Примечания

Замечание: PharData::addFile(), PharData::addFromString() and PharData::offsetSet() save a new phar archive each time they are called. If performance is a concern, PharData::buildFromDirectory() or PharData::buildFromIterator() should be used instead.

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

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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы