PHP程序编码规范标准20020123.docVIP

PHPCodingStandard PAGE28

?Copyright1995-2001.ToddHoffandFredrikKristiansen.Allrightsreserved.

PHP程序编码规范标准

最后修改日期:2002-01-23

PHP编程标准是经由ToddHoff许可，基于《C++编程标准》为PHP而重写的，

作者为FredrikKristiansen，

使用本标准，如果您想拷贝一份留做自用的话，那是完全免费的，这也是我们制作它的原因。假如您发现了任何的错误又或者是有任何的改进，请您给笔者发一个email，以便笔者将它们合并到最新更新中去。

目录

介绍

标准化的重要性

解释

认同观点

命名规则

合适的命名

缩写词不要全部使用大写字母

类命名

类库命名

方法命名

类属性命名

方法中参数命名

变量命名

引用变量和函数返回引用

全局变量

定义命名/全局常量

静态变量

函数命名

php文件扩展名

文档规则

评价注释

CommentsShouldTellaStory

DocumentDecisions

使用标头说明

MakeGotchasExplicit

InterfaceandImplementationDocumentation

目录文档

复杂性管理规则

层

Open/ClosedPrinciple

severconfiguration

类规则

DifferentAccessorStyles

别在对象架构期做实际的工作

Thinvs.FatClassInterfaces

短方法

进程规则

UseaDesignNotationandProcess

CodeReviews

CreateaSourceCodeControlSystemEarlyandNotOften

CreateaBugTrackingSystemEarlyandNotOften

HonorResponsibilities

格式化

大括号{}规则

缩进/制表符/空格规则

小括号、关键词和函数规则

IfThenElse格式

switch格式

continue,break和?的使用

每行一个语句

声明块的定位

杂项

不要不可思议的数字

错误返回检测规则

不要采用缺省值测试非零值

布尔逻辑类型

通常避免嵌入式的赋值

重用您和其他人的艰苦工作

使用if(0)来注释外部代码块

其他杂项

PEAR编码标准

Pear-Indenting_

Pear-ControlStructures_

Pear-FunctionCalls

Pear-FunctionDefinitions

Pear-Comments_

Pear-IncludingCodes

Pear-PHPCodeTags_

Pear-HeaderCommentBlocks_

Pear-UsingCVS

Pear-ExampleURLs

Pear-NamingConventions_

介绍

标准化的重要性

标准化问题在某些方面上让每个人头痛，让人人都觉得大家处于同样的境地。这有助于让这些建

议在许多的项目中不断演进，许多公司花费了许多星期逐子字逐句的进行争论。标准化不是特殊

的个人风格，它对本地改良是完全开放的。

优点

当一个项目尝试着遵守公用的标准时，会有以下好处：

程序员可以了解任何代码，弄清程序的状况

新人可以很快的适应环境

防止新接触php的人出于节省时间的需要，自创一套风格并养成终生的习惯

防止新接触php的人一次次的犯同样的错误

在一致的环境下，人们可以减少犯错的机会

程序员们有了一致的敌人:-)

缺点

现在轮到坏处了:

因为标准由一些不懂得php的人所制定，所以标准通常看上去很傻

因为标准跟我做的不一样，所以标准通常看上去很傻

标准降低了创造力

标准在长期互相合作的人群中是没有必要的

标准强迫太多的格式

总之人们忽视标准

讨论

许多项目的经验能得出这样的结论：采用编程标准可以使项目更加顺利地完成。标准是成功的关

键么？当然不。但它们可以