ThinkPHP API框架代码规范指南

ThinkPHP是一个基于PHP的轻量级Web开发框架，它遵循MVC（模型-视图-控制器）设计模式。为了保持代码的可读性、可维护性和可扩展性，遵循一定的代码规范是非常重要的。以下是一些ThinkPHP API框架的代码规范指南：

1. 目录结构

project/
├── application/
│   ├── controller/
│   ├── model/
│   ├── view/
│   ├── public/
│   │   ├── css/
│   │   ├── js/
│   │   ├── img/
│   ├── runtime/
│   ├── config.php
│   ├── routes.php
├── vendor/
├── composer.json
├── phpunit.xml
├── README.md

2. 命名规范

• 类名：使用大驼峰命名法（PascalCase），例如UserController。
• 方法名：使用小驼峰命名法（camelCase），例如getUserInfo。
• 变量名：使用小驼峰命名法（camelCase），例如$userName。
• 常量名：使用全大写字母和下划线分隔，例如API_SUCCESS。

3. 文件和目录命名

• 目录和文件名使用小写字母，单词之间使用连字符（-）分隔。
• 避免使用特殊字符和空格。

4. 注释规范

• 单行注释：使用//，例如// 获取用户信息。
• 多行注释：使用/* */，例如：

  /*
  * 获取用户信息
  */
  

• 文档注释：使用DocBlock格式，例如：

  /**
   * 获取用户信息
   * @param int $userId 用户ID
   * @return array 用户信息
   */
  

5. 代码风格

• 使用4个空格进行缩进。
• 每行代码长度不超过80个字符。
• 遵循PEP 8编码规范。

6. 控制器（Controller）

• 控制器文件名格式：{ControllerName}Controller.php。
• 控制器类名格式：{ControllerName}Controller。
• 控制器方法名格式：action{ActionName}。

7. 模型（Model）

• 模型文件名格式：{ModelName}Model.php。
• 模型类名格式：{ModelName}Model。

8. 视图（View）

• 视图文件名格式：{ControllerName}/{ActionName}.html。
• 视图文件应包含逻辑处理部分，例如：

  {extend name="base" /}
  {block name="title" /}
  <h1>{$title}</h1>
  {/block}
  

9. 公共文件（Public）

• CSS、JS、图片等资源文件应放在public目录下。

10. 配置文件（Config）

• 配置文件应放在application/config.php中。

11. 路由文件（Routes）

• 路由文件应放在application/routes.php中。

12. 测试文件（PHPUnit）

• 测试文件应放在tests目录下，文件名格式：{TestClassName}Test.php。

13. Composer依赖管理

• 使用Composer管理项目依赖，确保composer.json文件中列出了所有必要的依赖包。

14. 单元测试

• 编写单元测试用例，确保代码的正确性和稳定性。

15. 文档

• 编写项目文档，包括安装指南、使用说明和API文档。

通过遵循这些代码规范，可以确保ThinkPHP API框架的代码结构清晰、易于维护和扩展。