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()****
Примітки
Зауваження PharData::addFile() PharData::addFromString()andPharData::offsetSet()save a new phar archive each time they are called. If performance is a concern,PharData::buildFromDirectory()orPharData::buildFromIterator()should be used instead.
Дивіться також
- PharData::offsetSet() - Зміна вмісту файлу
- Phar::addFile() - Додає в phar-архів файл із файлової системи
- PharData::addFromString() - Додає файл з рядка до архіву tar/zip
- PharData::addEmptyDir() - Додати порожню директорію до tar/zip-архіву