腾讯PHP开发规范v1.0.docVIP

OMG网络媒体技术部 海豹平台开发规范v1.0 海豹平台开发规范v1.0 腾讯科技（深圳）有限公司 *版本信息保密等级 版本 更改日期 更改要点说明 编制 审核 批准 V1.0 2014/12/24 新建 wilsonwsong V1.1 2014/12/26 修订 rusherding 文档保密等级： □机密 ■内部 □公开  目 录 TOC \o 1-3 \h \z \u 654 海豹平台开发规范v1.0 1 9554 1 引言 5 8776 1.1 定义及缩略语 5 15633 1.2 参考文档 5 13158 1.3 目的 5 18764 1.4 适用范围 5 30237 1.5 标准化作用 5 22674 2 目录结构规范 6 6441 2.1 框架路径 6 30579 2.2 应用目录结构 6 13459 2.2.1 配置config 7 3238 2.2.2 控制器controllers 7 20422 2.2.3 模型models 7 30542 2.2.4 视图views 8 29999 2.2.5 国际化messages 8 2196 2.2.6 组件components 8 10234 2.2.7 命令commands 8 31476 2.2.8 临时目录runtime 8 29874 2.3 路径别名 8 23778 2.3.1 类型导入 8 23492 3 PHP编码规范 9 20922 3.1 标签 9 3382 3.2 编码 9 25369 3.3 注释 9 26394 3.3.1 文件注释 9 11790 3.3.2 类注释 10 29818 3.3.3 方法注释 10 21192 3.3.4 属性注释 11 22746 3.3.5 其它 11 675 3.4 命名规则 11 13435 3.4.1 文件 11 10187 3.4.2 类 12 12291 3.4.3 函数/方法 12 15055 3.4.4 变量名 12 4676 3.4.5 常量名 12 15821 3.5 书写规则 13 6437 3.5.1 文件 13 21041 3.5.2 行 13 22278 3.5.3 缩进 13 17676 3.5.4 控制结构 13 8214 3.5.5 运算符 16 3990 3.5.6 引号 16 12139 3.5.7 关键词 17 29788 3.5.8 函数 17 10727 3.5.9 类 17 26397 3.5.10 属性 18 5416 3.5.11 方法 18 7279 4 数据库命名规范 20 19222 4.1 命名规范 20 18330 4.2 实体命名 20 30418 4.2.1 前缀命名 20 83 4.2.2 后缀命名 21 19973 4.3 字段命名 21 22329 4.3.1 后缀命名 22 4594 4.4 字段类型 22 5948 4.4.1 数值类型 22 32171 4.4.2 字符类型 23 25444 4.4.3 时间类型 23 13147 4.4.4 ENUMSET 23 7044 4.4.5 LOB 类型 23 2186 4.5 表结构设计 24 2022 4.5.1 适度冗余 24 20923 4.5.2 尽量使用NOT NULL 24 2800 4.5.3 索引 24 4065 5 附件 24 20816 5.1 附录一：MYSQL保留字 24  引言 定义及缩略语 缩略词 说明 海豹平台 运维中心提供的研发平台，提供框架、公共基础组件、公共业务组件加速业务的日常研发工作 参考文档 海豹平台WIKI： / 目的 本规范由编程原则组成，融合并提炼了开发人员长时间积累下来的成熟经验，意在帮助形成良好一致的编程风格。以达到事半功倍的效果，如果有需要本文档会不定期更新。 适用范围 如无特殊说明，以下规则要求完全适用于基于海豹平台框架开发的应用，同时也可大部分适用于部门其他PHP项目。 标准化作用 当一个软件项目尝试着遵守公共一致的标准时，可以使参与项目的开发人员更容易了解项目中的代码、弄清程序的状况。使新的参与者可以很快的适应环境，防止部分参与者出于节省时间的需要，自创一套风格并养成终生的习惯，导致其它人在阅读时浪费过多的时间和精力。而且在一致的环境下，也可以减少编码出错的机会。 缺陷是由于每个人的标准不同，所以需要一段时间来适应和改变自己的编码风格