php编码规则(一)

---恢复内容开始---

<转载自己整理>

GNU C 库（GNU C Library，又称为glibc）是一种按照LGPL许可协议发布的，公开源代码的，免费的，方便从网络下载的C的编译程序。 GNU C运行期库，是一种C函数库，是程序运行时使用到的一些API集合，它们一般是已预先编译好，以二进制代码形式存在Linux类系统中，GNU C运行期库，通常作为GNU C编译程序的一个部分发布。 它最初是自由软件基金会为其GNU操作系统所写，但目前最主要的应用是配合Linux内核，成为GNU/Linux操作系统一个重要的组成部分。

解释性语言是指,在执行时由相关程序实时读取程序语句,然后再编译执行的语言,这样的源程序多为文本文件。

命名规范

   除了类命名首字母大写和全局变量和常量全部用大写字母外，其余的命名都是全部小写字母且用_隔开。好的命名规范对程序的阅读是直观重要的。

1.1 标准化的重要

   标准化问题的确在某些方面上让每个人头痛，让人人都觉得大家处于同样的境地。但是这往 往是因为对标准化的误解。标准化不是束缚人，他是为了在大型开发过程中，能够提供项目整体的质量与开发进度。扔掉你的创造力，没人喜欢这样的创造力。

1.2 优点

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

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

· 新人可以很快的适应环境

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

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

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

· 程序员们有了一致的敌人

1.3 改进

规范并不是一成不变的，如果你觉得规范缺少东西或者有些不合适的地方，提出来，也许项目管理者会考虑加入，记住，任何项目都取决于团队合作的努力。

1.4 实施

一般情况下，规范的实施是由技术负责人或者项目经理执行和监督的。但是最好的方法还是在开发团队中达成共识，变成一种文化的存在。

2 命名规则

   命名是程序规划的核心。名字就是事物在它所处的生态环境中一个长久而深远的结果。

   总的来说，只有了解系统的程序员才能为系统取出最合适的名字。如果所有的命名都与其自然相适合，则关系清晰，含义可以推导得出，一般人的推想也能在意料之中。
   如果你发觉你的命名只有少量能和其对应事物相匹配的话， 最好还是重新好好再看看你的设计。

2.1 文件命名

文件名采用C GNU的惯例，所有的字母使用小写字母，使用`_`分割单词。

例如：

news_list.php

文件命名上有些几乎是约定俗成的单词，比如

admin前缀表示是后台管理的文件名,

inc.php后缀则表示包含文件或者类库文件，

class.php后缀表示类库文件

config.php表示配置文件等。

例如：

admin_user.php

data.inc.php

user.class.php

2.2 类命名

· 使用大写字母作为词的分隔，其他的字母均使用小写
· 名字的首字母使用大写
· 不要使用下划线(`_`)
例如
class NameOneTwo
class Name

注意：

· 在为类（class ）命名前首先要知道它是什么。如果看到类名，你还是想不起这个类是什么的话，那么你的设计就还做的不够好。
· 超过三个词组成的混合名是容易造成系统各个实体间的混淆，再看看你的设计，尝试使用（CRC Session card)看看该命名所对应的实体是否有着那么多的功用。
· 对于派生类的命名应该避免带其父类名产生关系，一个类的名字只与它自身有关，和它的父类叫什么无关。
· 有些后缀名是几乎是约定俗成的，例如：如果你的系统使用了代理（agent ），那么就把某个部件命名为“下载代理”（DownloadAgent）用以真正的传送信息。

    当然，这些约定俗成的词汇不会自动出现，需要小组人员的不断总结。

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

· 无论如何，当遇到以下情况，你可以用首字母大写其余字母小写来代替全部使用大写字母的方法来表示缩写词。
使用: GetHtmlStatistic.
不使用: GetHTMLStatistic.
理由
· 当命名含有缩略词时，人们似乎有着非常不同的直觉。统一规定是最好，这样一来，命名的含义就完全可以预知了。
举个NetworkABCKey的例子，注意C是应该是ABC里面的C还是key里面的C，这个是很令人费解的。有些人不在意这些，其他人却很讨厌这样。所以你会在不同的代码里看到不同的规则，使得你不知道怎么去叫它。
例如
class FluidOz // 不要写成 FluidOZ
class GetHtmlStatistic // 不要写成 GetHTMLStatistic

2.3 类库命名

