说明

用所给内容在上传文件夹中新建一个文件。

如果发生错误，错误信息中会出现关键字’key’。如果文件新建成功，则关键字’file’会被赋予唯一的文件路径，而’url’关键字则被赋予新文件的链接。’error’键值被设为false。

该函数不会将已经上传的文件再次上传到上传文件夹中。该函数会用$bits参数中的内容新建一个文件。如果用户移动上传文件，读取已上传文件中的内容，就可以将文件名和文件内容赋值给该函数，函数再将文件名和内容添加到上传文件夹。

该函数会自动设置新文件的访问权限。

用法

<?php wp_upload_bits( $name, $deprecated, $bits, $time ) ?>

参数

$name

（字符串）（必需）

默认值：None

$deprecated

（空）（必需）不再使用。设为空。

默认值：None

$bits

（混合）（必需）文件内容

默认值：None

$time

（字符串）（可选）’yyyy/mm’格式的时间

默认值：空

返回的值

该函数返回一个带有下列关键字的数组：

file

远程计算机上的文件路径（如C:example.txt）

url

本地服务器上已上传文件的路径（http://example.com/uploads/example.txt）

error

如果上传过程中出现错误，错误信息会存储在该关键字中。如果不出错，该关键字设为false。

示例

下面是一个简单的示例，假设一个表格发出请求，该表格中的字段被称为field1：

$upload = wp_upload_bits($_FILES["field1"]["name"], null, file_get_contents($_FILES["field1"]["tmp_name"]));  

函数试图保留已上传到上传目录（在WordPress设置中设定的上传目录）的文件的复本 。同时函数会进行安全检查（文件类型、大小等），如果发现错误，返回错误（参见上文返回的值）。文件上传完毕后，可删除tmp文件。

注释

历史记录

始见于2.0.0版本

源文件

wp_upload_bits位于 wp-includes/functions.php中。

相关资源

分类：中文手册