# FS - 文件系统

**Repository Path**: inphp-modules/fs

## Basic Information

- **Project Name**: FS - 文件系统
- **Description**: 文件上传管理模块，支持上传前的MD5校验，支持大文件分片上传
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2023-02-07
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 接口(服务器本地数据库)
#### 一、获取文件列表
参数全部是可选的，如果指定UID，仅显示 `is_private=0 and is_delete=0` 的文件
```
- GET
- url: /fs/files
- query
{
    parent_id: "文件夹ID",
    group_name: "文件分组名称",
    name: "搜索名称",
    suffix: "文件后缀，多个使用 [,|/空格] 来分隔，4种都可以",
    is_delete: "1或0",
    is_private: "1或0",
    uid: "指定UID"
}
```
#### 二、修改文件名称 / 移动文件
```
- POST
- url: /fs/files/save
- body
{
    id: "要修改的文件ID/文件夹ID",
    parent_id: "改文件夹ID",
    group_name: "改文件分组名称",
    name: "改名称",
    is_private: "1或0"
}
```
#### 三、同步文件(文件上传到cos成功再把文件保存到数据库)
```
- POST
- url: /fs/files/save
- body
{
    parent_id: "文件夹ID",
    group_name: "文件分组名称",
    name: "文件名称",
    is_private: "1或0",
    url: "文件地址，http开头，或服务器里的文件路径",
    storage: "cloud 或 local",
    size: "(选填)字节大小",
    hash: "(选填)文件md5"
}
```
#### 四、创建文件夹
```
- POST
- url: /fs/files/makeDir
- body
{
    parent_id: "文件夹ID",
    group_name: "文件分组名称",
    name: "文件名称",
    is_private: "1或0"
}
```
#### 五、检查文件md5是否存在
```
- GET
- url: /fs/files/exists
- query
{
    hash: "文件md5"
}
```
#### 六、删除文件/文件夹
第一次软删除`is_delete=1`，第二次直接删除数据
```
- POST
- url: /fs/files/delete
- body
{
    id: "文件ID"
}
```