PHP语言规范文档.docx

上传人:b****4 文档编号:4034053 上传时间:2022-11-27 格式:DOCX 页数:10 大小:20.69KB
下载 相关 举报
PHP语言规范文档.docx_第1页
第1页 / 共10页
PHP语言规范文档.docx_第2页
第2页 / 共10页
PHP语言规范文档.docx_第3页
第3页 / 共10页
PHP语言规范文档.docx_第4页
第4页 / 共10页
PHP语言规范文档.docx_第5页
第5页 / 共10页
点击查看更多>>
下载资源
资源描述

PHP语言规范文档.docx

《PHP语言规范文档.docx》由会员分享,可在线阅读,更多相关《PHP语言规范文档.docx(10页珍藏版)》请在冰豆网上搜索。

PHP语言规范文档.docx

PHP语言规范文档

PHP语言编写规范

第1章命名规范

1.1变量

1。

1.1全局变量

全局变量使用$g_开头,如$g_data_list.

1.1。

2一般变量

一般的变量使用小写字母命名,单词之间使用下划线分隔。

变量名字应该使用名词或者形容词+名词的方式。

如$value,$new_value。

1。

1.3临时变量

不要将在循环中频繁使用的临时变量如$i,$j等用于其它用途.

1。

2函数

函数采用小写字母命名,单词之间使用下划线分隔.

函数的命名建议使用动词+名词的方式,如get_user_img。

完成一组功能的函数放到一个文件中,存放函数的文件采用function_name.func.php命名.

1.3类

类使用英文的大小写来分隔单词,包括首个单词,所有单词的首字母大写,如PageManager;

在类中,方法放到属性定义前边、公用方法放到专用方法前边;

一般情况下,一个类对应到一个文件;

当一些类关系紧密时,可以存放在一个文件中;

存放类的文件采用ClassName。

class。

php方式命名。

1.4方法

方法使用英文的大小写来分隔单词,除首个单词外,其他单词的首字母大写,如getCurrentPage();

不要采用不常用的缩写,如where2go();

使用常用的缩写时,只大写首字母,如getHtml()。

第2章版式规则

2。

1语义分隔

各个函数、方法之间应该采用空行间隔;

同一个函数中联系紧密的语句之间可以不换行,其他情况需要换行。

2.2空格规则

2。

2。

1逻辑运算符前后必须加空格

正确$a==$b;

错误$a==$b;

$a==$b;

备注-

正确$a++;$a–;

错误$a++;$a–;

备注加一减一运算符不能加空格。

2。

2。

2多个参数分隔时必须加空格

正确$g_pro,$g_user,g_show;

get_db_info($host,$user,$passwd);

错误$g_pro,$g_user,$g_show;

get_db_info($host,$user,$passwd);

备注—

2.2.3语法关键字后必须加空格

例如:

If,for,while,switch…。

.

正确for($i=0;$i〈10;$i++)

错误for($i=0;$i<10;$i++)

备注-

2.3字符串和变量连接规则

字符串与变量连接使用’。

’号时,必须在’。

'前后加空格,使用”号时,必须在变量前后加”{}”。

正确$my_name=’file_’。

$var1;

$my_name=”file_{$var1}";

错误$my_name=”file_’.$var1;

$my_name=”file_$var1″;

备注-

2.4圆括号规则

函数名后括号不需要加空格、语法关键字后的括号必须加空格。

正确for($i=0;$i〈10;$i++)

strlen($my_name);

错误for($i=0;$i<10;$i++)

strlen($my_name);

备注-

2.5花括号规则

花括号必须为上下对应。

正确

if($a)

$b=$a;

错误if($a){

$b=$a;

}

备注—

2.6数组定义规则

数组定义和使用时中key值前后必须加单引号。

PHP代码:

下载:

php_array.php

〈?

php

//正确

array(

'name’=>’d5s。

cn’,

’gender’=>’php’

);

//错误

array(

name=〉’’,

gender=〉'php’

);

 

2。

7SQL规则

在PHP中嵌入的SQL语句关键字全部采用大写;

