PHP编码规范(1)

来源:互联网 发布:淘宝之前的电商 编辑:程序博客网 时间:2024/05/16 07:04

1、PHP开始和结束标志

    当脚本中带有PHP代码时,可以使用<?php ?>、<? ?>、<% %>等来界定PHP代码,在HTML页面中嵌入纯变量时,还可以使用<? =$variables ?>这样的形式,为了防止短标记<? ?>与ASP风格的<% %>与一些技术发生冲突,有时需要在PHP配置文件中将其关闭,因而导致这样的标记不总是可用,所以在编写PHP脚本是不允许使用短标记,全部脚本使用完整的、标准的PHP定界标签<?php ?>作为PHP的开始和结束标志。

    对于只含有PHP代码的文件,结束标志“?>”是不允许存在的,PHP本身布需要“?>”,这样做可以防止它的尾部被意外的注入,从而导致像Header()、setCookie()和session_start()等设置头信息的函数发生失败。

2、注释规范

    一般使用“/**”开始和“*/“结束的多行文档注释。

    在程序开发中难免留下一些临时代码和调试代码,以免日后遗忘,此类代码也必须加注释,可以使用单行注释"//“.

    建议添加注释的地方:

    (1)在每个文件的首部添加注释说明;

    (2)在每个函数或每个方法上方添加注释说明;

    (3)对各变量的功能、范围、默认条件等加上注释;

    (4)对使用的逻辑算法加上注释。

3、空行和空白

    (1)空行:每段较大的程序体上、下应加入一个空白行;两个函数声明之间;块注释或单行注释之前;一个函数内的两个逻辑代码段之间。

    (2)空格:关键字与左括号(函数名与左括号不要);函数的参数列表中的逗号后面;数学算式的操作数与运算符之间(二进制运算与一元运算除外,字符连接运算符两边不加空格);for语句的表达式用分号隔开,后面添加空格;除非字符串中特意需要,一般情况下,在程序和HTML中不出现两个连续的空格;说明或显示部分,内容含有中文、数字、英文单词混杂,在数字或者英文字母的前后添加空格;

0 0
原创粉丝点击