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

Filters the result when generating a unique file name.


$filename string
Unique file name.
$ext string
File extension. Example: ".png".
$dir string
Directory path.
$unique_filename_callback callable|null
Callback function that generates the unique file name.
$alt_filenames string[]
Array of alternate file names that were checked for collisions.
$number int|string
The highest number that was used to make the file name unique or an empty string if unused.

Top ↑


File: wp-includes/functions.php. View all references

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

Top ↑


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

Top ↑

User Contributed Notes

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