# upload_dir

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

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

## Сигнатура

```php
apply_filters( 'upload_dir', array $uploads )
```

## Описание

Фильтрует данные каталога загрузок.

## Параметры

- `$uploads` `array` — обязательный. Массив с информацией о каталоге загрузок.
  
  path stringБазовый каталог и подкаталог или полный путь к каталогу загрузок.
  
  url stringБазовый URL и подкаталог или абсолютный URL каталога загрузок.
  
  subdir stringПодкаталог, если включена опция размещения загрузок по папкам год/месяц.
  
  basedir stringПуть без подкаталога.
  
  baseurl stringURL-путь без подкаталога.
  
  error string|falseFalse или сообщение об ошибке.

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

Массив с информацией о каталоге загрузок.

path stringБазовый каталог и подкаталог или полный путь к каталогу загрузок.

url stringБазовый URL и подкаталог или абсолютный URL каталога загрузок.

subdir stringПодкаталог, если включена опция размещения загрузок по папкам год/месяц.

basedir stringПуть без подкаталога.

baseurl stringURL-путь без подкаталога.

error string|falseFalse или сообщение об ошибке.

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

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

```php
$uploads = apply_filters( 'upload_dir', $cache[ $key ] );
```

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

- 2.0.0 — Introduced.

## Связанные

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

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