跳到正文
SSaleSass开发者文档
管理后台
文档中心框架文档
框架文档

文件与存储

统一上传大小、存储驱动、目录和访问权限。

目录约定

text
# 系统附件
public/upload/年月/随机文件名.扩展名

# 应用文件按应用标识隔离
public/upload/应用标识/应用内相对路径

# 台账管理应用
public/upload/ledger_management/年月/一级分类/任务文件夹/字段名称.扩展名

统一存储服务

StorageService 支持本地、阿里云 OSS、腾讯云 COS 和七牛。应用提交相对对象键,数据库保留存储定位信息。切换默认驱动不会重写已有文件的定位。

台账管理的后续文件追加任务内递增序号,避免覆盖。PDF 文件字段最多一个 PDF,服务端同时检查扩展名和实际 MIME。上传大小由系统配置与 PHP 上传限制共同决定。

下载权限

public/upload 是文件的磁盘位置,访问仍通过鉴权下载接口。内置开发路由与 Apache 已阻止静态直读;Nginx 部署需配置同样的限制。

nginx
location = /upload { return 403; }
location ^~ /upload/ { return 403; }
SaleSass 开发者文档 · 与项目内的接口契约同步