首页    >    中文手册    >   常用函数-wp_upload_bits()

常用函数-wp_upload_bits()

说明

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

如果发生错误,错误信息中会出现关键字'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中。

相关资源

分类:中文手册

* 版权声明:作者WordPress啦! 转载请注明出处。