WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_check_filetype()

wp_check_filetype( string $filename, string[]|null $mimes = null ): array

In this article

Back to top

Retrieves the file type from the file name.

Description

You can optionally define the mime array, if needed.

Parameters

$filenamestringrequired
File name or path.
$mimesstring[]|nulloptional
Array of allowed mime types keyed by their file extension regex.
Defaults to the result of get_allowed_mime_types() .

Default:null

Return

array Values for the extension and mime type.
  • ext string|false
    File extension, or false if the file doesn’t match a mime type.
  • type string|false
    File mime type, or false if the file doesn’t match a mime type.

Source

function wp_check_filetype( $filename, $mimes = null ) {
	if ( empty( $mimes ) ) {
		$mimes = get_allowed_mime_types();
	}
	$type = false;
	$ext  = false;

	foreach ( $mimes as $ext_preg => $mime_match ) {
		$ext_preg = '!\.(' . $ext_preg . ')$!i';
		if ( preg_match( $ext_preg, $filename, $ext_matches ) ) {
			$type = $mime_match;
			$ext  = $ext_matches[1];
			break;
		}
	}

	return compact( 'ext', 'type' );
}

View all references View on Trac View on GitHub

UsesDescription
get_allowed_mime_types()wp-includes/functions.php

Retrieves the list of allowed mime types and file extensions.

Used byDescription
WP_Theme_JSON_Resolver::get_resolved_theme_uris()wp-includes/class-wp-theme-json-resolver.php

Resolves relative paths in theme.json styles to theme absolute paths and returns them in an array that can be embedded as the value of _link object in REST API responses.

WP_Customize_Manager::prepare_starter_content_attachments()wp-includes/class-wp-customize-manager.php

Prepares starter content attachments.

get_header_video_settings()wp-includes/theme.php

Retrieves header video settings.

wp_attachment_is()wp-includes/post.php

Verifies an attachment is of a given type.

sanitize_file_name()wp-includes/formatting.php

Sanitizes a filename, replacing whitespace with dashes.

wp_upload_bits()wp-includes/functions.php

Creates a file in the upload folder with given content.

wp_check_filetype_and_ext()wp-includes/functions.php

Attempts to determine the real file type of a file.

wp_unique_filename()wp-includes/functions.php

Gets a filename that is sanitized and unique for the given directory.

Show 3 moreShow less

Changelog

VersionDescription
2.0.4Introduced.

User Contributed Notes

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