· 目前命名空间正在越来越广泛的被采用，以避免不同厂商和团体类库间的类名冲突。
· 当尚未采用命名空间的时候，为了避免类名冲突，一般的做法是在类名前加上独特的前缀，两个字符就可以了，当然多用一些会更好。
例如
John Johnson的数据结构类库可以用Jj做为前缀，如下：
class JjLinkList
{
}
另一种折中方式是建立包含类库目录（事实上Java也是这么做的），以不通的目录代表不同的命名空间。
例如
Microsoft的数据库相关类库可以在：
/classes/com/Microsoft/ Database/DbConn.php
Apache的数据库相关类库可在：
/classes/org/apache/Database/DbConn.php

2.4 类属性命名

· 类属性采用C GNU的惯例，所有的字母使用小写字母，使用`_`分割单词。

例如
class NameOneTwo
{

function var_abc() {};

function error_number() {};

var $var;

var $error_number;

var $name;

}

2.5 方法命名

·函数名字采用C GNU的惯例，所有的字母使用小写字母，使用`_`分割单词。

例如
class NameOneTwo
{

function do_it() {};

function handle_error() {};

}

· 通常 每个方法都是执行一个动作的，所以对它们的命名应该清楚的说明它们是做什么的：用check_for_errors()代替error_check()， 用dump_data_to_file()代替data_file()。这么做也可以使功能和数据成为更可区分的物体。
· 有时后缀名是有用的:
o Max - 含义为某实体所能赋予的最大值。
o Cnt - 一个运行中的计数变量的当前值。
o Key - 键值。
例如：retry_max 表示最多重试次数，retry_cnt 表示当前重试次数。
· 有时前缀名是有用的：
o Is - 含义为问一个关于某样事物的问题。无论何时，当人们看到Is就会知道这是一个问题。
o Get - 含义为取得一个数值。
o Set - 含义为设定一个数值
例如：is_hit_retry_limit。

2.6 方法中参数命名

·函数名字采用C GNU的惯例，所有的字母使用小写字母，使用`_`分割单词。

例如
class NameOneTwo
{

function start_your_engines(

&$some_engine,

&$another_engine);

}

2.7 变量命名

· 所有字母都使用小写
· 使用`_`作为每个词的分界。
理由
· 通过这一途径，代码中变量的作用域是清晰的。
· 所有的变量在代码中都看起来不同，容易辨认。
例如
function handle_error($errorNumber)
{

$error = OsErr($errorNumber);

$time_of_error = $error->get_time_of_error();

$error_processor = $error->get_error_processor();
}

2.8全局常量

· 全局常量用`_`分隔每个单词,并且全部单词大写。

理由
这是命名全局常量的传统。你要注意不要与其它的定义相冲突。
例如
define("A_GLOBAL_CONSTANT", "Hello world!");

2.9 静态变量

· 静态变量应该带前缀‘s’。

理由
· 知道一个变量的作用域是非常重要的。
例如
function test()
{

static $msStatus = 0;

}

2.10 函数命名

· 函数名字采用C GNU的惯例，所有的字母使用小写字母，使用`_`分割单词。
理由

· 这样可以更易于区分相关联的类名。

例如

function some_bloody_function()
{

}

2.11 错误返回检测规则

· 检查所有的系统调用的错误信息，除非你要忽略错误。
· 为每条系统错误消息定义好系统错误文本以便include。

3 书写规则

3.1 大括号{}

在三种主要的大括号放置规则中，有两种是可以接受的，如下的第一种是最好的：
· 将大括号放置在关键词下方的同列处：

if ($condition)

{
... ...
}

while ($condition)
{
... ...
}
· 传统的UNIX的括号规则是，首括号与关键词同行，尾括号与关键字同列：
if ($condition) {

... ...

}

while ($condition) {
... ...
}

理由:

引起剧烈争论的非原则的问题可通过折衷的办法解决，两种方法任意一种都是可以接受的，然而对于大多数人来说更喜欢第一种。原因就是心理研究学习范畴的东西了。

对于更喜欢第一种还有着更多的原因。如果您使用的字符编辑器支持括号匹配功能的话（例 如vi），最重要的就是有一个好的样式。为什么？我们说当你有一大块的程序而且想知道这一大块程序是在哪儿结束的话。你先移到开始的括号，按下按钮编辑器 就会找到与之对应的结束括号，例如：

if ($very_long_condition && $second_very_long_condition)
{
...
}
else if (...)
{
...
}
从一个程序块移动到另一个程序块只需要用光标和你的括号匹配键就可以了，不需找匹配的括号。

3.2 缩进：制表符vs空格

在书写代码的时候，必须注意代码的缩进规则，我们规定：使用4个空格作为缩进，而不使用tab缩进（对于ultraedit，可以进行预先设置）。

