docsify/api/file.md at main · inis-cloud/docsify

【上传】文件

通过该接口，你可以上传文件到系统中
前提条件是必须登录且未被禁用的用户
目前只允许上传jpg,jpeg,png,gif,webp,svg,ico,zip,gz,mp3,mp4,avi的文件类型，且限制20MB大小上传，之后会在后台中动态限制上传规则

http://[域名]/api/file

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
login-token	是	string	null	null	登录密钥	用于判断是否拥有权限（可以在参数或headers中提交，推荐header提交）
mode	是	string	null	upload	模式	无
file	否	file	null	null	文件	无

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<input type="file" id="upload" />

<script>
$("#upload").click(()=>{
    
    let upload = document.querySelector("#upload")
    let file   = upload.files[0];
    
    let params = new FormData
    params.append("login-token", "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOi...")
    params.append("mode", 'upload')
    params.append("file", file)
    
    $.ajax({
        type: "POST",      // 数据提交类型
        url: "http://test.inis.cn/api/file", // 发送地址
        data: params,      // 发送数据
        async: true,       // 是否异步
        processData: false,// processData 默认为false，当设置为true的时候,jquery ajax 提交的时候不会序列化 data，而是直接使用data
        contentType: false,
        success: (res)=>{
            console.log(res)
        },
        error: (err)=>{
            console.log(err)
        }

    });
});
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<input type="file" id="upload" />

<script>
    let upload = document.querySelector("#upload")
    // 监听 #upload 的change事件
    upload.addEventListener("change", (event) => {
        
        // 获取到选中的文件
        let file = upload.files[0];
        
        let params = new FormData
        params.append("login-token", "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOi...")
        params.append("mode", 'upload')
        params.append("file", file)
        
        // axios 配置，可以获取上传进度
        const config = {
            headers: { "Content-Type": "multipart/form-data" },
            onUploadProgress: (speed) => {
                if (speed.lengthComputable) {
                    let ratio = speed.loaded / speed.total;
                    // 只是上传到后端，后端并未真正保存成功
                    if (ratio < 1) console.log("当前的上传进度：", ratio)
                }
            }
        }
        
        axios.post("http://test.inis.cn/api/file", params, config).then((res) => {
            if(res.data.code == 200){
                console.log("上传成功", res.data)
            } else {
                console.log("上传失败", res.data.msg)
            }
        })
        
        // 清空选中的文件，方便无刷新再次上传
        event.target.value = ''
        
    }, true)
</script>

php

<?php
// 晚点再写

请求成功返回的数据结构

{
    "code": 200,
    "msg": "图片上传成功！",
    "data": "https://test.inis.cn/storage/users/files/uid-2/2021-08/3.jpg"
}

【随机图】

在inis系统目录public/storage/random/images/下新建文件夹或txt文件存储图片
参数 file=新建的文件夹或txt名
本地模式：文件夹为随机图本地模式，里面存放的是需要被随机的图片，调用加载需要消耗服务器带宽资源（不推荐）
外链模式：txt文件内存放的是图片地址，一行一个，调用加载不需要占用服务器带宽资源（推荐）

!> 应用场景：可分类的随机图API

http://[域名]/api/file/random

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
file	否	string	null	null	对应的随机图文件或者文件夹	如果不填写，默认随机整站的随机图
json	否	bool	false	true、false	获取JSON格式数据	无
sole	否	string	null	null	推荐提交，防止多次请求，返回同一结果	参数的值随便，只要是唯一的就行

html

<img src="http://test.inis.cn/api/file/random?sole=value" />

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/file/random',
  type:'GET',
  dataType:'JSON',
  data:{json:true,sole:Math.round(new Date)},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/file/random',{
    params:{
        json:true,
        sole:Math.round(new Date)
    }
  }).then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

php

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/file/random?sole=value';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;

请求成功返回的数据结构

{
    "code":200,
    "msg":"ok",
    "data":"https://picabstract-preview-ftn.weiyun.com/ftn_pic_abs_v3/34758c568f8f29c23a09910b439e5ff19f29ff580ac3bf11049f0e2d9c9b9187eebeee4dfef6834034a58d097403249f?pictype=scale&amp;from=30013&amp;version=3.3.3.3&amp;uin=97783391&amp;fname=3.jpg&amp;size=750\n"
}

【随机文本】

在inis系统目录public/storage/random/words/下新建txt文件存储内容
参数 file=新建的txt文件名

