WordPress 处理图片和文件上传函数—— media_handle_upload

在程序开发中，处理上传文件是一个麻烦事，在 WordPress中，不是这样的，WordPress为我们提供了处理上传图片的函数：media_handle_upload，我们只需要把参数传给这个函数，上传的图片或文件就自动保存在服务器上并插入媒体库中了。下面我们来看以下这个函数怎么用的。
media_handle_upload参数
参数类型必要性默认值描述$file_idstring必需–PHP $_FILES 超级变量的索引$post_idint可选0图片关联到的文章 ID$post_dataarray可选null允许修改附件的一些信息$overridesarray可选[]允许覆盖 wp_handle_upload() 的表现返回值：
(int|WP_Error)
如果成功，返回附件 ID，如果失败，返回一个 WP_Error 实例
示例：
前端表单

处理上传的文件

// 检查 nonce 和用户权限
if ( 
	isset( $_POST['my_image_upload_nonce'], $_POST['post_id'] ) 
	&& wp_verify_nonce( $_POST['my_image_upload_nonce'], 'my_image_upload' )
	&& current_user_can( 'edit_post', $_POST['post_id'] )
) {
	// 如果通过检查，安全性是没问题的

	// 在前端使用时，需要引入以下3个文件
	require_once( ABSPATH . 'wp-admin/includes/image.php' );
	require_once( ABSPATH . 'wp-admin/includes/file.php' );
	require_once( ABSPATH . 'wp-admin/includes/media.php' );
	
	// 让WordPress处理上传的文件
	// 注意, 'my_image_upload' 是上面表单里的文件字段的name
	$attachment_id = media_handle_upload( 'my_image_upload', $_POST['post_id'] );
	
	if ( is_wp_error( $attachment_id ) ) {
		// 上传出错时的处理
	} else {
		// 上传成功后的处理
	}

} else {

	// nounxe检查失败时的提示信息
}