PharData::extractTo
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::extractTo — Витягти вміст tar/zip-архіву в каталог
Опис
public PharData::extractTo(string $directory, array|string|null $files = null, bool $overwrite = false): bool
Витягує всі файли tar/zip-архіву на диск. Вилучені файли та директорії зберігають всі дозволи, які вони мали. Опціональні параметри дозволяють контролювати, які саме файли витягувати і чи потрібно перезаписувати існуючі. Другий параметр files може бути як ім'ям файлу, і шляхом директорії, які треба витягувати. За промовчанням файли, що вже існують на диску, перезаписуватися не будуть. Для вказівки, що потрібно перезаписати, використовується третій параметр. Цей метод аналогічний методу ZipArchive::extractTo()
Список параметрів
directory
Шлях, яким необхідно збережіть вилучені файли (files) .
files
Ім'я файлу чи директорії, які потрібно витягти. Або архів з іменами файлів/директорій
overwrite
Установите в**true**, якщо потрібно перезаписувати вже існуючі файли
Значення, що повертаються
Повертає true у разі успішного виконання. Але краще використовувати механізм перехоплення винятків контролю успішності.
Помилки
Викидає виняток PharExceptionв случае возникновения ошибки записи на диск.
Приклади
Приклад #1 Приклад використання PharData::extractTo()****
Примітки
Зауваження :
Файлові системи Windows NTFS не підтримують деякі символи в іменах файлів, зокрема
<|>*?":. Імена файлів із точкою в кінці також не підтримуються. На відміну від деяких інструментів вилучення, цей метод не підтримує заміну цих символів на підкреслення, а натомість виникає помилка при вийманні таких файлів.
Дивіться також
- Phar::extractTo() - Витягти вміст phar-архіву в директорію