_wp_handle_upload()的包装器。

原型

wp_handle_sideload( array $file, array|bool $overrides = false, string $time = null )

描述

传递’wp_handle_sideload’动作。

参考:

  • _wp_handle_upload()

参数

$file (array) (Required) 一个类似于PHP $ _FILES POST数组的数组

$overrides (array|bool) (Optional)  名称=>值的关联数组,以覆盖默认变量。

$time (string) (Optional)  时间格式为’yyyy / mm’。

返回值

(array)  成功时,返回文件属性的关联数组。失败时,返回$覆盖[‘upload_error_handler’](

源文件

路径:wp-admin/includes/file.php

<?php
...
function wp_handle_sideload( &$file, $overrides = false, $time = null ) {
	/*
	 *  $_POST['action'] must be set and its value must equal $overrides['action']
	 *  or this:
	 */
	$action = 'wp_handle_sideload';
	if ( isset( $overrides['action'] ) ) {
		$action = $overrides['action'];
	}
	return _wp_handle_upload( $file, $overrides, $time, $action );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_handle_sideload/