CakeFest 2024: The Official CakePHP Conference

PharData::addFile

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

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

Описание

public 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.

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

add a note

User Contributed Notes

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