# pre_recurse_dirsize

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

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

## Сигнатура

```php
apply_filters( 'pre_recurse_dirsize', int|false $space_used, string $directory, string|string[]|null $exclude, int $max_execution_time, array $directory_cache )
```

## Описание

Верните фактический занятый объём, чтобы прервать рекурсивный расчёт размера файлов средствами PHP и использовать вместо него что-то другое, например API CDN или встроенные инструменты операционной системы для лучшей производительности.

## Параметры

- `$space_used` `int|false` — обязательный. Объём занятого пространства в байтах. Значение по умолчанию false.
- `$directory` `string` — обязательный. Полный путь к каталогу.
- `$exclude` `string|string[]|null` — обязательный. Полный путь к подкаталогу, исключаемому из общего подсчёта, или массив путей.
- `$max_execution_time` `int` — обязательный. Максимальное время выполнения до прекращения попытки. В секундах.
- `$directory_cache` `array` — обязательный. Массив кэшированных путей к каталогам.

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

Объём занятого пространства в байтах. Значение по умолчанию false.

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

Файл: `wp-includes/functions.php:8869`

```php
$size = apply_filters( 'pre_recurse_dirsize', false, $directory, $exclude, $max_execution_time, $directory_cache );
```

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

- 5.6.0 — Introduced.

## Связанные

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

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