(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::decompress — Распаковывает весь Phar-архив
Замечание:
Для корректной работы с объектами Phar этому методу необходима установка значения php.ini
phar.readonly
в0
. В противном случае, будет выброшено исключение PharException.
В случае с phar-архивами, основанными на tar или phar, этот метод распаковывает весь архив.
В случае с phar-архивами, основанными на zip, вызов данного метода потерпит неудачу и будет брошено исключение. Для распаковки архива, сжатого по алгоритму gzip, должен быть включён модуль zlib; для распаковки архива, сжатого по алгоритму bzip2, должен быть включён модуль bzip2. Как и в случае с другим функционалом, модифицирующим содержание phar-архива, для успешной работы данного метода необходимо, чтобы INI-переменная phar.readonly была отключена.
Кроме того, этот метод автоматически меняет расширения файла архива: по умолчанию
.phar
для phar-архивов и .phar.tar
для phar-архивов,
основанных на tar. В качестве альтернативы расширение файла может быть задано
с помощью второго параметра.
extension
Расширениями распакованного файла по умолчанию являются .phar
и .phar.tar
. Этот параметр может быть использован для задания
другого расширения распакованного файла. Имейте в виду, что все исполняемые phar-архивы
должны содержать .phar
в имени файла.
Возвращает объект Phar в случае успешного выполнения и null
в случае возникновения ошибки.
Выбрасывает исключение BadMethodCallException, если INI-переменная phar.readonly включена, модуль zlib не доступен или модуль bzip2 не включён.
Версия | Описание |
---|---|
8.0.0 |
extension теперь допускает значение null.
|
Пример #1 Пример использования Phar::decompress()
<?php
$p = new Phar('/путь/к/my.phar', 0, 'my.phar.gz');
$p['myfile.txt'] = 'привет';
$p['myfile2.txt'] = 'привет';
$p3 = $p2->decompress(); // создаст /путь/к/my.phar
?>