Phar::addFile
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::addFile — Додає в phar-архів файл із файлової системи
Опис
public Phar::addFile(string $filename, ?string $localName = null): void
Зауваження :
Для коректної роботи з об'єктами Phar цьому методу необхідне встановлення значення php.ini
phar.readonlyв . В іншому випадку, буде викинуто виняток PharException
За допомогою цього методу phar-архів може бути доданий будь-який файл або вміст, доступний по URL. Якщо вказано необов'язковий другий параметр localName, то файл буде збережений в архіві з таким ім'ям, в іншому випадку як шлях для збереження всередині архіву буде використано параметр fileПри добавлении содержимого, доступного по URL, параметрlocalname має бути зазначено, інакше буде викинуто виняток. Цей метод аналогічний ZipArchive::addFile()
Список параметрів
filename
Повний або відносний шлях до файлу у файловій системі, який має бути доданий до phar-архіву.
localName
Шлях, яким файл буде збережено в архіві.
Значення, що повертаються
Немає значення, що повертається, у разі виникнення помилки викидається виняток.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | localName тепер допускає значення null. |
Приклади
Приклад #1 Приклад використання Phar::addFile()****
Примітки
Зауваження Phar::addFile() Phar::addFromString() і Phar::offsetSet() зберігає новий phar-архів щоразу під час їхнього виклику. Якщо продуктивність викликає занепокоєння, натомість слід використовувати Phar::buildFromDirectory() або Phar::buildFromIterator()
Дивіться також
- Phar::offsetSet() - Зміна вмісту файлу
- PharData::addFile() - Додати існуючі файли до tar/zip-архіву
- Phar::addFromString() - Додає в phar-архів файл із рядка
- Phar::addEmptyDir() - Додає в phar-архів порожню директорію