# pre_unzip_file

URL: https://chugunov.pro/api-wordpress/filters/pre_unzip_file/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-фильтр.
Появился в версии: 6.4.0.

## Сигнатура

```php
apply_filters( 'pre_unzip_file', null|true|WP_Error $result, string $file, string $to, string[] $needed_dirs, float $required_space )
```

## Описание

Фильтрует распаковку архива, позволяя переопределить её собственным процессом.

## Параметры

- `$result` `null|true|WP_Error` — обязательный. Результат переопределения. True при успехе, иначе WP Error. Значение по умолчанию — null.
- `$file` `string` — обязательный. Полный путь и имя файла ZIP-архива.
- `$to` `string` — обязательный. Полный путь в файловой системе, куда извлечь архив.
- `$needed_dirs` `string[]` — обязательный. Полный список необходимых папок, которые нужно создать.
- `$required_space` `float` — обязательный. Объём пространства, необходимый для распаковки файла и копирования его содержимого, с запасом в 10%.

## Фильтруемое значение

Результат переопределения. True при успехе, иначе WP Error. Значение по умолчанию — null.

## Исходный код

Файл: `wp-admin/includes/file.php:1786`

```php
$pre = apply_filters( 'pre_unzip_file', null, $file, $to, $needed_dirs, $required_space );
```

## История изменений

- 6.4.0 — Introduced.

## Связанные

Используется в: [`_unzip_file_ziparchive`](https://chugunov.pro/api-wordpress/functions/_unzip_file_ziparchive/), [`_unzip_file_pclzip`](https://chugunov.pro/api-wordpress/functions/_unzip_file_pclzip/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/pre_unzip_file/