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