aa24615/thinkphp

ThinkPHP

开发规范

以下规范与框架版本无关，适用于 ThinkPHP 项目日常开发与代码审查。能愿动词：必须/禁止表示强制，应/宜表示建议。

命名规范

• 目录与文件：遵循 PSR-2/PSR-4；目录使用小写+下划线；类文件名与类名一致，采用驼峰法且首字母大写；其它文件采用小写+下划线；命名空间路径与类库文件所在目录一致。
• 类、方法、属性：类名采用驼峰法首字母大写（如控制器可按框架约定命名，可不带后缀）；方法、属性采用驼峰法首字母小写；魔术方法以双下划线开头。
• 函数：函数命名使用小写字母与下划线（小写开头），如 get_client_ip。
• 常量与配置：常量、环境变量采用大写字母与下划线；配置参数采用小写字母与下划线。
• 数据表与字段：数据表和字段采用小写+下划线命名；字段名禁止以下划线开头；不建议使用驼峰或中文作为表名与字段名。
• 禁止：禁止使用 PHP 保留字作为常量、类名、方法名及命名空间名称，以免造成系统错误。

安全与性能

• 生产环境必须关闭调试模式，避免暴露敏感信息。
• 数据库操作应使用参数绑定或查询构造器，避免拼接 SQL 导致注入；输出到视图或 API 时应做转义，防止 XSS。
• 按需使用路由与配置缓存、避免 N+1 查询，以提升性能。

详细条目与示例见看云 ThinkPHP 开发规范（手册按版本组织，命名与约定原则通用）。

常用能力速览

• MVC：控制器、模型、视图分层；多应用时注意目录与命名空间对应。
• 路由：路由定义、分组、资源路由、路由参数与变量规则、URL 生成。
• 模型：模型定义、查询构造器、关联、获取器/修改器、类型转换、软删除、模型事件。
• 视图模板：模板继承与布局、变量输出、循环与条件、包含文件；少写业务逻辑。
• 中间件：全局与路由中间件、控制器中间件。
• 验证：验证器、验证场景、路由验证、独立验证。
• 请求与响应：请求对象、输入变量、响应输出、重定向。
• 配置：配置目录、环境变量、配置读取。
• 命令行：自定义指令、常用命令（清除缓存、生成映射等）。
• 部署：关闭调试、配置与路由缓存、运行环境要求。