On this page
_wp_check_existing_file_names( string $filename, array $files ): bool
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.
Helper function to check if a file name could match an existing image sub-size file name.
Parameters
$filenamestring Required-
The file name to check.
$filesarray 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. View all references
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;
}
Related
Used By
| Used By | Description |
|---|---|
| _wp_check_alternate_file_names() wp-includes/functions.php | Helper function to test if each of an array of file names could conflict with existing files. |
| wp_unique_filename() wp-includes/functions.php | Gets a filename that is sanitized and unique for the given directory. |
Changelog
| Version | Description |
|---|---|
| 5.3.1 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_wp_check_existing_file_names