常用接口
文件管理IO接口概述:
文件操作接口:
文件流地址获取:
IO::getStream($path)
方法,返回文件流地址。
注意事项
1.
2.
fopen
、file_get_contents
等;3.
如:index.php?mod=io&op=getStream&path=ODA3OXJyRkFsM3Q1ZzlGWXVRYXREWGhGOEQyOWpYcE9QK1hqL1c1WWhEOElPWVJ3ZmtrNm1EOA==
此处path的值为
dzzencode($path)
的值文件URI地址获取:
IO::getFileUri($path)
方法,返回文件地址。
注意事项
1.
2.
fopen
、file_get_contents
等;文件缩略图生成:
IO::getThumb($path, $width, $height, $original, $returnurl, $thumbtype)
方法,返回缩略图或缩略图路径。
注意事项
1.
2.
3.
其中path的值为
dzzencode($path)
的值;文件信息获取:
IO::getMeta($path)
方法,返回文件信息数组,包括文件名称、大小、类型等。
返回主要参数说明
vid:版本id
oid:如果是目录为对应目录id,如果是远程资源或链接为对应资源id否则为0
uid:用户id
username:用户名
pfid:文件父级目录id
gid:群组机构或部门归属id,如果文件在我的网盘则为0
name:文件名称
type:文件类型
dateline:文件创建时间
ext:文件拓展名
size:文件大小
sperm:文件超级权限
isdelete:文件是否已删除,1已删除,0未删除
deldateline:删除时间
flag:文件标识,文件夹为folder,群组机构部门为organization
path:文件唯一标识
title:附件名称
desc:排序方式
aid:文件附件id
img:文件图标链接
filename:文件属性记录名称
filetype:文件属性记录类型
filesize:文件属性记录大小
attachment:文件附件地址(相对于网盘系统)
remote:文件存储位置标识值
copys:文件附件使用次数
md5:文件md5值
thumb:缩略图
unrun:生成缩略图是主动模式还是被动模式
olddateline:文件初次上传时间
url:文件缩略图地址(网盘系统路径)
ftype:文件格式化网盘显示类型
fdateline:文件格式化创建时间
fsize:文件格式化大小按最大单位记
ffsize:文件格式化大小,包含文件原大小数据
relativepath:文件相对路径(网盘系统记录路径)
relpath:文件相对于网盘真实路径
bz:文件存储API标识符
preview:文件是否是以分享的方式访问
collect:是否收藏(true已收藏,false未收藏)
dpath:网盘加密唯一标识
apath:网盘加密附件路径
示例
Array ( [rid] => 1a3afce9b6edede64ec89bd2367dd25f [vid] => 0 [oid] => 0 [uid] => 1 [username] => admin [pfid] => 2 [gid] => 0 [name] => 新建白板1.edraw [type] => attach [dateline] => 1720692876 [ext] => edraw [size] => 1161 [sperm] => 0 [isdelete] => 0 [deldateline] => 0 [flag] => [path] => 1a3afce9b6edede64ec89bd2367dd25f [title] => 新建白板1.edraw [desc] => [aid] => 284 [img] => dzz/images/extimg/unknow.png [filename] => 新建白板1.edraw [filetype] => edraw [filesize] => 1161 [attachment] => dzz/202407/11/181436iliydwaz80kdbk60.edraw [remote] => 0 [copys] => 1 [md5] => 414a021238b2e4f95c4fc7da995d833a [thumb] => 0 [unrun] => 0 [olddateline] => 1720692876 [url] => index.php?mod=io&op=getStream&path=eUZMMU5nTjdLZWdiSVJfS3Y5LTY0aGVTalJWcS1GZXdubEJKRDlKdWVFaEhPSkY3Vnc [ftype] => EDRAW 文件 [fdateline] => 2024-07-11 18:14:36 [fsize] => 1.13 KB [ffsize] => 1.13 KB (1161 字节) [relativepath] => dzz:uid_1:我的网盘/新建白板1.edraw [relpath] => 我的网盘/ [bz] => [preview] =>[collect] => [dpath] => eUZMMU5nTjdLZWdiSVJETzdvbTI1RUNiamtRNnF3WGx6Z1laR3BWdWZVTVlPOEYxQnF6NGFpVTVzQmJadTFxYWZDSjQ4OFNRczd4QklR [apath] => eUZMMU5nTjdLZWdiSVJfS3Y5LTY0aGVTalJWcS1GZXdubEJKRDlKdWVFaEhPSkY3Vnc )
文件内容获取:
IO::getFileContent($path)
方法,返回文件内容。
创建目录
IO::CreateFolder($path, $fname, $perm, $params, $ondup)
方法,返回目录信息数组。
注意事项
$path
如果为空或为0时,将自动创建该目录为顶级目录$params
参数包含目录创建默认项设置的控制(即folder表固有项),也可自定义目录属性信息(即不包含在folder表的相关项,将在folder_attr表存储)。设置文件内容
IO::setFileContent($path, $fileContent, $force, $nocover)
方法,返回文件信息数组。
注意事项
当为本地存储时:
如果
$nocover
参数为true
,即不覆盖保存时,默认保存当前内容为新版本。逻辑处理如下:1.若系统版本数已达到上限,即系统版本数量设置数(包含不开启版本和版本数量达到或超出版本数限制),该操作将移除当前操作文件最老版本,并保存当前内容为最新版本(如未开启版本,等同覆盖当前文件);
2.若版本数未达到系统版本数设置上限,包含版本开启并且版本数设置为0(即不限制版本数量),或当前文件版本小于最大版本数,该操作将保存当前内容为操作文件最新版本。
如果
$nocover
参数为false
,执行覆盖保存,有版本时将自动覆盖文件最新版本内容,无版本时直接覆盖当前文件内容。下载文件内容
IO::download($path, $filename)
方法,保存文件到指定名称。
注意事项
1.
$path
的类型为目录时,会将整个目录打包成zip下载;2.
文件删除
IO::Delete($path, $force)
方法,返回包含文件名和文件icoid的数组。
文件重命名
IO::rename($path, $text)
方法,返回文件相关信息数组。
文件拷贝
IO::CopyTo($opath, $path, $iscopy)
方法,返回文件相关信息数组。
注意事项
1.
2.
(1)如果为复制
a.如果复制文件源文件位置与目标位置相同,生成副本,否则新建
b.如果复制文件在目标位置有同名文件,生成副本,否则新建
c.如果复制文件为目录,且目标位置有同名目录,且源文件位置不与目标位置相同,则将源文件目录中文件放入目标位置同名目录中,否则新建
(2)如果为剪切
a.如果复制文件有重名,则生成新的文件名创建,否则,直接创建,并删除源文件
b.如果复制文件为目录,且目标位置有同名目录,则移动源文件目录其下文件至目标位置下同名目录,否则则创建
上传文件
IO::upload($fileContent, $path, $filename)
方法,上传文件到指定位置。
过滤文件名
IO::name_filter($name)
方法,返回过滤后的文件名字符串。
注意事项
修改于 2025-03-14 09:36:07