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