记录Harde学习成长生活的点点滴滴.
« »
2010-01-03
PHP

37 次浏览

PHP编码规范

编码规范有什么用这个问题我想就不用提了吧……
本文分两部分
第一部分简单说下HTML的书写规范

第二部分是PHP的编码规范
不愿意看第一部分的
可以点击我直接跳到PHP编码规范


html

1、标签、属性全部小写、标签必须闭合
2、除同一标签的闭合标签,尽量不要写在一行,换行时注意缩进
例:一个table

1
2
3
4
5
<table>
    <tr>
        <td>我是内容</td>
    </tr>
</table>


3、正确的标签嵌套
例:

1
2
3
<div>
    <p>我是内容</div>
</p>

是不允许的

4、属性值需用半角双引号引起,若因嵌套原因则也应适用半角单引号引起

1
2
3
4
5
<table border="1">
    <tr>
        <td colspan="2">我是内容</td>
    </tr>
</table>

5、有良好的注释习惯

1
2
3
4
5
6
<!--头部广告-->
<table border="1">
    <tr>
        <td colspan="2">我是广告</td>
    </tr>
</table>


PHP编码规范

1、代码标记
PHP可以使用

1
2
<?php ?>
<? ?>

等四种方式嵌入php代码,但除了第一种,其他或多或少被限制,所以如果不是特殊原因,尽量使用

1
<?php ?>

2、注释规则
注释必不可少,但是也不可过多,决不可为写注释而写注释
块注释

1
2
3
4
/*
    常用于提供对文件、方法、数据结构和算法的描述。
    书写时要注意和它所描述的代码具有相同缩进
*/

单行注释

1
2
3
4
5
if (false)
{
    /* 没有特殊要求 */
    echo "一样注意缩进,\r\n如果需要换行,则需要使用块注释"; 
}

尾端注释

1
2
3
4
5
6
7
8
9
10
11
if (false)
{ 
    echo "没有特殊要求"; /* 注意缩进,建议不适用,因为不容易区分代码与注释 */
}
 
行末注释
<pre lang="php" colla="+">
if (false)
{ 
    echo "没有特殊要求"; //注释界定符,很方便,尤其从学过JAVA与C#语言的人,可能更热衷此种注释
}


PHP书写规则

1、缩进
没有硬性要求,但通常为4个半角空格
2、大括号
两种使用
一种紧接行尾
一种换行使用
没有固定要求,依照个人习惯使用,通常为第二种

1
2
3
4
5
6
7
8
function a(){
 
}
 
function b()
{
 
}

3、关键字、小括号、行数、运算符
不要把小括号与关键字紧挨在一起

1
2
3
4
if ($false)//if 与 (之间有一个空格
{
 
}

小括号要紧挨函数,以便区分关键字与函数

1
round($num);//round 与 (之间没有空格

运算符两边要有一个空格

1
if($a == $b)

当代码段较大时、上下应加入空白行、两代码块之间使用一个空白行、禁止多个空白行

尽量不要在return后使用小括号


PHP命名规则

1、类命名
遵循帕斯卡命名法
注意不要使用下划线
如ClassInfo
UserInfo

2、类属性命名
参考匈牙利命名法
以m为前缀,后面每个单词首字母大写
如mValue
mName

3、方法命名
注意前缀与后缀
与类一样,遵循帕斯卡命名法
如IsExistUser()
GetUserName()
SetUserName()

4、方法中参数命名
遵循骆驼命名法
首字母小写,后每个单词首字母大写

IsExistUser($userId)
GetUser($userName)

5、变量命名
所有字母均小写
使用_作为单词分割

$msg_error
$user_name
注意引用变量应有r前缀
如$rExam
全局变量需带g前缀
如$gPath
静态变量需有s前缀
$sPath
常量与全局常量需要全部使用大写字母单词间以_分割

define(‘PAGE_SIZE’,90);
define(‘PAGE_NUM’,1);

6、函数命名
全部使用小写。单词间以_分割

function goog_idea()
{

}

7、前缀可以嵌套(匈牙利命名法
如$msValue;//静态的成员变量

日志信息 »

该日志于2010-01-03 20:08由 harde 发表在PHP分类下, 你可以发表评论。除了可以将这个日志以保留源地址及作者的情况下引用到你的网站或博客,还可以通过RSS 2.0订阅这个日志的所有评论。

相关日志 »

2条评论

  1. 朱二 说道:

    兄弟,交换下链接如何?

    回复

    harde Reply:

    貌似咱们不是一个类型的Blog…

    回复

发表评论 »

使用新浪微博登陆

返回顶部
分享按钮