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.


Top ↑

Return

(bool) True if the tested file name could match an existing file, false otherwise.


Top ↑

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;
}


Top ↑

Changelog

Changelog
VersionDescription
5.3.1Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More