RarEntry::getStream
(PECL rar >= 2.0.0)
RarEntry::getStream — Отримати обробник для запису
Опис
public RarEntry::getStream(string $password = ?): resource|false
Повертає оброблювач, який підтримує операцію читання. Цей оброблювач вміє розпаковувати запис на льоту.
Обробник не знищується під час виклику rar_close()
Увага
Результуючий потік не перевіряється цілісність. Отже, ніяк не визначається псування файлу або розшифровка з невірним ключем. Перевірка контрольної суми розтисненого та розшифрованого файлу повністю на совісті розробника.
Список параметрів
password
Пароль, який використовується для шифрування запису. Якщо запис не шифрований, цей параметр ігнорується і в цілому може бути опущений. Якщо ж параметр опущений, а запис шифрований, буде використано пароль заданий у функції rar_open()якщо звичайно він був заданий. Якщо було встановлено неправильний пароль, явно чи неявно через rar_open(), цей метод поверне потік із невірними даними. Якщо пароль не заданий взагалі, а він потрібен, то метод поверне false. Зашифрований запис чи ні можна перевірити за допомогою RarEntry::isEncrypted()
Значення, що повертаються
Обработчик или**false**в случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| PECL rar 3.0.0 | Підтримка RAR-архівів з іменами записів, що дублюються, тепер працює нормально. |
Приклади
Приклад #1 Приклад використання RarEntry::getStream()****
Дивіться також
- RarEntry::extract() - Витягує елемент із архіву
- обгортка
rar://