PHP开发各种规范,你学习绝对有帮助

Admin 2022-09-21 群英技术资讯 268 次浏览

这篇文章主要讲解了“PHP开发各种规范,你学习绝对有帮助”,文中的讲解内容简单、清晰、详细,对大家学习或是工作可能会有一定的帮助,希望大家阅读完这篇文章能有所收获。下面就请大家跟着小编的思路一起来学习一下吧。


基本约定

源文件

代码使用<?php开头,忽略闭合标签?>

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

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


缩进

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


行长度

每行120个字符


关键字

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


命名

类名为大驼峰法,如UserModel

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

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

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

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


代码注释标签

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

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


业务模块

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

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" : 100001,   "msg" : "不具有权限" }


其它

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

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


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

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



关于“PHP开发各种规范,你学习绝对有帮助”的内容今天就到这,感谢各位的阅读,大家可以动手实际看看,对大家加深理解更有帮助哦。如果想了解更多相关内容的文章,关注我们,群英网络小编每天都会为大家更新不同的知识。

群英智防CDN,智能加速解决方案
标签: PHP代码

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:mmqy2019@163.com进行举报,并提供相关证据,查实之后,将立刻删除涉嫌侵权内容。

猜你喜欢

成为群英会员,开启智能安全云计算之旅

立即注册
专业资深工程师驻守
7X24小时快速响应
一站式无忧技术支持
免费备案服务
免费拨打  400-678-4567
免费拨打  400-678-4567 免费拨打 400-678-4567 或 0668-2555555
在线客服
微信公众号
返回顶部
返回顶部 返回顶部
在线客服
在线客服