·对于最大缩进层数，并没有一个固定的规矩，假如缩进层数大于四或者五层的时候，你可以考虑着将代码因数分解(factoring out code)。
理由
· 许多编程者支持制表符。 但制表符标准在各种编程工具下、各种平台下所代表的空格数或者意义是不同的。这样会使在一个平台下格式良好的代码在另一个平台下不堪入目。对于php的开发来说，通常情况下是在win平台下开发，linux下部署，尤其需要注意这个问题。
· 虽然此处没有限定最大的缩进层数，但是通常建议不要超过四层、五层。
例如：

function func()
{
if (something bad)
{
if (another thing bad)
{
while (more input)
{
}
}
}
}

3.3 小括号、关键词和函数

· 不要把小括号和关键词紧贴在一起，要用空格隔开它们。
· 小括号和函数名间没有空格；如$test = date("ymdhis")；
· 除非必要，不要在Return返回语句中使用小括号。
理由
· 关键字不是函数。如果小括号紧贴着函数名和关键字，二者很容易被看成是一体的。
例如
if (condition)
{
}

while (condition)
{
}

strcmp($s, $s1);

return 1;

3.4 类的构造函数

别在构造函数中做实际的工作， 构造函数应该包含变量的初始化和（或）不会发生失败的操作。
理由
· 构造不能返回错误 。

例如
class Device
{
function device() { /* initialize and other stuff */ }
function open() { return FAIL; }
};

$dev = new Device;
if (FAIL == $dev->open()) exit(1);

3.5 ＝符号书写

在程序中=符号的书写遵循以下规则：

（1）在=符号的两侧，均需留出一个空格；如$a = $b 、if ($a = = $b)等；

（2）在一个申明块，或者实现同样功能的一个块中，要求=号尽量上下对齐，左边可以为了保持对齐使用多个空格，而右边要求空一个空格；如下例：

$testa   = $aaa;

$testaa = $bbb;

3.6 控制结构

3.6.1 if then else 格式

不同的花括号样式会产生些微不同的样观。一个通用方式是：
if (条件1) // 注释
{
}
else if (条件2) // 注释
{
}
else // 注释
{
}
如果你有用到else if 语句的话，通常最好有一个else块以用于处理未处理到的其他情况。可以的话放一个记录信息注释在else处，即使在else没有任何的动作。

·总是将恒量放在等号/不等号的左边，例如：
if ( 6 == $errorNum ) ...
一个原因是假如你在等式中漏了一个等号，语法检查器会为你报错。第二个原因是你能立刻找到数值而不是在你的表达式的末端找到它。需要一点时间来习惯这个格式，但是它确实很有用。

3.6.2 switch 格式

· 当一个case块处理后，直接转到下一个case块处理，在这个case块的最后应该加上注释。
· default case总应该存在，它应该不被到达，然而如果到达了就会触发一个错误。
· 如果你要创立一个变量，那就把所有的代码放在块中。
例如
switch (...)
{
case 1:
...
// FALL THROUGH
case 2:
{
$v = get_week_number();
...
}
break;

default:
}

3.6.3 continue 和 break

continue 和 break 其实是变相的隐蔽的 goto方法。（goto 一般就是跳出循环的方法）
continue 和 break 像 goto 一样，它们在代码中是有魔力的，所以要节俭（尽可能少）的使用它们。使用了这一简单的魔法，由于一些未公开的原因，读者将会被定向到只有上帝才知道的地方去。
continue有两个主要的问题：
· 它可以绕过测试条件。
· 它可以绕过等/不等表达式。
看看下面的例子，考虑一下问题都在哪儿发生：
while (TRUE)
{
...
// A lot of code
...
if (/* some condition */) {
continue;
}
...
// A lot of code
...
if ( $i++ > STOP_VALUE) break;
}
注意："A lot of code"是必须的，这是为了让程序员们不能那么容易的找出错误。
通过以上的例子，我们可以得出更进一步的规则：continue 和 break 混合使用是引起灾难的正确方法。

3.6.4 ?:

?:本身没什么问题，问题在于人们往往试着在 ? 和 : 之间塞满了许多的代码。以下的是一些清晰的连接规则：
· 把条件放在括号内以使它和其他的代码相分离。
· 如果可能的话，动作可以用简单的函数。
· 把所做的动作，“?”，“:”放在不同的行，除非他们可以清楚的放在同一行。
例如
(condition) ? funct1() : func2();

or

(condition)
? long statement
: another long statement;

http://blog.csdn.net/crown00000/article/details/7256908（摘自）