# wp_unique_filename

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

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

## Сигнатура

```php
apply_filters( 'wp_unique_filename', string $filename, string $ext, string $dir, callable|null $unique_filename_callback, string[] $alt_filenames, int|string $number )
```

## Описание

Фильтрует результат при генерации уникального имени файла.

## Параметры

- `$filename` `string` — обязательный. Уникальное имя файла.
- `$ext` `string` — обязательный. Расширение файла. Пример: ".png".
- `$dir` `string` — обязательный. Путь к каталогу.
- `$unique_filename_callback` `callable|null` — обязательный. Функция обратного вызова, генерирующая уникальное имя файла.
- `$alt_filenames` `string[]` — обязательный. Массив альтернативных имён файлов, проверенных на конфликты.
- `$number` `int|string` — обязательный. Наибольшее число, использованное для придания имени файла уникальности, или пустая строка, если оно не использовалось.

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

Уникальное имя файла.

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

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

```php
return apply_filters( 'wp_unique_filename', $filename, $ext, $dir, $unique_filename_callback, $alt_filenames, $number );
```

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

- 5.8.1 — The $alt_filenames and $number parameters were added.
- 4.5.0 — Introduced.

## Связанные

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

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