array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'phardata.addfile.php', 1 => 'PharData::addFile', 2 => 'Добавить существующие файлы к tar/zip-архиву', ), 'up' => array ( 0 => 'class.phardata.php', 1 => 'PharData', ), 'prev' => array ( 0 => 'phardata.addemptydir.php', 1 => 'PharData::addEmptyDir', ), 'next' => array ( 0 => 'phardata.addfromstring.php', 1 => 'PharData::addFromString', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/phar/PharData/addFile.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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.

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