!> 应用场景：一言 舔狗日记

http://[域名]/api/file/words

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
file	否	string	null	null	对应的随机文件	如果不填写，默认随机整站的随机文本
sole	否	string	null	null	推荐提交，防止多次请求，返回同一结果	参数的值随便，只要是唯一的就行

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/file/words',
  type:'GET',
  dataType:'JSON',
  data:{sole:Math.round(new Date)},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/file/words',{
    params:{
        sole:Math.round(new Date)
    }
  }).then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

php

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/file/words?sole=value';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;

请求成功返回的数据结构

{
    "code":200,
    "msg":"ok",
    "data":"许一人以偏爱，尽此生之慷慨。"
}

获取系统【文件】

通过该接口，你可以获取inis系统目录下的所有文件

!> 应用场景：文件系统

http://[域名]/api/file

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
path	否	string	./	null	路径	无

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/file',
  type:'GET',
  dataType:'JSON',
  data:{path:'./storage'},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/file',{
    params:{
        path:'./storage'
    }
  }).then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

php

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/file?path=./storage';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;

请求成功返回的数据结构

{
    "code":200,
    "msg":"ok",
    "data":{
        "path":"./storage/",
        "info":[
            {
                "name":"article",
                "info":{
                    "file_name":"article",
                    "path_name":"/www/wwwroot/test.inis.cn/public/storage/article",
                    "owner":1000,
                    "perms":16877,
                    "inode":131403,
                    "group":1000,
                    "path":"./storage",
                    "atime":1636971723,
                    "ctime":1636622836,
                    "size":4096,
                    "type":"dir",
                    "ext":"",
                    "mtime":1626408717,
                    "isDir":true,
                    "isFile":false,
                    "isLink":false,
                    "isReadable":true,
                    "isWritable":true,
                    "isUpload":false,
                    "ico":"https://test.inis.cn/index/assets/svg/filesystem/yellow-folder.svg"
                }
            },
            {
                "name":"banner",
                "info":{
                    "file_name":"banner",
                    "path_name":"/www/wwwroot/test.inis.cn/public/storage/banner",
                    "owner":1000,
                    "perms":16877,
                    "inode":131426,
                    "group":1000,
                    "path":"./storage",
                    "atime":1636971723,
                    "ctime":1636622836,
                    "size":4096,
                    "type":"dir",
                    "ext":"",
                    "mtime":1626408701,
                    "isDir":true,
                    "isFile":false,
                    "isLink":false,
                    "isReadable":true,
                    "isWritable":true,
                    "isUpload":false,
                    "ico":"https://test.inis.cn/index/assets/svg/filesystem/yellow-folder.svg"
                }
            },
            {
                "name":"image",
                "info":{
                    "file_name":"image",
                    "path_name":"/www/wwwroot/test.inis.cn/public/storage/image",
                    "owner":1000,
                    "perms":16877,
                    "inode":131404,
                    "group":1000,
                    "path":"./storage",
                    "atime":1636971723,
                    "ctime":1636622836,
                    "size":4096,
                    "type":"dir",
                    "ext":"",
                    "mtime":1629529893,
                    "isDir":true,
                    "isFile":false,
                    "isLink":false,
                    "isReadable":true,
                    "isWritable":true,
                    "isUpload":false,
                    "ico":"https://test.inis.cn/index/assets/svg/filesystem/yellow-folder.svg"
                }
            },
            {
                "name":"random",
                "info":{
                    "file_name":"random",
                    "path_name":"/www/wwwroot/test.inis.cn/public/storage/random",
                    "owner":1000,
                    "perms":16877,
                    "inode":131396,
                    "group":1000,
                    "path":"./storage",
                    "atime":1636968854,
                    "ctime":1636968852,
                    "size":4096,
                    "type":"dir",
                    "ext":"",
                    "mtime":1636968852,
                    "isDir":true,
                    "isFile":false,
                    "isLink":false,
                    "isReadable":true,
                    "isWritable":true,
                    "isUpload":false,
                    "ico":"https://test.inis.cn/index/assets/svg/filesystem/yellow-folder.svg"
                }
            },
            {
                "name":"users",
                "info":{
                    "file_name":"users",
                    "path_name":"/www/wwwroot/test.inis.cn/public/storage/users",
                    "owner":1000,
                    "perms":16877,
                    "inode":131405,
                    "group":1000,
                    "path":"./storage",
                    "atime":1636971723,
                    "ctime":1636622836,
                    "size":4096,
                    "type":"dir",
                    "ext":"",
                    "mtime":1629892479,
                    "isDir":true,
                    "isFile":false,
                    "isLink":false,
                    "isReadable":true,
                    "isWritable":true,
                    "isUpload":false,
                    "ico":"https://test.inis.cn/index/assets/svg/filesystem/yellow-folder.svg"
                }
            }
        ]
    }
}

