A WordPress-centric search engine for devs and theme authors



wp_handle_upload ›

Since2.0.0
Deprecatedn/a
wp_handle_upload ( $file, $overrides = false, $time = null )
Parameters: (3)
  • (array) $file Reference to a single element of `$_FILES`. Call the function once for each uploaded file.
    Required: Yes
  • (array|bool) $overrides Optional. An associative array of names=>values to override default variables. Default false.
    Required: No
    Default: false
  • (string) $time Optional. Time formatted in 'yyyy/mm'. Default null.
    Required: No
    Default: null
See:
Returns:
  • (array) On success, returns an associative array of file attributes. On failure, returns $overrides['upload_error_handler'](&$file, $message ) or array( 'error'=>$message ).
Defined at:
Codex:

Wrapper for _wp_handle_upload().

Passes the {@see 'wp_handle_upload'} action.



Source

function wp_handle_upload( &$file, $overrides = false, $time = null ) {
	/*
	 *  $_POST['action'] must be set and its value must equal $overrides['action']
	 *  or this:
	 */
	$action = 'wp_handle_upload';
	if ( isset( $overrides['action'] ) ) {
		$action = $overrides['action'];
	}

	return _wp_handle_upload( $file, $overrides, $time, $action );
}