\App\Http\HelpersFileScene

上传场景注册表(字典优先 + 内置锚点兜底)。

注册表契约:

  • key :场景唯一标识(default/site/editor/attachment/avatar 为内置锚点), 上传那一刻定型写入文件的 source 列,永不修改。
  • 权威来源:字典类型 scene(td_sys_dict_data)是管理面唯一权威—— 新增业务上传点在字典数据页加一项即可(key + 中文名),无需改代码; 删除/停用字典项即停用该场景(新上传校验不放行)。
  • 兜底 :内置锚点仅在字典不可用(异常)或整表为空(未播种)时生效,保证系统可启动。
  • 消费方 :文件上传校验(场景白名单)、files/scenes 接口(管理页筛选选项下发)。

Summary

Methods
Properties
Constants
all()
keys()
valid()
name()
No public properties found
SCENES
No protected methods found
No protected properties found
N/A
dictScenes()
No private properties found
N/A

Constants

SCENES

SCENES = ['default' => '通用', 'site' => '站点配置', 'editor' => '编辑器', 'attachment' => '业务附件', 'avatar' => '头像'] : array<string,string>

Methods

all()

all() : array

全量场景(字典优先,[{key, name}];字典不可用回落内置;接口下发用)

Returns

array —

keys()

keys() : array

场景 key 白名单(Request 校验用;字典优先,字典不可用回落内置)

Returns

array —

valid()

valid(string  $key) : bool

场景是否存在(字典优先——删除/停用字典项即停用该场景; 仅当字典不可用(异常)或整表为空时回落内置锚点兜底)。

Parameters

string $key

Returns

bool —

name()

name(string  $key) : string

场景中文名(内置/字典查找,未知 key 原样返回)

Parameters

string $key

Returns

string —

dictScenes()

dictScenes() : array

字典扩展场景(type_code=scene,走 sys:dict:list 缓存)。 字典不可用时回落内置(不抛错)。

Returns

array —