« Phar::\_\_constructPhar::convertToExecutable »PHP ManualPhar

Phar::convertToData

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::convertToData — Конвертує phar-архів у tar-або zip-файл, що не виконується.

Опис

public Phar::convertToData(?int $format = null, ?int $compression = null, ?string $extension = null): ?PharData

Цей метод використовується для конвертування phar-архів у tar- або zip-файл. Щоб створити зробити tar або zip нездійсненним, з створюваного в результаті конвертації архіву видаляються завантаження та псевдонім phar-архіву.

Якщо не було вказано жодних змін, то даний метод викине виняток BadMethodCallExceptionякщо формат файлу архіву є phar. У разі використання з архівами у форматі tar або zip, цей метод конвертує архів у архів, що не виконується.

У разі успішного виконання цей метод створює на диску новий архів та повертає об'єкт PharData. Старий архів не видаляється з диска, це має бути зроблено вручну після завершення процесу.

Список параметрів

format

Значенням цього параметра має бути одна з констант: Phar::TARилиPhar::ZIPЕсли значение установлено в**null**, то існуючий формат файлу буде збережено.

compression

Значенням цього параметра має бути одна з констант: Phar::NONE для відсутності стиску всього архіву, Phar::GZдля сжатия, основанного на zlib, илиPhar::BZ2для bzip-сжатия.

extension

Цей параметр використовується для перевизначення розширення файлу за промовчанням для конвертованого архіву. Зверніть увагу, що .phar не може бути використано будь-де в імені файлу невиконуваного tar- або zip-архіву.

У разі конвертації phar-архіву, заснованого на tar, розширеннями за умовчанням є: .tar .tar.gzи.tar.bz2, Залежно від зазначеного стиснення. Для архівів, що базуються на zip, розширенням за умовчанням є .zip

Значення, що повертаються

Цей метод повертає об'єкт PharData у разі успішного виконання та **null**в случае возникновения ошибки.

Помилки

Цей метод викидає виняток BadMethodCallException у таких випадках: при неможливості стиснення; якщо було передано невідомий алгоритм стиснення; у запитаному архіві було включено буферизацію за допомогою Phar::startBuffering() і не була завершена за допомогою Phar::stopBuffering(). У разі виникнення будь-яких проблем у процесі створення phar буде викинуто виняток PharException

список змін

ВерсияОпис
8.0.0formatcompressionиextension тепер допускають значення null.

Приклади

Приклад #1 Приклад використання Phar::convertToData()****

Використання Phar::convertToData():

Loading...

Дивіться також