[转帖]经典：PHP编码规范（一）

来源：http://www.chinaphp.com ----------------------------- 1. 介绍  1.1. 标准化的重要**  标准化问题在某些方面上让每个人头痛，让人人都觉得大家处于同样的境地。这有助于让这些建议在许多的项目中不断演进，许多公司花费了许多星期逐子字逐句的进行争论。标准化不是特殊的个人风格，它对本地改良是完全开放的。  1.2. 优点  当一个项目尝试着遵守公用的标准时，会有以下好处：  · 程序员可以了解任何代码，弄清程序的状况  · 新人可以很快的适应环境  · 防止新接触php的人出于节省时间的需要，自创一套风格并养成终生的习惯  · 防止新接触php的人一次次的犯同样的错误  · 在一致的环境下，人们可以减少犯错的机会  · 程序员们有了一致的敌人  1.3. 缺点  · 因为标准由一些不懂得php的人所制定，所以标准通常看上去很傻  · 因为标准跟我做的不一样，所以标准通常看上去很傻  · 标准降低了创造力  · 标准在长期互相合作的人群中是没有必要的  · 标准强迫太多的格式  1.4. 讨论  许多项目的经验能得出这样的结论：采用编程标准可以使项目更加顺利地完成。标准是成功的关键么？当然不。但它们可以帮助我们，而且我们需要我们能得到的所有的帮助！老实说，对一个细节标准的大部分争论主要是源自自负思想。对一个合理的标准的很少决定能被说为是缺乏技术**的话，那只是口味的原因罢了。所以，要灵活的控制自负思想，记住，任何项目都取决于团队合作的努力。  1.5. 解释  1.5.1. 标准实施  首先应该在开发小组的内部找出所有的最重要的元素，也许标准对你的状况还不够恰当。它可能已经概括了 重要的问题，也可能还有人对其中的某些问题表示强烈的反对。无论在什么情况下，只要最后顺利的话，人们将成熟的明白到这个标准是合理的，然后其他的程序员们也会发现它的合理**，并觉得带着一些保留去遵循这一标准是值得的。如果没有自愿的合作，可以制定需求：标准一定要经过代码的检验。如果没有检验的话，这个解决方案仅仅是一个建立在不精确的基础上的一大群可笑的人。  1.5.2. 认同观点  1. 这行不通；  2. 也许可行吧，但是它既不实用又无聊；  3. 这是真的，而且我也告诉过你啊；  4. 这个是我先想到的；  5. 本来就应该这样。  如果您带着否定的成见而来看待事物的话，请您保持开放的思想。你仍可以做出它是废话的结论，但是做出结论的方法就是你必须要能够接受不同的思想。请您给自己一点时间去做到它。  1.5.3. 项目的四个阶段  1. 数据库结构  2. 设计  3. 数据层  4. HTML层  2. 命名规则  2.1. 合适的命名 命名是程序规划的核心。古人相信只要知道一个人真正的名字就会获得凌驾于那个人之上的不可思议的力量。只要你给事物想到正确的名字，就会给你以及后来的人带来比代码更强的力量。别笑！  名字就是事物在它所处的生态环境中一个长久而深远的结果。总的来说，只有了解系统的程序员才能为系统取出最合适的名字。如果所有的命名都与其自然相适合，则关系清晰，含义可以推导得出，一般人的推想也能在意料之中。  如果你发觉你的命名只有少量能和其对应事物相匹配的话， 最好还是重新好好再看看你的设计吧。  2.2. 类命名  · 在为类（class ）命名前首先要知道它是什么。如果通过类名的提供的线索，你还是想不起这个类是什么的话，那么你的设计就还做的不够好。  · 超过三个词组成的混合名是容易造成系统各个实体间的混淆，再看看你的设计，尝试使用（CRC Session card)看看该命名所对应的实体是否有着那么多的功用。  · 对于派生类的命名应该避免带其父类名的诱惑，一个类的名字只与它自身有关，和它的父类叫什么无关。  · 有时后缀名是有用的，例如：如果你的系统使用了代理（agent ），那么就把某个部件命名为“下载代理”（DownloadAgent）用以真正的传送信息。  2.3. 方法和函数命名  · 通常每个方法和函数都是执行一个动作的，所以对它们的命名应该清楚的说明它们是做什么的：用CheckForErrors()代替ErrorCheck()，用DumpDataToFile()代替DataFile()。这么做也可以使功能和数据成为更可区分的物体。  · 有时后缀名是有用的:  o Max - 含义为某实体所能赋予的最大值。  o Cnt - 一个运行中的计数变量的当前值。  o Key - 键值。  例如：RetryMax 表示最多重试次数，RetryCnt 表示当前重试次数。  · 有时前缀名是有用的：  o Is - 含义为问一个关于某样事物的问题。无论何时，当人们看到Is就会知道这是一个问题。  o Get - 含义为取得一个数值。  o Set - 含义为设定一个数值  例如：IsHitRetryLimit。  2.4. 缩写词不要全部使用大写字母  · 无论如何，当遇到以下情况，你可以用首字母大写其余字母小写来代替全部使用大写字母的方法来表示缩写词。  使用: GetHtmlStatistic.  不使用: GetHTMLStatistic.  理由  · 当命名含有缩略词时，人们似乎有着非常不同的直觉。统一规定是最好，这样一来，命名的含义就完全可以预知了。  举个NetworkABCKey的例子，注意C是应该是ABC里面的C还是key里面的C，这个是很令人费解的。有些人不在意这些，其他人却很讨厌这样。所以你会在不同的代码里看到不同的规则，使得你不知道怎么去叫它。  例如  class FluidOz // 不要写成 FluidOZ  class GetHtmlStatistic // 不要写成 GetHTMLStatistic  2.5. 类命名  · 使用大写字母作为词的分隔，其他的字母均使用小写  · 名字的首字母使用大写  · 不要使用下划线('_')  理由  · 根据很多的命名方式，大部分人认为这样是最好的方式。  例如  class NameOneTwo  class Name  2.6. 类库命名  · 目前命名空间正在越来越广泛的被采用，以避免不同厂商和团体类库间的类名冲突。  · 当尚未采用命名空间的时候，为了避免类名冲突，一般的做法是在类名前加上独特的前缀，两个字符就可以了，当然多用一些会更好。  例如  John Johnson的数据结构类库可以用Jj做为前缀，如下：  class JjLinkList  {  }  另一种折中方式是建立包含类库目录（事实上Java也是这么做的），以不通的目录代表不同的命名空间。  例如  Microsoft的数据库相关类库可以在：  /classes/com/Microsoft/ Database/DbConn.php  Apache的数据库相关类库可在：  /classes/org/apache/Database/DbConn.php  2.7. 方法命名  · 采用与类命名一致的规则  理由  · 使用所有不同规则的大部分人发现这是最好的折衷办法。  例如  class NameOneTwo  {  function DoIt() {};  function HandleError() {};  }  2.8. 类属**命名  · 属**命名应该以字符‘m’为前缀。  · 前缀‘m’后采用于类命名一致的规则。  · ‘m’总是在名字的开头起修饰作用，就像以‘r’开头表示引用一样。  理由  · 前缀'm'防止类属**和方法名发生任何冲突。你的方法名和属**名经常会很类似，特别是存取元素。  例如  class NameOneTwo  {  function VarAbc() {};  function ErrorNumber() {};  var $mVarAbc;  var $mErrorNumber;  var $mrName;  }  2.9. 方法中参数命名  · 第一个字符使用小写字母。  · 在首字符后的所有字都按照类命名规则首字符大写。  理由  · 可以区分方法中的一般变量。  · 你可以使用与类名相似的名称而不至于产生重名冲突。  例如  class NameOneTwo  {  function StartYourEngines(  &$rSomeEngine,  &$rAnotherEngine);  }  2.10. 变量命名  · 所有字母都使用小写  · 使用'_'作为每个词的分界。  理由  · 通过这一途径，代码中变量的作用域是清晰的。  · 所有的变量在代码中都看起来不同，容易辨认。  例如  function HandleError($errorNumber)  {  $error = OsErr($errorNumber);  $time_of_error = OsErr->GetTimeOfError();  $error_processor = OsErr->GetErrorProcessor();  }  2.11. 引用变量和函数返回引用  · 引用必须带‘r’前缀  理由  · 使得类型不同的变量容易辨认  · 它可以确定哪个方法返回可更改对象，哪个方法返回不可更改对象。  例如  class Test  {  var mrStatus;  function DoSomething(&$rStatus) {};  function &rStatus() {};  }  2.12. 全局变量  · 全局变量应该带前缀‘g’。  理由  · 知道一个变量的作用域是非常重要的。  例如  global $gLog;  global &$grLog;  2.13. 定义命名 / 全局常量  · 全局常量用'_'分隔每个单词。  理由  这是命名全局常量的传统。你要注意不要与其它的定义相冲突。  例如  define("A_GLOBAL_CONSTANT", "Hello world!");  2.14. 静态变量  · 静态变量应该带前缀‘s’。  理由  · 知道一个变量的作用域是非常重要的。  例如  function test()  {  static $msStatus = 0;  }