从linux kernel coding style看php代码规范
作者:admin 日期:2010-02-04
linux内核的编码是一种极端情况。
需要清晰明朗以供全世界的开发者学习、修改,对代码的质量要求较高。
相信linus大神在长期接触各种各式代码后脾气会变得更暴躁,就比如前段时间在某论坛痛斥C++。。。
节选,去除不适合PHP程序员阅读的部分。
如果你开发PHP程序的核心代码,比如框架,尤其建议好好思考。
虽然,它和一些权威的代码规范比如discuz和zend的有所冲突,但是依然能从中受益。
linux kernel coding style (针对PHPer作了节选)
linux kernel coding style的中文译者:
中文版维护者: 张乐 Zhang Le
中文版翻译者: 张乐 Zhang Le
中文版校译者: 王聪 Wang Cong
wheelz
管旭东 Xudong Guan
Li Zefan
Wang Chen
第一章:缩进
制表符是8个字符,所以缩进也是8个字符。有些异端运动试图将缩进变为4(乃至2)个字符深,这几乎相当于尝试将圆周率的值定义为3。
理由:缩进的全部意义就在于清楚的定义一个控制块起止于何处。尤其是当你盯着你的屏幕连续看了20小时之后,你将会发现大一点的缩进会使你更容易分辨缩进。
现在,有些人会抱怨8个字符的缩进会使代码向右边移动的太远,在80个字符的终端屏幕上就很难读这样的代码。这个问题的答案是,如果你需要3级以上的缩进,不管用何种方式你的代码已经有问题了,应该修正你的程序。
在switch语句中消除多级缩进的首选的方式是让“switch”和从属于它的“case”标签对齐于同一列,而不要“两次缩进”“case”标签。比如:
C++代码
switch (suffix) {
case 'G':
case 'g':
mem <<= 30;
break;
case 'M':
case 'm':
mem <<= 20;
break;
case 'K':
case 'k':
mem <<= 10;
/* fall through */
default:
break;
}不要把多个语句放在一行里,除非你有什么东西要隐藏:
C++代码
if (condition) do_this;
do_something_everytime;
也不要在一行里放多个赋值语句。内核代码风格超级简单。就是避免可能导致别人误读的表达式。
除了注释、文档和Kconfig之外,不要使用空格来缩进,前面的例子是例外,是有意为之。
选用一个好的编辑器,不要在行尾留空格。
第二章:把长的行和字符串打散
代码风格的意义就在于使用平常使用的工具来维持代码的可读性和可维护性。
每一行的长度的限制是80列,我们强烈建议您遵守这个惯例。
长于80列的语句要打散成有意义的片段。每个片段要明显短于原来的语句,而且放置的位置也明显的靠右。同样的规则也适用于有很长参数列表的函数头。长字符串也要打散成较短的字符串。唯一的例外是超过80列可以大幅度提高可读性并且不会隐藏信息的情况。
C++代码
void fun(int a, int b, int c)
{
if (condition)
printk(KERN_WARNING "Warning this is a long "
"3 parameters a: %u b: %u "
"c: %u n", a, b, c);
else
next_statement;
}
第三章:大括号和空格的放置
C语言风格中另外一个常见问题是大括号的放置。和缩进大小不同,选择或弃用某种放置策略并没有多少技术上的原因,不过首选的方式,就像Kernighan和Ritchie展示给我们的,是把起始大括号放在行尾,而把结束大括号放在行首,所以:
C++代码
if (x is true) {
we do y
}
这适用于所有的非函数语句块(if、switch、for、while、do)。比如:
C++代码
switch (action) {
case KOBJ_ADD:
return "add";
case KOBJ_REMOVE:
return "remove";
case KOBJ_CHANGE:
return "change";
default:
return NULL;
}
需要清晰明朗以供全世界的开发者学习、修改,对代码的质量要求较高。
相信linus大神在长期接触各种各式代码后脾气会变得更暴躁,就比如前段时间在某论坛痛斥C++。。。
节选,去除不适合PHP程序员阅读的部分。
如果你开发PHP程序的核心代码,比如框架,尤其建议好好思考。
虽然,它和一些权威的代码规范比如discuz和zend的有所冲突,但是依然能从中受益。
linux kernel coding style (针对PHPer作了节选)
linux kernel coding style的中文译者:
中文版维护者: 张乐 Zhang Le
中文版翻译者: 张乐 Zhang Le
中文版校译者: 王聪 Wang Cong
wheelz
管旭东 Xudong Guan
Li Zefan
Wang Chen
第一章:缩进
制表符是8个字符,所以缩进也是8个字符。有些异端运动试图将缩进变为4(乃至2)个字符深,这几乎相当于尝试将圆周率的值定义为3。
理由:缩进的全部意义就在于清楚的定义一个控制块起止于何处。尤其是当你盯着你的屏幕连续看了20小时之后,你将会发现大一点的缩进会使你更容易分辨缩进。
现在,有些人会抱怨8个字符的缩进会使代码向右边移动的太远,在80个字符的终端屏幕上就很难读这样的代码。这个问题的答案是,如果你需要3级以上的缩进,不管用何种方式你的代码已经有问题了,应该修正你的程序。
在switch语句中消除多级缩进的首选的方式是让“switch”和从属于它的“case”标签对齐于同一列,而不要“两次缩进”“case”标签。比如:
C++代码
switch (suffix) {
case 'G':
case 'g':
mem <<= 30;
break;
case 'M':
case 'm':
mem <<= 20;
break;
case 'K':
case 'k':
mem <<= 10;
/* fall through */
default:
break;
}不要把多个语句放在一行里,除非你有什么东西要隐藏:
C++代码
if (condition) do_this;
do_something_everytime;
也不要在一行里放多个赋值语句。内核代码风格超级简单。就是避免可能导致别人误读的表达式。
除了注释、文档和Kconfig之外,不要使用空格来缩进,前面的例子是例外,是有意为之。
选用一个好的编辑器,不要在行尾留空格。
第二章:把长的行和字符串打散
代码风格的意义就在于使用平常使用的工具来维持代码的可读性和可维护性。
每一行的长度的限制是80列,我们强烈建议您遵守这个惯例。
长于80列的语句要打散成有意义的片段。每个片段要明显短于原来的语句,而且放置的位置也明显的靠右。同样的规则也适用于有很长参数列表的函数头。长字符串也要打散成较短的字符串。唯一的例外是超过80列可以大幅度提高可读性并且不会隐藏信息的情况。
C++代码
void fun(int a, int b, int c)
{
if (condition)
printk(KERN_WARNING "Warning this is a long "
"3 parameters a: %u b: %u "
"c: %u n", a, b, c);
else
next_statement;
}
第三章:大括号和空格的放置
C语言风格中另外一个常见问题是大括号的放置。和缩进大小不同,选择或弃用某种放置策略并没有多少技术上的原因,不过首选的方式,就像Kernighan和Ritchie展示给我们的,是把起始大括号放在行尾,而把结束大括号放在行首,所以:
C++代码
if (x is true) {
we do y
}
这适用于所有的非函数语句块(if、switch、for、while、do)。比如:
C++代码
switch (action) {
case KOBJ_ADD:
return "add";
case KOBJ_REMOVE:
return "remove";
case KOBJ_CHANGE:
return "change";
default:
return NULL;
}
评论: 0 | 查看次数: 6841