apply_filters( ‘wp_unique_filename’, string $filename, string $ext, string $dir, callable|null $unique_filename_callback, string[] $alt_filenames, int|string $number )

In this article

Filters the result when generating a unique file name.

Parameters

$filenamestring
Unique file name.
$extstring
File extension. Example: ".png".
$dirstring
Directory path.
$unique_filename_callbackcallable|null
Callback function that generates the unique file name.
$alt_filenamesstring[]
Array of alternate file names that were checked for collisions.
$numberint|string
The highest number that was used to make the file name unique or an empty string if unused.

Source

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

Changelog

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

User Contributed Notes

You must log in before being able to contribute a note or feedback.