(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::decompressFiles — Распаковывает все файлы в текущем Phar-архиве
Замечание:
Для корректной работы с объектами Phar этому методу необходима установка значения php.ini
phar.readonly
в0
. В противном случае, будет выброшено исключение PharException.
При работе с phar-архивами на основе формата tar метод выбрасывает исключение BadMethodCallException, поскольку сжатие отдельных файлов внутри tar-архива не поддерживается форматом файла. Для сжатия целого phar-архива на основе формата tar пользуются методом Phar::compress().
При работе с phar-архивами на основе форматов zip или phar метод распаковывает все файлы в Phar-архиве. Для распаковки файлов этим методом потребуется включить модуль zlib или bzip2, если файлы внутри архива сжали методом bzip2 или zlib. Как и в случае с другим функционалом, который модифицирует содержание phar-архива, для успешной работы метода потребуется отключить INI-переменную phar.readonly.
У этой функции нет параметров.
Функция возвращает логическое значение true
.
Метод выбрасывает исключение BadMethodCallException, если INI-переменная phar.readonly включена, модуль zlib недоступен или если файлы внутри архива сжали методом bzip2, а модуль bzip2 отключён.
Пример #1 Пример распаковки phar-архива методом Phar::decompressFiles()
<?php
$p = new Phar('/путь/к/my.phar', 0, 'my.phar');
$p['myfile.txt'] = 'привет';
$p['myfile2.txt'] = 'привет';
$p->compressFiles(Phar::GZ);
foreach ($p as $file) {
var_dump($file->getFileName());
var_dump($file->isCompressed());
var_dump($file->isCompressed(Phar::BZ2));
var_dump($file->isCompressed(Phar::GZ));
}
$p->decompressFiles();
foreach ($p as $file) {
var_dump($file->getFileName());
var_dump($file->isCompressed());
var_dump($file->isCompressed(Phar::BZ2));
var_dump($file->isCompressed(Phar::GZ));
}
?>
Результат выполнения приведённого примера:
string(10) "myfile.txt" int(4096) bool(false) bool(true) string(11) "myfile2.txt" int(4096) bool(false) bool(true) string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false)