tp3.2 开发规范（命名规范）

谁践踏了优雅 2022-05-24 07:46 218阅读 0赞

## 命名规范 ##

使用ThinkPHP开发的过程中应该尽量遵循下列命名规范：

>  *  类文件都是以.class.php为后缀（这里是指的ThinkPHP内部使用的类库文件，不代表外部加载的类库文件），使用驼峰法命名，并且首字母大写，例如 `DbMysql.class.php`；
>  *  类的命名空间地址和所在的路径地址一致，例如 `Home\Controller\UserController`类所在的路径应该是 `Application/Home/Controller/UserController.class.php`；
>  *  确保文件的命名和调用大小写一致，是由于在类Unix系统上面，对大小写是敏感的（而ThinkPHP在调试模式下面，即使在Windows平台也会严格检查大小写）；
>  *  类名和文件名一致（包括上面说的大小写一致），例如 `UserController`类的文件命名是`UserController.class.php`， InfoModel类的文件名是`InfoModel.class.php`， 并且不同的类库的类命名有一定的规范；
>  *  函数、配置文件等其他类库文件之外的一般是以`.php`为后缀（第三方引入的不做要求）；
>  *  函数的命名使用小写字母和下划线的方式，例如 `get_client_ip`；
>  *  方法的命名使用驼峰法，并且首字母小写或者使用下划线“\_”，例如 `getUserName`，`_parseType`，通常下划线开头的方法属于私有方法；
>  *  属性的命名使用驼峰法，并且首字母小写或者使用下划线“\_”，例如 `tableName`、`_instance`，通常下划线开头的属性属于私有属性；
>  *  以双下划线“\_\_”打头的函数或方法作为魔法方法，例如 `__call` 和 `__autoload`；
>  *  常量以大写字母和下划线命名，例如 `HAS_ONE`和 `MANY_TO_MANY`；
>  *  配置参数以大写字母和下划线命名，例如`HTML_CACHE_ON`；
>  *  语言变量以大写字母和下划线命名，例如`MY_LANG`，以下划线打头的语言变量通常用于系统语言变量，例如 `_CLASS_NOT_EXIST_`；
>  *  对变量的命名没有强制的规范，可以根据团队规范来进行；
>  *  ThinkPHP的模板文件默认是以`.html` 为后缀（可以通过配置修改）；
>  *  数据表和字段采用小写加下划线方式命名，并注意字段名不要以下划线开头，例如 `think_user` 表和 `user_name`字段是正确写法，类似 `_username` 这样的数据表字段可能会被过滤。

特例：在ThinkPHP里面，有一个函数命名的特例，就是单字母大写函数，这类函数通常是某些操作的快捷定义，或者有特殊的作用。例如：A、D、S、L 方法等等，他们有着特殊的含义，后面会有所了解。

> 由于ThinkPHP默认全部使用UTF-8编码，所以请确保你的程序文件采用UTF-8编码格式保存，并且去掉BOM信息头（去掉BOM头信息有很多方式，不同的编辑器都有设置方法，也可以用工具进行统一检测和处理），否则可能导致很多意想不到的问题。

## 开发建议 ##

在使用ThinkPHP进行开发的过程中，我们给出如下建议，会让你的开发变得更轻松：

>  *  遵循框架的命名规范和目录规范；
>  *  开发过程中尽量开启调试模式，及早发现问题；
>  *  多看看日志文件，查找隐患问题；
>  *  养成使用I函数获取输入变量的好习惯；
>  *  更新或者环境改变后遇到问题首要问题是清空Runtime目录；