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. |