获取【文件或目录】信息

通过该接口，你可以获取inis系统目录下对应的文件或目录信息

!> 应用场景：文件系统

http://[域名]/api/file/info

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
path	否	string	./	null	路径	无
file	否	string	null	null	文件的名称	无

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/file/info',
  type:'GET',
  dataType:'JSON',
  data:{path:'./',file:'index.php'},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/file/info',{
    params:{
        path:'./',
        file:'index.php'
    }
  }).then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

php

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/file/info?path=./&file=index.php';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;

请求成功返回的数据结构

{
    "code":200,
    "msg":"ok",
    "data":{
        "other":{
            "file_name":"index.php",
            "path_name":"/www/wwwroot/test.inis.cn/public/index.php",
            "owner":1000,
            "perms":33261,
            "inode":131428,
            "group":1000,
            "path":".",
            "atime":1636971344,
            "ctime":1636622836,
            "size":811,
            "type":"file",
            "ext":"php",
            "mtime":1630465354,
            "isDir":false,
            "isFile":true,
            "isLink":false,
            "isReadable":true,
            "isWritable":true,
            "isUpload":false
        },
        "size":{
            "0":2065,
            "1":131428,
            "2":33261,
            "3":1,
            "4":1000,
            "5":1000,
            "6":0,
            "7":811,
            "8":1636971344,
            "9":1630465354,
            "10":1636622836,
            "11":4096,
            "12":8,
            "dev":2065,
            "ino":131428,
            "mode":33261,
            "nlink":1,
            "uid":1000,
            "gid":1000,
            "rdev":0,
            "size":811,
            "atime":1636971344,
            "mtime":1630465354,
            "ctime":1636622836,
            "blksize":4096,
            "blocks":8
        }
    }
}

读取【文件】内容

通过该接口，你可以获取inis系统目录下对应的文件内容

!> 应用场景：文件系统

http://[域名]/api/file/read

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
path	否	string	./	null	路径	无

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/file/read',
  type:'GET',
  dataType:'JSON',
  data:{path:'./index.php'},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/file/read',{
    params:{
        path:'./index.php'
    }
  }).then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

php

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/file/read?path=./index.php';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;

请求成功返回的数据结构

{
    "code":200,
    "msg":"ok",
    "data":{
        "content":"&lt;?php\n// +----------------------------------------------------------------------\n// | ThinkPHP [ WE CAN DO IT JUST THINK ]\n// +----------------------------------------------------------------------\n// | Copyright (c) 2006-2019 http://thinkphp.cn All rights reserved.\n// +----------------------------------------------------------------------\n// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )\n// +----------------------------------------------------------------------\n// | Author: liu21st &lt;liu21st@gmail.com&gt;\n// +----------------------------------------------------------------------\n\n// [ 应用入口文件 ]\nnamespace think;\n\nrequire __DIR__ . '/../vendor/autoload.php';\n\n// 执行HTTP应用并响应\n$http = (new App())-&gt;http;\n\n$response = $http-&gt;run();\n\n$response-&gt;send();\n\n$http-&gt;end($response);",
        "info":{
            "file_name":"index.php",
            "path_name":"/www/wwwroot/test.inis.cn/public/index.php",
            "owner":1000,
            "perms":33261,
            "inode":131428,
            "group":1000,
            "path":".",
            "atime":1636971344,
            "ctime":1636622836,
            "size":811,
            "type":"file",
            "ext":"php",
            "mtime":1630465354,
            "isDir":false,
            "isFile":true,
            "isLink":false,
            "isReadable":true,
            "isWritable":true,
            "isUpload":false
        }
    }
}

查找【文件】

通过该接口，你可以查找inis系统目录下的文件

!> 应用场景：文件系统

http://[域名]/api/file/read

请求参数：[有]

