一、PHP注意事项
- 1、URL请求地址采用”-“分割。（已执行，部分人未按标准执行）
- 2、方法名采用驼峰法。（已执行，部分人未按标准执行）
- 3、参数必须小写和下划线分割，严禁使用驼峰或者其它格式，且提交参数与返回字段名一致。 （已执行，部分人未按标准执行）
- 4、获取数据采用GET, 添加，修改必须POST 。（已执行，部分人未按标准执行）
- 5、API返回格式必须调用jsonResult基础方法。（已执行）
6、错误码必须调用ErrCode，不能直接写错误码数字。（已执行） - 7、分页采用框架自带的， 自建二维数组必须[‘data’ => $arr], 分页条目必须使用limit参数。（已执行）
- 8、接口返回备注信息（msg）,必须写在config.msg文件。（新增）
- 9、redis的key必须写在config.redis_key文件。（已执行，部分人未按标准执行）
- 10、composer安装新依赖必须写doc/composer.txt文件中，并说明用途。（已执行）
- 11、新增定时任务，进程必须写doc/crontab.txt文件中，并说明用途。（已执行）
- 12、redis必须有设置过期时间。否则存mysql，再缓存（新增）
- 13、model名字与表名一致（如：表q_user MODEL：QUser ）
- 14、请求外网地址，必须设置请求时长2s
- 15、redis不存储长期数据， 只用于缓存和临时数据存储（后期转移非常容易导致数据丢失）
二、mysql注意事项
新增表（负责人：刘军）
- 1、字符集utf8mb4 排序规范utf8mb4_unicode_ci（已执行，部分人未按标准执行）
- 2、数据库字段必须小写+下划线（已执行，部分人未按标准执行）
- 3、新表字段必须有status,created_at,updated_at（关联表经常漏掉三个字段）
- 4、status状态必须1启用， 0禁用
- 5、尽量不使用NULL
查询 - 1、查询sql字段必须加上表名（线上已出现过问题）
- 2、严禁使用*号查询
- 3、sql语句必须写model，不能写在控制器
更新、插入、删除 - 1、更新、插入、删除多条数据，非日志类型必须“采用事务”（保证一致性）
三、YAPI文档注意事项
- 1、字段说明必须与产品文档保持一致（前端反馈核对字段不清晰）
- 2、迭代版本接口需新增版本目录 （防止混乱）
- 3、接口有变更，必须同步更新接口文档
四、合并分支事项
- 1、必须以master创建分支开发，且带上自己的名字（origin/hotfix/huang/slowOpt）
- 2、发布至master，必须先合master到开发分支
- 3、“测试分支”禁止合并到“开发分支”
- 4、“预发布分支”禁止合并到“开发分支”
以上就是分享一份PHP开发内部规范的详细内容，更多请关注Work网其它相关文章！