表名和字段名要用反引号(`)引起来以防止因为字段名中包含空格而出现错误;

数据值两边用单引号”包括,并且应确保数据值中的单引号已经转义以防止SQL注入。

正确$sql=”SELECT`user`。

`name`FROM`user`WHERE`id`='$id’LIMIT1″;

错误$sql=”selectname.userfromnamewhereid=$id”;

备注—

第3章注释规则

3。

1一般规则

不写不必要的注释;只有当代码不能很好地说明逻辑时,才用注释补充;

把注释看成程序的一部分,在编写/维护代码时同时编写/维护注释;

注释完全采用PHPDocumentor的规范,以方便用其生成API级文档。

3。

2详细规则

请参见PHPDocumentor手册.下边给出各个部分的注释示范。

3.2.1版权信息

注释名称版权信息

注释示范//

//+-————--—---——-————+

//|phpDocumentor|

//+---——————————————-+

//|Copyright(c)2000-2003JoshuaEichorn|

//|Emailjeichorn@phpdoc。

org|

//|Webhttp:

//www。

phpdoc。

org|

//+—————-——-—-———————+

//|ThissourcefileissubjecttoPHPLicense|

//+—-———-—————-—————-+

//

备注使用//来标示版权信息,以免和PHPDocumentor的page—levelDocBlock发生冲突

3.2。

2文件头注释示例

注释名称文件头注释

注释示范

下载:

php_doc。

php

〈?

php

*Allabstractrepresentationsofinlinetagsareinthisfile

*@packagephpDocumentor

*@subpackageInlineTags

*@sinceseparatefilesinceversion1.2

*@version$Id$

*/

备注

1文件头注释需要指明所属的包和子包

2在@version中加上$ID,以方便使用CVS管理文件

3.2。

3类注释示例

注释名称类注释

注释示范

下载:

php_class。

php

php

/**

*Usethiselementtorepresentan{@}inlinetag}like{@}link}

*@seeparserStringWithInlineTags

*@packagephpDocumentor

*@subpackageInlineTags

*@authorGregBeaver

〉〈/cellog@users。

sourceforge。

net〉

*@since1。

0rc1

*@version$Revision:

1。

21.2.6$

*@tutorialinlinetags。

pkg

*/

>

备注-

3。

2.4类属性注释示例

注释名称类属性注释

注释示范

下载:

php.php

php

/**var$type=’inlinetag’;

*Elementtype

*Typeisusedbymanyfunctionstoskipthehassleof

*

*ifget_class($blah)=='parserBlah’

*〈/code〉

*always"inlinetag”

*@varstring

*/

>

备注—

3.2.5函数/类方法注释示例

注释名称函数/类方法注释

注释示范

下载:

php。

php

<?

php

/**functiongetString()'’;

*@returnstringalways’’

*calculatetheshortdescriptionofaDocBlock

*@seeparserStringWithInlineTags:

getString()

*@seeparserStringWithInlineTags:

:

trimmedStrlen()

*/

{

return

}

?

此条目发表在理论分类目录.将固定链接加入收藏夹。

用单引号代替双引号来包含字符串,这样做会更快一些。

因为PHP会在双引号包围的字符串中搜寻变量,单引号则不会,注意:

只有echo能这么做,它是一种可以把多个字符串当作参数的“函数”(译注:

PHP手册中说echo是语言结构,不是真正的函数,故把函数加上了双引号)。

1、如果能将类的方法定义成static,就尽量定义成static,它的速度会提升将近4倍。

2、$row[’id’]的速度是$row[id]的7倍。

3、echo比print快,并且使用echo的多重参数(译注:

指用逗号而不是句点)代替字符串连接,比如echo$str1,$str2.

4、在执行for循环之前确定最大循环数,不要每循环一次都计算最大值,最好运用foreach代替。

5、注销那些不用的变量尤其是大数组,以便释放内存。

6、尽量避免使用__get,__set,__autoload。

7、require_once()代价昂贵。

8、include文件时尽量使用绝对路径,因为它避免了PHP去include_path里查找文件的速度,解析操作系统路径所需的时间会更少.

9、如果你想知道脚本开始执行(译注:

即服务器端收到客户端请求)的时刻,使用$_SERVER[‘REQUEST_TIME']要好于time()。

10、函数代替正则表达式完成相同功能.

11、str_replace函数比preg_replace函数快,但strtr函数的效率是str_replace函数的四倍。

12、如果一个字符串替换函数,可接受数组或字符作为参数,并且参数长度不太长,那么可以考虑额外写一段替换代码,使得每次传递参数是一个字符,而不是只写一行代码接受数组作为查询和替换的参数。

13、使用选择分支语句(译注:

即switchcase)好于使用多个if,elseif语句。

14、用@屏蔽错误消息的做法非常低效,极其低效。

15、打开apache的mod_deflate模块,可以提高网页的浏览速度。

16、数据库连接当使用完毕时应关掉,不要用长连接.

17、错误消息代价昂贵。

18、在方法中递增局部变量,速度是最快的.几乎与在函数中调用局部变量的速度相当.

19、递增一个全局变量要比递增一个局部变量慢2倍.

20、递增一个对象属性(如:

$this->prop++)要比递增一个局部变量慢3倍。

21、递增一个未预定义的局部变量要比递增一个预定义的局部变量慢9至10倍。

22、仅定义一个局部变量而没在函数中调用它,同样会减慢速度(其程度相当于递增一个局部变量)。

PHP大概会检查看是否存在全局变量。

23、方法调用看来与类中定义的方法的数量无关,因为我(在测试方法之前和之后都)添加了10个方法,但性能上没有变化。

24、派生类中的方法运行起来要快于在基类中定义的同样的方法。

25、调用带有一个参数的空函数,其花费的时间相当于执行7至8次的局部变量递增操作。

类似的方法调用所花费的时间接近于15次的局部变量递增操作。

26、Apache解析一个PHP脚本的时间要比解析一个静态HTML页面慢2至10倍。

尽量多用静态HTML页面,少用脚本。

27、除非脚本可以缓存,否则每次调用时都会重新编译一次。

引入一套PHP缓存机制通常可以提升25%至100%的性能,以免除编译开销。

28、尽量做缓存,可使用memcached。

memcached是一款高性能的内存对象缓存系统,可用来加速动态Web应用程序,减轻数据库负载。

对运算码(OPcode)的缓存很有用,使得脚本不必为每个请求做重新编译。

29、当操作字符串并需要检验其长度是否满足某种要求时,你想当然地会使用strlen()函数。

此函数执行起来相当快,因为它不做任何计算,只返回在zval结构(C的内置数据结构,用于存储PHP变量)中存储的已知字符串长度.但是,由于strlen()是函数,多多少少会有些慢,因为函数调用会经过诸多步骤,如字母小写化(译注:

指函数名小写化,PHP不区分函数名大小写)、哈希查找,会跟随被调用的函数一起执行。

在某些情况下,你可以使用isset()技巧加速执行你的代码。

(举例如下)

if(strlen($foo)<5){echo“Fooistooshort"$$}

(与下面的技巧做比较)

if(!

isset($foo{5})){echo“Fooistooshort”$$}

调用isset()恰巧比strlen()快,因为与后者不同的是,isset()作为一种语言结构,意味着它的执行不需要函数查找和字母小写化。

也就是说,实际上在检验字符串长度的顶层代码中你没有花太多开销。

34、当执行变量$i的递增或递减时,$i++会比++$i慢一些。

这种差异是PHP特有的,并不适用于其他语言,所以请不要修改你的C或Java代码并指望它们能立即变快,没用的。

++$i更快是因为它只需要3条指令(opcodes),$i++则需要4条指令。

后置递增实际上会产生一个临时变量,这个临时变量随后被递增。

而前置递增直接在原值上递增。

这是最优化处理的一种,正如Zend的PHP优化器所作的那样。

牢记这个优化处理不失为一个好主意,因为并不是所有的指令优化器都会做同样的优化处理,并且存在大量没有装配指令优化器的互联网服务提供商(ISPs)和服务器。

35、并不是事必面向对象(OOP),面向对象往往开销很大,每个方法和对象调用都会消耗很多内存。

36、并非要用类实现所有的数据结构,数组也很有用。

37、不要把方法细分得过多,仔细想想你真正打算重用的是哪些代码?

38、当你需要时,你总能把代码分解成方法。

39、尽量采用大量的PHP内置函数。

40、如果在代码中存在大量耗时的函数,你可以考虑用C扩展的方式实现它们。

41、评估检验(profile)你的代码。

检验器会告诉你,代码的哪些部分消耗了多少时间。

Xdebug调试器包含了检验程序,评估检验总体上可以显示出代码的瓶颈。

42、mod_zip可作为Apache模块,用来即时压缩你的数据,并可让数据传输量降低80%.

43、在可以用file_get_contents替代file、fopen、feof、fgets等系列方法的情况下,尽量用file_get_contents,因为他的效率高得多!

但是要注意file_get_contents在打开一个URL文件时候的PHP版本问题;

44、尽量的少进行文件操作,虽然PHP的文件操作效率也不低的;

45、优化SelectSQL语句,在可能的情况下尽量少的进行Insert、Update操作(在update上,我被恶批过);

46、尽可能的使用PHP内部函数(但是我却为了找个PHP里面不存在的函数,浪费了本可以写出一个自定义函数的时间,经验问题啊!

);

47、循环内部不要声明变量,尤其是大变量:

对象(这好像不只是PHP里面要注意的问题吧?

);

48、多维数组尽量不要循环嵌套赋值;

49、在可以用PHP内部字符串操作函数的情况下,不要用正则表达式;

50、foreach效率更高,尽量用foreach代替while和for循环;

51、用单引号替代双引号引用字符串;

52、“用i+=1代替i=i+1。

符合c/c++的习惯,效率还高”;

53、对global变量,应该用完就unset()掉;

展开阅读全文
相关搜索

当前位置:首页 > 农林牧渔 > 林学

copyright@ 2008-2022 冰豆网网站版权所有

经营许可证编号:鄂ICP备2022015515号-1