php开发规范有哪些-PHP问题-PHP中文网

php开发规范有哪些

王林

发布： 2020-01-29 19:54:42

转载

2588人浏览过

php开发规范有哪些

源文件

代码使用zuojiankuohaophpcn?php开头，忽略闭合标签?>

文件格式必须是无BOM UTF-8格式

一个文件只声明一种类型，如class和interface不能混写在一个源文件中

缩进

使用4个空格来缩进，IDE可以设置

（推荐学习：php视频教程）

立即学习“PHP免费学习笔记（深入）”；

行长度

每行120个字符

关键字

所有关键字均为小写，如true、false

命名

类名为大驼峰法，如UserModel

类方法名为小驼峰法，如getUserId()

函数使用小写字母加_组合，如get_cookie()

变量名使用小驼峰法，如$userId

常量定义为大写字母加_组合，如IS_DEBUG

代码注释标签

类文件中对类、方法、属性进行注释，使用@param @return @throwns

@param注释写出详解，如@param string $username 用户名

业务模块

路由为小写字母加_组成，如/api/get_user_info

v1.2.1云EC电商系统

云EC电商系统（简称云EC）是由佛山市云迈电子商务有限公司自主开发的一套免费、开源的基于PHP+MYSQL电商系统软件。云EC电商系统 1.2.1 更新日志：2018-08-10 1.修复部分环境下二维码不显示的问题； 2.商品列表增加多属性筛选支持； 3.修复更新优惠券状态时错将已使用的优惠券也更新为过期； 4.修复文章发布远程图片下载失败； 5.修复某些情况下运费计算出错导致

2595

查看详情

View层负责数据展示

Controller层负责输入参数校验，最外层捕捉异常，调用Logic和View视图层

Logic层负责具体业务逻辑，调用Model层，返回处理数据

Model层负责数据表查询和关联关系

异常类需分清功能，如ParamException表示参数错误，UserException表示自定义异常

异常需分类定义code，使用PHP类常量代替，如

<?php
namespace app\exceptions\codes;

class UserExceptionCode extends BaseExceptionCode {
  const NO_AUTH       = 1000001;
  const NO_AUTH_MSG     = '不具有权限';
  const STATUS_EXCEPTION   = 1000002;
  const STATUS_EXCEPTION_MSG = '状态异常';    
}

登录后复制

数据表文件如有Enum类型，使用PHP类常量代替，如

<?php
<?php
namespace app\enums;

class UserEnum extends BaseEnum {
  const STATUS_DELETED = -1;// 已删除
  const STATUS_DISABLE = 0;// 禁用
  const STATUS_ENABLE = 1;// 正常

  const AUTH_GUEST     = 1;// 匿名用户
  const AUTH_GENERAL_ADMIN = 2;// 普通管理员
  const AUTH_SUPER_ADMIN  = 3;// 超级管理员
}

登录后复制

其中STATUS和AUTH为数据表映射字段名

Api接口输出，示例

{
  "code" : 0,
  "msg" : "success",
  "data" : {
    "userId" : 100
  }
}

登录后复制

其中code与msg为必填字段，data为空的情况下不填，示例

{
  "code" : 0,
  "msg" : "success",
  "data" : {
    "userId" : 100
  }
}

登录后复制

其它

数组，键为字符串时候使用单引号，只有一个键时候使用单行，示例

$arr = [ 'userId' => 100 ];

登录后复制

多个键时候使用多行，示例

$arr = [  
'id'    => 100,  
'username' => 'admin',
];

登录后复制

大家都在看：

PHP数组去重可以用匿名函数实现吗 PHP数组去重可以用闭包实现吗 PHP数组去重需要考虑性能损耗吗 PHP数组去重对数字和字符串的比较有何差异 PHP数组去重可以保留最后一个出现的元素吗