\App\Services\ApiMyFileService

__construct()

__construct(\App\Services\Admin\MaintainFileService  $fileService) : mixed

Parameters

Returns

paginate()

paginate(array  $filters = [], int  $perPage = 15) : mixed

文件列表（仅本人上传；过滤参数与文件维护页同构）。

Parameters

Returns

trashList()

trashList(array  $filters = [], int  $perPage = 15) : mixed

回收站列表（仅本人；支持关键词/类型筛选，与文件维护页同构）。

Parameters

Returns

folders()

folders() : array

目录树（仅本人维度）：复用文件维护的本人树查询，公共分区与维护权 不进入个人中心（与「这里只生效我个人的文件」语义一致）。

Returns

usage()

usage() : array

空间用量（复用 MaintainFileService::usage，按本人 id 统计）。

Returns

assertMyFile()

assertMyFile(\App\Models\SysFile  $file) : void

文件归属校验：非本人文件一律拒绝（个人中心无越权面；基类异常映射 只区分 403/400，此处按业务错误 400 处理）。

Parameters

Throws

\InvalidArgumentException

他人文件

assertVisibleFile()

assertVisibleFile(\App\Models\SysFile  $file) : void

可见性校验（预览/下载用）：本人文件或共享文件（is_shared=1）可访问。

个人中心列表仅展示本人文件，但头像等共享文件（avatar 场景自动共享， 可能由管理员经 admin 线代传）需在本人中心展示——预览/下载按 「本人+共享」口径放行（与文件维护页 assertVisible 一致）； 其余操作仍强制 assertMyFile。

Parameters

Throws

\InvalidArgumentException

非本人且非共享

assertMyFolder()

assertMyFolder(\App\Models\SysFileFolder  $folder, int  $userId) : void

目录归属校验：非本人目录一律拒绝（与 assertMyFile 同口径隐藏存在性—— 个人中心目录操作不得暴露他人目录的存在）。

Parameters

Throws

\InvalidArgumentException

他人目录

filterMyIds()

filterMyIds(int[]  $ids) : int[]

批量 ids 仅保留本人文件（界面只显示本人的，防御性过滤防绕过）。

Parameters

Returns

purgeTrash()

purgeTrash() : int

清空本人回收站：物理文件（含缩略图变体）与 DB 记录一并清理， 口径与文件维护页 purgeTrash 同构，仅限定本人。

Returns

myQuery()

myQuery(array  $filters, int  $status) : mixed

本人查询基座：状态 + `user_id = 当前登录用户` + 与文件维护页同构的过滤。

Parameters

Returns