参数名称	是否必选	参数类型	默认值	可选参数	说明	备注
path	否	string	./	null	路径	无
suffix	否	string	null	null	需要搜索的文件后缀	多个用英文 , 隔阂，如：txt,jpg,jpeg
all	否	string	false	true、false	显示全部	开启后会匹配子目录下符合结果
order	否	string	asc	asc、desc、nat	排序方式	asc=升序;desc=倒序;nat=自然排序;
merge	否	string	false	true、false	合并搜索结果	无
domain	否	string	true	true、false	在路径前面拼接域名	无

ajax

<!-- 导入JQ -->
<script src="//code.jquery.com/jquery-3.5.1.min.js"></script>

<script>
$.ajax({
  url:'http://test.inis.cn/api/file/find',
  type:'GET',
  dataType:'JSON',
  data:{suffix:'txt,jpg,jpeg',all:true,merge:true},
  success: (res) => {
	// 状态码 200 表示请求成功
	if(res.code === 200){
	  console.log(res.data)
	}else{
	  console.log(res)
	}
  }
})
</script>

axios

<!-- 导入axios -->
<script src="//unpkg.com/axios/dist/axios.min.js"></script>

<script>
axios.get('http://test.inis.cn/api/file/find',{
    params:{
        suffix:'txt,jpg,jpeg',
        all:true,
        merge:true
    }
  }).then((res) => {
  // 状态码 200 表示请求成功
  if(res.data.code == 200){
	console.log(res.data)
  }else{
	console.log(res)
  }
})
</script>

php

<?php
// 定义头部信息
header('content-type:application/json');
// API接口
$url  = 'http://test.inis.cn/api/file/find?suffix=txt,jpg,jpeg&all=true&merge=true';

$curl = curl_init(); 
curl_setopt($curl,CURLOPT_URL,$url); 
curl_setopt($curl,CURLOPT_RETURNTRANSFER,true);
$data = curl_exec($curl); 
curl_close($curl);     

// 输出数据
echo $data;

请求成功返回的数据结构

{
    "code":200,
    "msg":"ok",
    "data":[
        "https://test.inis.cn/robots.txt",
        "https://test.inis.cn/storage/random/images/img.txt",
        "https://test.inis.cn/storage/random/words/text.txt",
        "https://test.inis.cn/index/assets/images/head/1.jpg",
        "https://test.inis.cn/index/assets/images/head/10.jpg",
        "https://test.inis.cn/index/assets/images/head/2.jpg",
        "https://test.inis.cn/index/assets/images/head/3.jpg",
        "https://test.inis.cn/index/assets/images/head/4.jpg",
        "https://test.inis.cn/index/assets/images/head/5.jpg",
        "https://test.inis.cn/index/assets/images/head/6.jpg",
        "https://test.inis.cn/index/assets/images/head/7.jpg",
        "https://test.inis.cn/index/assets/images/head/8.jpg",
        "https://test.inis.cn/index/assets/images/head/9.jpg",
        "https://test.inis.cn/storage/users/anime/1.jpg",
        "https://test.inis.cn/storage/users/anime/10.jpg",
        "https://test.inis.cn/storage/users/anime/2.jpg",
        "https://test.inis.cn/storage/users/anime/3.jpg",
        "https://test.inis.cn/storage/users/anime/4.jpg",
        "https://test.inis.cn/storage/users/anime/5.jpg",
        "https://test.inis.cn/storage/users/anime/6.jpg",
        "https://test.inis.cn/storage/users/anime/7.jpg",
        "https://test.inis.cn/storage/users/anime/8.jpg",
        "https://test.inis.cn/storage/users/anime/9.jpg",
        "https://test.inis.cn/storage/users/pay/uid-1/alipay.jpg"
    ]
}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

【上传】文件

ajax

axios

php

【随机图】

html

ajax

axios

php

【随机文本】

ajax

axios

php

获取系统【文件】

ajax

axios

php

获取【文件或目录】信息

ajax

axios

php

读取【文件】内容

ajax

axios

php

查找【文件】

ajax

axios

php

FilesExpand file tree

file.md

Latest commit

History

file.md

File metadata and controls

【上传】文件

** ajax **

** axios **

** php **

【随机图】

** html **

** ajax **

** axios **

** php **

【随机文本】

** ajax **

** axios **

** php **

获取系统【文件】

** ajax **

** axios **

** php **

获取【文件或目录】信息

** ajax **

** axios **

** php **

读取【文件】内容

** ajax **

** axios **

** php **

查找【文件】

** ajax **

** axios **

** php **

ajax

axios

php

html

ajax

axios

php

ajax

axios

php

ajax

axios

php

ajax

axios

php

ajax

axios

php

ajax

axios

php