Codex

Function Reference/wp check filetype and ext

Contents

Description

Attempts to determine the real file type of a file.
If unable to, the file name extension will be used to determine type. If it's determined that the extension does not match the file's real type, then the "proper_filename" value will be set with a proper filename and extension.

Usage

<?php
$validate = wp_check_filetype_and_ext( $file, $filename, $mimes );

if( $validate['proper_filename'] !== false )
    $filename = $validate['proper_filename'];
?>

Parameters

$file
(string) (required) Full path to the image.
Default: None
$filename
(string) (required) The filename of the image (may differ from $file due to $file being in a tmp directory)
Default: None
$mimes
(array) (null) optional
Default: None

Return Values

(array) 
Values for the extension, MIME, and either a corrected filename or false if original $filename is valid
  • ['ext'] - Extension (eg 'jpg')
  • ['type'] - Mime Type (eg 'image/jpeg')
  • ['proper_filename'] - (boolean) false or a string containing a proper file name if the original was invalid.

Examples

Notes

Currently this function only supports validating images known to getimagesize().

If using in a plugin/theme and you get an error about this function not being defined, you probably need to add require_once ABSPATH .'wp-admin/includes/file.php'; before the function gets called.

Change Log

Since: 3.0.0

Related

wp_check_filetype()

Source File

wp_check_filetype_and_ext() is located in wp-includes/functions.php

See also index of Function Reference and index of Template Tags.
This article is marked as in need of editing. You can help Codex by editing it.
Retrieved from "http://codex.wordpress.org/Function_Reference/wp_check_filetype_and_ext"

Codex Resources