# {$action}_prefilter

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

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

## Сигнатура

```php
apply_filters( "{$action}_prefilter", array $file )
```

## Описание

Динамическая часть имени хука, $action, указывает на действие с записью.
Возможные имена хуков:

wp_handle_sideload_prefilter

wp_handle_upload_prefilter

## Динамические части имени

- `{$action}` — Динамическая часть имени хука, $action, указывает на действие с записью.

## Параметры

- `$file` `array` — обязательный. Ссылка на отдельный элемент из $_FILES.
  
  name string Исходное имя файла на клиентской машине.
  
  type string MIME-тип файла, если браузер предоставил эту информацию.
  
  tmp_name string Временное имя файла, под которым загруженный файл был сохранён на сервере.
  
  size int Размер загруженного файла в байтах.
  
  error int Код ошибки, связанный с этой загрузкой файла.

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

Ссылка на отдельный элемент из $_FILES.

name string Исходное имя файла на клиентской машине.

type string MIME-тип файла, если браузер предоставил эту информацию.

tmp_name string Временное имя файла, под которым загруженный файл был сохранён на сервере.

size int Размер загруженного файла в байтах.

error int Код ошибки, связанный с этой загрузкой файла.

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

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

```php
$file = apply_filters( "{$action}_prefilter", $file );
```

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

- 4.0.0 — Converted to a dynamic hook with $action.
- 2.9.0 — Introduced.

## Связанные

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

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