$myFileService
$myFileService : \App\Services\Api\MyFileService
我的文件控制器
职责:个人中心文件管理的 HTTP 入口——列表/回收站/目录/上传/操作/下载 全套能力与文件维护页同构,但「仅本人」口径由 MyFileService 强制 (文件归属校验 400 隐藏存在性;预览/下载额外放行共享文件——头像等 avatar 场景自动共享、可能由管理员代传);上传恒为私有(is_shared=0), 无公共空间概念;异常经基类 callService 统一映射。
$myFileService : \App\Services\Api\MyFileService
$fileService : \App\Services\Admin\MaintainFileService
folderUpdate(\App\Http\Requests\Admin\MaintainFileRequest $request, \App\Models\SysFileFolder $folder) : \Illuminate\Http\JsonResponse
更新目录
支持重命名、移父级与同级排序;目录名同级不可重复(仅本人目录,单源 ManagesFolders)。
| \App\Http\Requests\Admin\MaintainFileRequest | $request | |
| \App\Models\SysFileFolder | $folder |
download(\App\Models\SysFile $file) : \Symfony\Component\HttpFoundation\StreamedResponse|\Illuminate\Http\JsonResponse
下载文件
本人文件可下载(他人文件 404);头像等共享文件(avatar 场景自动共享, 可能由管理员经 admin 线代传)同样可读,与文件维护页「本人+共享」可见性口径一致; 响应强制附件方式不内联渲染(单源 streamFile 编排)。
| \App\Models\SysFile | $file |
preview(\App\Models\SysFile $file, \Illuminate\Http\Request $request) : \Symfony\Component\HttpFoundation\StreamedResponse|\Illuminate\Http\JsonResponse
预览文件
本人文件可预览(他人文件 404);共享文件同下载口径放行(头像展示场景); ?variant=thumb 取缩略图,缺省取原图(单源 streamFile 编排)。
| \App\Models\SysFile | $file | |
| \Illuminate\Http\Request | $request |