DoitPHP 编码规范
一、引言 本规范基于 PHP PEAR 编码规范及 PHPDocumentor 注释规范等编程原则组成,融合并 提炼了开发人员长时间积累下来的成熟经验, 意在帮助形成良好一致的编程风格。 以达到在 团队协作中,事半功倍的开发效率。为了与时俱进,根据客观需求,本
文档会不定期更新。 作者:tommy < streen003@gmail >
版权:DoitPHP Group < doitphp > 更新日期:2010 年 9 月 23 日 二、适用范围 如无特殊说明,以下规则要求完全适用于 DoitPHP 项目(注:Doitphp 的 PHP 框架文件, 而非使用 DoitPHP 所开发的 PHP 项目)。如果你喜欢以下编码规范,也可以用在其它 PHP 开发项目。 三、 标准化的重要性和好处 “不以规矩,不成方圆” ,当一个
软件项目尝试着遵守公共一致的标准时,可以使参与 项目的开发人员更容易了解项目中的代码、 弄清程序的状况。 使新的参与者可以很快的适应 环境,防止部分参与者出于节省时间的需要,自创一套风格并养成终生的习惯,导致其它人 在阅读时浪费过多的时间和精力。而且在一致的环境下,也可以减少编码出错的机会。缺陷 是由于每个人的标准不同, 所以需要一段时间来适应和改变自己的编码风格, 暂时性的降底 了工作效率。 从使项目长远健康的发展以及后期更高的团队工作效率来考虑暂时的
工作效率 降低是值得的,也是必须要经过的一个过程。标准不是项目成功的关键,但可以帮助我们在 团队协作中有更高的效率并且更加顺利的完成既定的任务。 1. 程序员可以了解任何代码,弄清程序的状况 2. 新人可以很快的适应环境 3. 防止新接触 PHP 的人出于节省时间的需要,自创一套风格并养成终生的习惯 4. 防止新接触
PHP 的人一次次的犯同样的错误 5. 在一致的环境下,人们可以减少犯错的机会 6. 程序员们有了一致的敌人 四、 PHP 编码规范与原则 1、文件格式 1.1、文件编码:文件编码统一为 UTF-8(注:非 UTF-8+BOM)。 1.2、定界符:PHP 代码必须以完整的形式来定界即: “” 。而短定界符“ ?>” 将禁止使用。对于只含有 php 的代码文件,建议将文件结尾处的“?>”忽略掉,防止多余空 格或其它字符影响代码。 1.3、代码缩进:缩进将使用制表符,不推荐使用空格(通常的缩进由四个空格组成) 。 主要目的是:为了尽可能地简单,高效地编写代码。虽然在不同的编辑器里, TAB 制表符 的长度是不一样的,我们不会为了不必要的“编码优美”而牺牲
程序的开发效率。本缩进规 范也适用于
JavaScript 中的函数、类、逻辑结构、循环等。 1.4、代码长度:每行代码长度应控制在 80 个字符以内,最长不超过 120 个字符(具体
1
视实际情况而定,量力而行,情况特殊可以不遵守本规定) 。 1.5、代码内容:每行结尾不允许有多余的空格或 TAB 制表符(确保你的编辑器保存文 件为 Unix 格式,这意味着行是以换行符终止的) 。禁止一个 php 文件出现两个或多个类, 不过允许其它 php 代码存在。除了语言包注释配置文件,其它地方不能有中文。 1.6、代码注释:文件要有清晰的代码注释,注释风格采用 phpDocumentor 标准(相关 网址:phpdoc.org/) 2、命名约定 命名是程序规划的核心。 古人相信只要知道一个人真正的名字就会获得凌驾于那个人之 上的不可思议的力量。 只要你给事物想到正确的名字, 就会给你以及后来的人带来比代码更 强的力量。 名字就是事物在它所处的生态环境中一个长久而深远的结果。 总的来说, 只有了解系统 的程序员才能为
系统取出最合适的名字。如果所有的命名都与其自然相适合,则关系清晰, 含义可以推导得出,一般人的推想也能在意料之中。 就一般约定而言, 类、 函数和变量的名字应该总是能够描述让代码阅读者能够容易的知 道这些代码的作用。形式越简单、越有规则,就越容易让人感知和理解。应该避免使用模棱 两可,晦涩不标