概述

本项目遵循现代 PHP 8.0+ 编码标准与团队内部规范，确保团队协作代码风格高度统一。

---

PHP 语法规范要点

1. 优先使用 PHP 8 现代语法：空安全操作符 ?->、联合类型声明、命名参数及 match 表达式；
2. 命名空间与导入：namespace 与 use 声明后必须空一行，导入类按字母顺序排列；
3. 类与方法大括号：类的 { 与方法的 { 必须自成一行；控制结构（if / foreach / while）的 { 写在同一行；
4. 访问修饰符：类的所有属性和方法必须显式添加访问修饰符（public / protected / private）；
5. 纯 PHP 文件：所有 PHP 脚本省略末尾的 ?> 闭合标签；
6. 逗号与等号空格：参数逗号后加空格、逗号前不留空格；赋值等号与比较运算符前后加空格。

---

EBAOZU 工程规范

1. 表单参数提取：使用 app\Request 的 getMore() 或 postMore() 提取并结构化入参：

   [$page, $limit, $keyword] = $request->getMore([
       ['page', 1],
       ['limit', 20],
       ['keyword', '']
   ], true);

2. 业务校验：校验逻辑封装在 app\validate\ 验证器类中，不在控制器内联臃肿逻辑：

   validate(\app\validate\api\user\UserValidate::class)->check($data);

3. 数据库变更记录：新增数据库结构改动 SQL 默认追加到 db_sql/zyl.sql；
4. 修改后校验：修改 PHP 文件后必须执行 php -l <file> 进行语法校验。

---

代码生成指令

快速生成标准分层代码模板：

php make:services api@user/User

php make:dao api@user/User