代码规范 ​

以下规则基于当前项目的实际习惯与约定。

基础规范 ​

• 所有 PHP 文件使用 declare(strict_types=1);
• if/else 必须使用 {}
• 类名大驼峰、方法名小驼峰
• 命名空间 App\模块名\...

资源与模型 ​

• 模型尽量提供 transform()，统一输出字段
• format() 只做字段映射，不做业务判断
• 校验集中在 validator()
• 不重复清洗数据，不做多余兜底

参数处理 ​

• 读取参数先补默认值，再直接使用索引
• 避免 ?: 误伤 0

中间件顺序 ​

• 自定义中间件在外层
• 认证/权限在内层