Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.
_wp_check_existing_file_names() WordPress Function
The wp_check_existing_file_names() function is used to check whether a given file name already exists in the WordPress media library. If the file name already exists, the function will generate a new, unique file name for the file.
_wp_check_existing_file_names( string $filename, array $files ) #
Helper function to check if a file name could match an existing image sub-size file name.
Parameters
- $filename
(string)(Required)The file name to check.
- $files
(array)(Required)An array of existing files in the directory.
Return
(bool) True if the tested file name could match an existing file, false otherwise.
Source
File: wp-includes/functions.php
function _wp_check_existing_file_names( $filename, $files ) {
$fname = pathinfo( $filename, PATHINFO_FILENAME );
$ext = pathinfo( $filename, PATHINFO_EXTENSION );
// Edge case, file names like `.ext`.
if ( empty( $fname ) ) {
return false;
}
if ( $ext ) {
$ext = ".$ext";
}
$regex = '/^' . preg_quote( $fname ) . '-(?:\d+x\d+|scaled|rotated)' . preg_quote( $ext ) . '$/i';
foreach ( $files as $file ) {
if ( preg_match( $regex, $file ) ) {
return true;
}
}
return false;
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 5.3.1 | Introduced. |