云策 WordPress 开发者社区

钩子文档

wp_handle_upload

查看官方原文 ↗
💡 云策文档标注

概述

wp_handle_upload 是一个 WordPress 过滤器，用于修改上传文件的数据数组，包括文件路径、URL 和 MIME 类型。

关键要点

  • 过滤器名称：wp_handle_upload
  • 参数：$uploadarray（上传数据数组）、$context（上传操作类型，如 'upload' 或 'sideload'）
  • 返回数组包含 'file'、'url' 和 'type' 键
  • 相关函数：_wp_handle_upload() 和 wp_upload_bits()
  • 引入版本：2.1.0

代码示例

return apply_filters(
    'wp_handle_upload',
    array(
        'file' => $new_file,
        'url'  => $url,
        'type' => $type,
    ),
    'wp_handle_sideload' === $action ? 'sideload' : 'upload'
);
📄 原文内容

Filters the data array for the uploaded file.

Parameters

$uploadarray
Array of upload data.

  • file string
    Filename of the newly-uploaded file.
  • url string
    URL of the newly-uploaded file.
  • type string
    Mime type of the newly-uploaded file.

$contextstring
The type of upload action. Values include 'upload' or 'sideload'.

Source

return apply_filters(
	'wp_handle_upload',
	array(
		'file' => $new_file,
		'url'  => $url,
		'type' => $type,
	),
	'wp_handle_sideload' === $action ? 'sideload' : 'upload'
);

View all references View on Trac View on GitHub

Used by Description
_wp_handle_upload()wp-admin/includes/file.php

Handles PHP uploads in WordPress.
wp_upload_bits()wp-includes/functions.php

Creates a file in the upload folder with given content.

Changelog

Version Description
2.1.0 Introduced.