Phar::extractTo

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

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

Описание

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

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

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

pathto

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

files

Имя файла или директории, которые надо извлечь или архив с именами файлов/директорий. NULL для пропуска этого параметра.

overwrite

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

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

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

Ошибки

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

Примеры

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

<?php
try {
    
$phar = new Phar('myphar.phar');
    
$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) {
    
// handle errors
}
?>

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

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