ECSHOP编码命名规范

ECSHOP编码规范1.编辑器设定1.1. 缩进所有的缩进使用空格取代Tab制表符。

PHP文件采用4个空格的缩进，HTML文件以及HTML文件中嵌入的Javascript代码采用2个空格的缩进；单独的Javascript以及CSS文件采用4个空格的缩进。

1.2. 字符编码所有PHP、HTML文件均保存为No Bom UTF-8的字符编码。

变量名应当全部小写，并且词语之间以单个下划线分隔。

例如：$current_user 是正确的，但是$currentuser 和$CurrentUser 就不正确。

名称应当是描述性的，并且简明。

我们自然不希望使用冗长的句子作为变量名，但是多输入几个字符总好于疑惑于某个变量到底是干什么用的。

1.3. 循环计数器允许使用一个单字符变量名的唯一情形是当它作为一个循环计数器的时候。

在这种情况下，外层循环的计数器应当始终是$i。

如果有一个循环处于这个循环的内部，它的计数器应当是$j，进而是$k，等等。

如果循环的计数器是一个已经存在并且名字有意义的变量，本规范并不适用。

例如：for ($i = 0; $i < $outer_size; $i++){for ($j = 0; $j < $inner_size; $j++){foo($i, $j);}}1.4. 函数名称函数也应该描述性地命名。

这里我们并非在用C 编程，我们不希望写出诸如“stristr()”此类的函数来。

同上，使用单词间用单下划线分隔的小写名称。

函数名称中某处最好有一个动词。

较好的函数名称如print_login_status()，get_user_data()，等等。

1.5. 函数参数参数遵循和变量名字相同的约定。

我们不希望一堆这样的函数：do_stuff($a, $b, $c)。

在大部分情况下，我们希望仅仅看看函数的声明，就知道怎样使用它。

1.6. 类的名称类的名称首先必须是一个有意义的英文单词或者词组。

同时在书写格式上为了使类名和函数、变量有一个区别，我们要求类的名称全小写的写法，并且加上cls_作为前缀。

例如：/* 错误的写法 *class image_handle {}class imagehandle {}class imageHandle {}/* 正确的写法 *class cls_imagehandle {}1.7. 总结这里的基本哲学是不要为了偷懒而伤害了代码的清晰。

但是，必须由一些常识来掌握这种平衡；例如，print_login_status_for_a_given_user() 做得就过火了——这个函数命名为print_user_login_status() 更好些，或只是print_login_status()。

2.代码布局这里是一个头部的模板，所有的PHP文件的开始都必须包含下面的内容：/*** ECSHOP 升级程序之控制器*================================================================= ===========* 版权所有 (C) 2005-2007 康盛创想（北京）科技有限公司，并保留所有权利。

* 网站地址: *----------------------------------------------------------------------------* 这是一个免费开源的软件；这意味着您可以在不用于商业目的的前提下对程序代码 * 进行修改、使用和再发布。

*================================================================= ===========* $Author$* $Date$* $Id$*/2.1. 注释的写法根据流行的注释写法我们要求对于代码段的注释采用以下的方式来书写：/* 注释内容 */对于单行的注释则使用下面的注释形式，注意在//之后有一个空格：define(…IN_ECS‟, ture); // 注释内容2.2. 始终包含大括号这是因为懒于多敲两个字符而给代码清晰带来问题的又一个情形。

尽管有些结构的主体部分只有一行，千万不要丢掉大括号。

绝对不要。

例如：/* 这些都错了 */if (condition) do_stuff();if (condition)do_stuff();while (condition)do_stuff();for ($i = 0; $i < size; $i++)do_stuff($i);/* 这些是对的 */if (condition){do_stuff();}while (condition){do_stuff();}for ($i = 0; $i < size; $i++){do_stuff();}2.3. 大括号放在哪儿这一点是网络上争论比较多的一部分，但是我们将使用一种可以用一句话总结的风格：大括号始终独占一行。

终止大括号还应当与起始大括号处在同一列上。

例如：if (condition){while (condition2){...}}else{...}for ($i = 0; $i < $size; $i++){...}while (condition){...}function do_stuff(){...}2.4. 符号之间使用空格这是不用太费事就可以保持代码可读性的另一个简单，容易的步骤。

