说明
用所给内容在上传文件夹中新建一个文件。
如果发生错误,错误信息中会出现关键字'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中。
相关资源
分类:中文手册