| name | thinkphp |
| description | ThinkPHP 路由、模型、视图、中间件与部署。在开发或维护 ThinkPHP 项目时使用。 |
ThinkPHP
开发规范
以下规范与框架版本无关,适用于 ThinkPHP 项目日常开发与代码审查。能愿动词:必须/禁止表示强制,应/宜表示建议。
命名规范
- 目录与文件:遵循 PSR-2/PSR-4;目录使用小写+下划线;类文件名与类名一致,采用驼峰法且首字母大写;其它文件采用小写+下划线;命名空间路径与类库文件所在目录一致。
- 类、方法、属性:类名采用驼峰法首字母大写(如控制器可按框架约定命名,可不带后缀);方法、属性采用驼峰法首字母小写;魔术方法以双下划线开头。
- 函数:函数命名使用小写字母与下划线(小写开头),如
get_client_ip。
- 常量与配置:常量、环境变量采用大写字母与下划线;配置参数采用小写字母与下划线。
- 数据表与字段:数据表和字段采用小写+下划线命名;字段名禁止以下划线开头;不建议使用驼峰或中文作为表名与字段名。
- 禁止:禁止使用 PHP 保留字作为常量、类名、方法名及命名空间名称,以免造成系统错误。
安全与性能
- 生产环境必须关闭调试模式,避免暴露敏感信息。
- 数据库操作应使用参数绑定或查询构造器,避免拼接 SQL 导致注入;输出到视图或 API 时应做转义,防止 XSS。
- 按需使用路由与配置缓存、避免 N+1 查询,以提升性能。
详细条目与示例见看云 ThinkPHP 开发规范(手册按版本组织,命名与约定原则通用)。
常用能力速览
- MVC:控制器、模型、视图分层;多应用时注意目录与命名空间对应。
- 路由:路由定义、分组、资源路由、路由参数与变量规则、URL 生成。
- 模型:模型定义、查询构造器、关联、获取器/修改器、类型转换、软删除、模型事件。
- 视图模板:模板继承与布局、变量输出、循环与条件、包含文件;少写业务逻辑。
- 中间件:全局与路由中间件、控制器中间件。
- 验证:验证器、验证场景、路由验证、独立验证。
- 请求与响应:请求对象、输入变量、响应输出、重定向。
- 配置:配置目录、环境变量、配置读取。
- 命令行:自定义指令、常用命令(清除缓存、生成映射等)。
- 部署:关闭调试、配置与路由缓存、运行环境要求。