PharData::convertToData
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::convertToData — Конвертація phar-архіву в tar/zip-архів, що не запускається.
Опис
public PharData::convertToData(?int $format = null, ?int $compression = null, ?string $extension = null): ?PharData
Цей метод використовується для перетворення tar/zip-архіву, що не запускається, в інший формат, що не запускається.
Якщо не вказано жодних змін, то буде викинуто виняток BadMethodCallException. Цей метод можна використовувати для перетворення tar-архіву на zip-архів і навпаки. Незважаючи на те, що можна змінити стиск для tar-архіву за допомогою цього методу, для цих цілей краще використовувати метод PharData::compress()
У разі успішного виконання буде створено новий архів на диску та повернуто об'єкт PharData. Старий архів не видалятиметься.
Список параметрів
format
Одна из констант:Phar::TARилиPhar::ZIP. Якщо поставити як null, то буде використано поточний формат.
compression
Одна из констант:Phar::NONE (Для відключення стиснення всього архіву), Phar::GZ(для zlib-сжатия),Phar::BZ2(для bzip-сжатия).
extension
Цей параметр використовується для явної вказівки на розширення нового архіву. Зверніть увагу, що для архівів, що не запускаються, в жодному разі не можна допускати появу підрядка. .pharв любом месте имени файла.
По умолчанию для tar-архивов используются расширения:.tar .tar.gzи.tar.bz2. Для zip-архівів: .zip
Значення, що повертаються
Метод повертає об'єкт PharDataили**null**в случае возникновения ошибки.
Помилки
Метод викидає виняток BadMethodCallException коли не може зробити стискування, коли заданий невідомий метод стиснення, для архіву включена буферизація за допомогою Phar::startBuffering(), та не відключена за допомогою Phar::stopBuffering()ИсключениеPharException викидається за будь-яких проблем створення phar-архіву.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | formatcompressionиextension тепер допускають значення null. |
Приклади
Приклад #1 Приклад використання PharData::convertToData()****
Використання PharData::convertToData():
Дивіться також
- Phar::convertToExecutable() - Конвертує phar-архів в інший формат файлу, що виконується.
- Phar::convertToData() - Конвертує phar-архів в tar-або zip-файл, що не виконується.
- PharData::convertToExecutable() - Конвертація tar/zip-архіву з даними в phar-архів, що запускається