PHP 7.4.0RC4 Released!

PharData::extractTo

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

PharData::extractToИзвлечь содержимое tar/zip-архива в директорию

Описание

PharData::extractTo ( string $pathto [, string|array $files [, bool $overwrite = FALSE ]] ) : bool

Извлекает все файлы tar/zip-архива на диск. Извлеченные файлы и директории сохраняют все разрешения, которые у них были. Опциональные параметры позволяют контролировать, какие именно файлы извлекать и нужно ли перезаписывать уже существующие. Второй параметр files может быть как именем файла, так и путем директории, которые надо извлекать. По умолчанию уже существующие на диске файлы перезаписываться не будут. Для указания, что нужно использовать перезапись, используется третий параметр. Этот метод аналогичен методу ZipArchive::extractTo().

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

pathto

Путь, по которому необходимо сохраните извлеченные файлы (files)

files

Имя файла или директории, которые надо извлечь. Либо архив с именами файлов/директорий

overwrite

Установите в TRUE, если необходимо перезаписывать уже существующие файлы

Возвращаемые значения

Возвращает TRUE в случае успешного выполнения. Но лучше использовать механизм перехвата исключений для контроля успешности.

Ошибки

Выбрасывает исключение PharException в случае ошибки записи на диск.

Примеры

Пример #1 Пример использования PharData::extractTo()

<?php
try {
    
$phar = new PharData('myphar.tar');
    
$phar->extractTo('/full/path'); // извлечь все файлы
    
$phar->extractTo('/another/path''file.txt'); // извлечь только file.txt
    
$phar->extractTo('/this/path',
        array(
'file1.txt''file2.txt')); // извлечь два указанных файла
    
$phar->extractTo('/third/path'nulltrue); // извлечь все файлы, использовать перезапись
} catch (Exception $e) {
    
// обработка ошибок
}
?>

Смотрите также

  • Phar::extractTo() - Извлечь содержимое phar-архива в директорию

add a note add a note

User Contributed Notes 2 notes

up
2
Anonymous
2 years ago
I'm unable to extract the first directory from a tar archive:
the destination dir remains empty,
no error is thrown

<?php
$tar
= new \PharData('archive.tar');
if (
$tar->current()->isDir()) {
                echo
'is_dir';
               
$dir = $tar->current()->getPathname();
               
$dir = basename($dir);
               
$tar->extractTo('destination', $dir);
}
?>

the docs hint that the second param could be a name of file OR DIR to be extracted from the archive, is that really possible?
up
0
njh at aelius dot com
6 years ago
Note that PHAR only supports extracting the 'ustar' variant of the tar archives.

Some systems (such as older versions of Mac OS X) generate the 'pax' format by default.

See here for more information:
http://php.net/manual/pl/phar.fileformat.tar.php
To Top