基于tp5的对象存储系统。
目标做成成熟的oss系统,支持分布式.
当前只做了file模块,能够操作本地文件(还不是oss,只是顶多算web_file_system,能通过http接口操作文件)
todo增加搜索,图片预览,根据格式列举,远程解压,流视频等功能,做重命名功能;
使用搭建tp5网站,确保使用web站点,能隐藏index.php;
注意克隆项目之后composerinstall;
应用目录下config有个配置access_key,访问必须带这个参数且一直才能访问文件上传:https://oss.com/upload/sadf/sadf/sda
文件删除:https://oss.com/delete/sadf/sadf/sd/f
获取列表:https://oss.com/list/sadf/sadf/sda
目录信息:https://oss.com/info/
主机后第一个参数是操作(upload,list,info,delete),后面的是文件路径,其中.获取列表和目录信息可使用post.base_dir参数指定
安装修改application/config.php.修改两个配置项:'host_name'=>'https://oss.com','access_key' => 'asdfsadfsda'基本使用配置access_key参数,上传,列表,删除,或许信息接口必须提交form.post.access_key属性,且值与配置项相同,否则退出程序.配置host_name参数,上传或列表时,会把资源拼接成完整url链接返回到json注意,每次请求都至少有一个base_dir参数,也可以忽略这个参数,在url里操作,比如下面两种方式是等价的.上传a.jpg到b目录:可以通过post请求https://oss.com/upload并带有post.access_key,post.base_dir = '/b/a.jpg'以上写法等价于https://oss.com/upload/d/a.jpg并带有post.access_key,upload上传文件,主机名后第一个参数为upload,即上传文件如果最后以"/"结尾则创建目录,忽略上传的文件如果最后以字符串结尾,那么上传文件例1:上传图片,上传接口为https://oss.com/upload在form中添加base_dir参数:/a/b/c/d.jpg在form中添加file参数:本地文件在form中添加access_key参数:配置的通行码提交form,如果不存在a,b,c相关目录,会创建相关目录,并将d.jpg放到该目录下,成功后返回,其中form中base_dir可以用这种形式代替:https://oss.com/upload/a/b/c/d.jpg{ "file_path": "./data/a/b/c", "file_name": "d.jpg", "base_dir": "./data/a/b/c/d.jpg", "code": 200, "msg": "上传文件成功", "data": { "getExtension": "jpg", "getSaveName": "d.jpg", "getFilename": "d.jpg", "url": "https://oss.com/data/a/b/c/d.jpg" }}例2:新建目录,当base_dir以斜线结尾时,创建目录,忽略上传的文件上传接口为https://oss.com/upload在form中添加base_dir参数:/a/b/c/e/在form中添加file参数:可为空在form中添加access_key参数:配置的通行码提交form,如果不存在a,b,c相关目录,会创建相关目录,并将d.jpg放到该目录下,成功后返回,其中form中base_dir可以用这种形式代替:https://oss.com/upload/a/b/c/e/{ "file_path": "./data/a/b/c/e", "file_name": "", "base_dir": "./data/a/b/c/e/", "code": 200, "msg": "创建目录成功"}其他情况:假设以上两个例子正常执行,此时调用接口https://oss.com/upload/a/b/c/d.jpg/并填写相关参数,此时会报错,这个链接是创建d.jpg的目录,但实际上相同位置已经存在一个文件名相同,不能创建.同理,调用 https://oss.com/upload/a/b/c/e 也会失败,因为相同位置已经存在一个目录名为e.delete删除文件和目录,如果最后以"/"结尾,那么操作目录,接受post.rm参数为true时,强制删除指定目录如果以字符串结尾,那么删除文件例子:删除目录https://oss.com/delete/a/b/c/e/form带上access_key参数.正常会返回以下结果.如果目录不存在会提示目录不存在.{ "file_path": "./data/a/b/c/e", "file_name": "", "base_dir": "./data/a/b/c/e/", "code": 200, "msg": "删除目录成功"}例子:删除文件https://oss.com/delete/a/b/c/d.jpgform带上access_key参数.正常会返回以下结果.如果目录不存在会提示文件不存在.{ "file_path": "./data/a/b/c", "file_name": "d.jpg", "base_dir": "./data/a/b/c/d.jpg", "code": 200, "msg": "删除成功"}其他情况:强制删除目录:某个目录下有文件,那不能删除目录,可以添加post.rm=true参数强制删除目录下面文件即请求地址:https://oss.com/delete参数值base_dir/a/b/c/rmtrueaccess_key配置访问码以上方式等价于(推荐这种方式)请求地址:https://oss.com/delete/a/b/c/参数值rmtrueaccess_key配置访问码list列举目录,不论是否以"/"结尾,都操作目录接收参数post.l:显示详情post.h:格式化文件大小显示访问:https://oss.com/list/a并带有post.access_key可以列举a目录下的文件,其中不论是否以"/"结尾,都会列举a目录的列表,不存在则提示.一般显示如下结果:{ "file_path": "./data/a", "file_name": "", "base_dir": "./data/a/", "code": 200, "msg": "", "data": [ "b" ]}如果带有以下参数,则返回详细内容访问https://oss.com/list/a参数值意义ltrue是否显示详情htrue是否人性化显示,字节数转mbaccess_key配置访问码 { "file_path": "./data/a", "file_name": "", "base_dir": "./data/a/", "code": 200, "msg": "", "data": { "b": { "name": "b", "is_writeable": true, "is_executable": false, "is_readable": true, "realpath": "D:\\phpStudy\\WWW\\tposs\\public\\data\\a\\b", "url": "https://oss.com/data/a//b", "is_dir": true, "size": 0 } }}访问https://oss.com/info/a参数值意义ratrue是否递归计算所有子目录和文件htrue是否人性化显示,字节数转kb,mbaccess_key配置访问码 info获得目录基本信息post.ra:递归读取目录下所有文件和目录post.h:文件大小格式化{ "file_path": "./data/a", "file_name": "", "base_dir": "./data/a/", "code": 200, "msg": "", "data": { "disk_free_space": "99.562 GB", "disk_total_space": "292.969 GB", "files": { "file_count": 0, "dir_count": 1, "count": 1 }, "all_files": { "file_count": 0, "dir_count": 0, "count": 0 }, "is_writeable": true, "is_executable": false, "is_readable": true, "realpath": "D:\\phpStudy\\WWW\\tposs\\public\\data\\a", "url": "https://oss.com/data/a/" }data主机名/data/资源路径直接是资源路径,需要关闭debug所有操作都会返回url结果,该链接即访问路径,注意,如果资源不存在会尝试进入data模块,需要把debug关掉.注意:默认服务器不允许读取目录列表,也不建议开启该功能.
评论