RarEntry::extract
(PECL rar >= 0.1)
RarEntry::extract — Витягує елемент з архіву
Опис
public RarEntry::extract( string $dir, string $filepath = "", string $password = NULL, bool $extended_data = false): bool
RarEntry::extract() витягує вміст елемента. При цьому створюється новий файл у зазначеній директорії dir з ім'ям, що збігається з ім'ям елемента, якщо тільки не заданий другий аргумент. Дивіться нижче.
Список параметрів
dir
Шлях до директорії, куди потрібно витягти файли. Цей параметр враховується лише якщо не вказано filepath. Якщо обидва параметри не вказані, файли витягуються до поточної директорії.
filepath
Шлях (повний або відносний) містить директорію та ім'я файлу, що видобувається. Цей параметр перевизначає параметр dir та оригінальне ім'я файлу.
password
Пароль використовується для шифрування поточного елемента. Якщо елемент не зашифрований, цей параметр не буде використаний і його можна не вказувати. Якщо цей параметр не вказано, а елемент зашифрований, то буде використаний пароль, переданий функції rar_open(), Якщо її викликали. Якщо передано невірний пароль, явно чи неявно через rar_open(), то перевірка CRC буде невдалою і буде повернуто false. Ви можете перевірити, чи є елемент зашифрованим за допомогою RarEntry::isEncrypted()
extended_data
Якщо true, то до файлу буде додано додаткову інформацію, таку як NTFS ACL і власник у системі Unix, якщо вони були присутні в архіві.
Увага
До версії 2.0.0 не обробляла відносні шляхи коректно. Використовуйте для цієї ситуації realpath()
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| PECL rar 3.0.0 | Було додано параметр extended_data |
| PECL rar 3.0.0 | Виправлена підтримка RAR архівів з іменами елементів, що повторюються. |
Приклади
Приклад #1 Приклад використання RarEntry::extract()****
Приклад #2 Як отримати всі файли з архіву:
Дивіться також
- RarEntry::getStream() - Отримати обробник для запису
rar://wrapper