无论何时你写一个赋值，表达式，等等，始终在符号之间保留一个空格。

基本上，把代码当作英语来写。

在变量名和运算符之间插入空格。

不要在起始括弧后或者终止括弧前加空格。

不要在逗号或者分号之前加空格。

一些例子很好地展示了这一点。

例如：/* 每一对给出了错误方式，紧跟正确方式。

*/$i=0;$i = 0;if($i<7) ...if ($i < 7) ...if ( ($i < 7)&&($j > 8) ) ...if (($i < 7) && ($j > 8)) ...do_stuff( $i, "foo", $b );do_stuff($i, "foo", $b);for($i=0; $i<$size; $i++) ...for($i = 0; $i < $size; $i++) ...$i=($j < $size)?0:1;$i = ($j < $size) ? 0 : 1;2.4.1.字符串连接符当使用字符串连接符时必须在句点（.）两侧加上空格。

// 错误的写法$str = …<img src=”‟.$thumb_url.‟” />‟;$str = …<img src=”‟ .$thumb_url. …”/>‟;// 正确的写法$str = …<img src=”‟ . $thumb_url . …” />‟;2.5. 运算符优先级你知道PHP 中所有运算符的详细的优先级吗？我也不知道。

不要猜。

始终用括号强制一个表达式的优先级可以使优先级明显，这样你知道它会做些什么。

例如：/* 结果是什么？谁知道？ */$bool = ($i < 7 && $j > 8 || $k == 4);/* 现在你确定这里我在做什么了。

*/$bool = (($i < 7) && (($j < 8) || ($k == 4)))2.6. 空行的使用谁也不愿意看到挤在一堆的无序的代码。

我们在写代码的时候总是会利用一些空行来增加代码可读性。

合理的利用空格来区分代码段会使代码的逻辑思路更加明确。

我们强行规定的空行有以下两种情况：1、<?php 之后必须有且只有1个空行2、?> 之前必须有且只有1个空行3、两个函数之间必须有1个空行。

4、return、die、exit之前如果有其他语句的情况下应加上一个空行。

在代码中我们不允许仅有空格的空行，并且不允许在行尾有多余的空格。

3.SQL 语句3.1. SQL 代码布局既然我们都在使用不同的编辑器设置，不要尝试去做诸如在SQL 代码中实现列对齐此类的麻烦事。

要做的是，不管用何种方法，把语句断行到它们单独的行上去。

这里有一个SQL 代码看上去应该是什么样子的示例。

注意在哪里断行，大写，和括号的用法。

例如：SELECT field1 AS something, field2, field3FROM `table` a, `table` bWHERE (this = that) AND (this2 = that2)3.2. 表名和字段值SQL语句中的表名必须使用`符号包含起来；同时所有字段值的变量名必须包含在单引号之内，即便是整数值也必须有单引号。

例如：// 这是错误的INSERT INTO mytable (col1, col2, col3)VALUES ($val1, $val2, $val3)// 这是正确的INSERT INTO `mytable` (col1, col2, col3)VALUES (…$val1‟, …$val2‟, …$val3‟)3.3. SQL select 语句在已知需要查询的字段的前提下，不允许使用如下的代码：SELECT * FROM `mytable`取而代之的写法是将每一个字段名写上去，请不要偷懒。

SELECT col1, col2, col3 FROM `mytable`在需要获得已知记录数量情况下，请使用LIMIT offset, count 的方式，尽量不要使用无LIMIT 的SELECT 语句。

在需要或者满足条件的记录数量的情况下，请使用SELECT count(*|expr) FROM 的方式，尽量不要使用SELECT expr FROM 的方式。

需要进行逻辑运算的时候，尽量不要使用不等于，可以使用大于或者小于的方式。

3.4. SQL insert 语句SQL INSERT 语句可以写成两种不同方式。

或者你明确指明要插入的列，或者你已经知道数据中各列的顺序，不用详细指定它们。

我们希望使用前一种方法，也就是详细说明插入哪些列。

这意味着应用程序代码不会依赖于数据库中字段的顺序，也不会因为我们增加另外的字段而崩溃（当然，除非它们被指定为NOT NULL）。

例如：# 这不是我们想要的INSERT INTO `mytable`VALUES ('something', 1, 'else')# 这是正确的。