CRMEB PRO =============== > 运行环境要求PHP7.1 ~ 7.3。 ## 开发规范 #### 命名规范 ThinkPHP6.0遵循PSR-2命名规范和PSR-4自动加载规范,并且注意如下规范: 1. 目录和文件 2. 目录使用小写+下划线; 3. 类库、函数文件统一以.php为后缀; 4. 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致; 5. 类(包含接口和Trait)文件采用驼峰法命名(首字母大写),其它文件采用小写+下划线命名; 6. 类名(包括接口和Trait)和文件名保持一致,统一采用驼峰法命名(首字母大写); #### 函数和类、属性命名 1. 类的命名采用驼峰法(首字母大写),例如 User、UserType; 2. common函数的命名使用小写字母和下划线(小写字母开头)的方式,例如 get_client_ip; 3. 控制器里面的方法使用小写字母和下划线(小写字母开头)的方式,例如 get_client_ip 4. 方法的命名使用驼峰法(首字母小写),例如 getUserName; 5. 属性的命名使用驼峰法(首字母小写),例如 tableName、instance; 6. 特例:以双下划线__打头的函数或方法作为魔术方法,例如 __call 和 __autoload; #### 常量和配置 1. 常量以大写字母和下划线命名,例如 APP_PATH; 2. 配置参数以小写字母和下划线命名,例如 url_route_on 和url_convert; 3. 环境变量定义使用大写字母和下划线命名,例如APP_DEBUG; #### 数据表和字段 1. 数据表和字段采用小写加下划线方式命名,并注意字段名不要以下划线开头,例如 think_user 表和 user_name字段,不建议使用驼峰和中文作为数据表及字段命名 注意:请理解并尽量遵循以上命名规范,可以减少在开发过程中出现不必要的错误 #### 语法规范 1. 尽量使用php7新语法 2. 每个 namespace 命名空间声明语句和 use 声明语句块后面,必须 插入一个空白行 3. 类的开始花括号({) 必须 写在类声明后自成一行,结束花括号(})也 必须 写在类主体后自成一行 4. 方法的开始花括号({) 必须 写在函数声明后自成一行,结束花括号(})也 必须 写在函数主体后自成一行。 5. 类的属性和方法 必须 添加访问修饰符(private、protected 以及 public),abstract 以及 final 必须 声明在访问修饰符之前,而 static 必须 声明在访问修饰符之后 6. 控制结构的关键字后 必须 要有一个空格符,而调用方法或函数时则 一定不可 有 7. 控制结构的开始花括号({) 必须 写在声明的同一行,而结束花括号(}) 必须 写在主体后自成一行 8. 纯 PHP 代码文件 必须 省略最后的 ?> 结束标签 9. 所有方法,类,控制器类,都 必须 添加访问修饰符 ~~~ /** * 中文注释 * @param string $str 声明类型 * @param array $arr * @return bool */ public function action(string $str, array $arr) { return true; } ~~~ 10. 参数列表中,每个逗号后面 必须 要有一个空格,而逗号前面 一定不可 有空格 ~~~ function foo($arg1, &$arg2, $arg3 = []) { // method body } ~~~ 11. 参数 可以 分列成多行,此时包括第一个参数在内的每个参数都 尽量 单独成行。 ~~~ bar( $longArgument, $longerArgument, $muchLongerArgument ); ~~~ 12. 标准的 if 结构如下代码所示,请留意「括号」、「空格」以及「花括号」的位置, 注意 else 和 elseif 都与前面的结束花括号在同一行 ~~~ true]; 之前 echo isset($arr['crmeb']) ? $arr['crmeb'] : ''; 之后 echo $arr['crmeb'] ?? ''; ~~~ 2. define() 定义常量数组 ~~~