# wp_handle_upload

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

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

## Сигнатура

```php
apply_filters( 'wp_handle_upload', array $upload, string $context )
```

## Описание

Фильтрует массив данных загруженного файла.

## Параметры

- `$upload` `array` — обязательный. Массив данных загрузки.
  
  file stringИмя только что загруженного файла.
  
  url stringURL только что загруженного файла.
  
  type stringMIME-тип только что загруженного файла.
- `$context` `string` — обязательный. Тип действия загрузки. Возможные значения: 'upload' или 'sideload'.

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

Массив данных загрузки.

file stringИмя только что загруженного файла.

url stringURL только что загруженного файла.

type stringMIME-тип только что загруженного файла.

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

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

```php
return apply_filters(
	'wp_handle_upload',
	array(
		'file' => $new_file,
		'url'  => $url,
		'type' => $type,
	),
	'wp_handle_sideload' === $action ? 'sideload' : 'upload'
);
```

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

- 2.1.0 — Introduced.

## Связанные

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

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