ZipArchive::extractTo

(PHP 5 >= 5.2.0, PHP 7, PHP 8, PECL zip >= 1.1.0)

ZipArchive::extractTo — Extract the archive contents

Опис

public ZipArchive::extractTo(string $pathto, array|string|null $files = null): bool

Extract the complete archive or the given files to the specified destination.

Увага

The default permissions for extracted files and directories give the widest possible access. This can be restricted by setting the current umask, which can be changed using umask().

For security reasons, the original permissions are not restored. For an example of how to restore them, see the code sample on the ZipArchive::getExternalAttributesIndex() page.

Параметри

pathto: Location where to extract the files.
files: The entries to extract. It accepts either a single entry name or an array of names.

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

Повертає true у разі успіху або false в разі помилки.

Приклади

Приклад #1 Extract all entries

<?php
$zip = new ZipArchive;
if ($zip->open('test.zip') === TRUE) {
    $zip->extractTo('/my/destination/dir/');
    $zip->close();
    echo 'ok';
} else {
    echo 'failed';
}
?>

Приклад #2 Extract two entries

<?php
$zip = new ZipArchive;
$res = $zip->open('test_im.zip');
if ($res === TRUE) {
    $zip->extractTo('/my/destination/dir/', array('pear_item.gif', 'testfromfile.php'));
    $zip->close();
    echo 'ok';
} else {
    echo 'failed';
}
?>

Примітки

Зауваження:
Файлові системи Windows NTFS не підтримують використання деяких символів у назвах файлів, а саме <|>*?":. Не підтримуються також назви файлів з крапкою в кінці. На відміну від деяких інструментів розпакування, цей метод не замінює ці символи на підкреслення, а натомість не витягує такі файли.