For investors

股价:

5.36 美元 %

认识达内从这里开始

认真做教育 专心促就业

PHP开发编码规范要注意-达内PHP培训
  • 发布:达内PHP培训
  • 来源:互联网
  • 时间:2018-06-25 10:42
    文章来自:博客
    #/article/72757.htm
    下面是达内PHP培训根据经验整理的PHP编码规范,可以用作给大家的范例和参考,根据需要进行取舍和修改!
    (可能最新的一些php5的规范不够完整,今后有机会保持更新!)
    目录
    1 编写目的
    2 整体要求
    3 安全规范
    3.1 包含文件
    3.1.1 命名规则
    3.1.2 存放规则
    3.2 安全规则
    3.3 一些针对PHP的规则
    3.4 其它处理规则
    3.4.1 对输入参数值进行转义处理
    3.4.2 操作大HTML文本
    4 编码规范
    4.1 命名规范
    4.1.1 变量命名
    4.1.2 类
    4.1.3 方法或函数
    4.1.4 缩写词
    4.1.5 数据库表名
    4.1.6 数据库字段
    4.2 书写规则
    4.2.1 代码缩进
    4.2.2 大括号{ }书写规则
    4.2.3 小括号( )和函数、关键词等
    4.2.4 =符号书写
    4.2.5 if else swith for while等书写
    4.2.6 类的构造函数
    4.2.7 语句断行, 每行控制在80个字符以内
    4.2.8 不要不可思议的数字
    4.2.9 true/false和0/1判断
    4.2.10 避免嵌入式赋值
    4.2.11 错误返回检测规则
    4.3 程序注释
    4.3.1 程序头注释块
    4.3.2 类的注释
    4.3.3 函数和方法的注释
    4.3.4 变量或者语句注释
    4.4 其他规范(建议)
    4.4.1 php代码标记
    4.4.2 程序文件名、目录名
    4.4.3 PHP项目通常的文件目录结构
    4.4.4 PHP和HTML代码的分离问题
    4.4.5 PHP项目开发中的程序逻辑结构
    5 特定环境下PHP编码特殊规范
    5.1 变量定义
    5.2 引用的使用
    5.3 变量的输入输出
    1 编写目的
    为了更好的提高技术部的工作效率,保证开发的有效性和合理性,并可最大程度的提高程序代码的可读性和可重复利用性,指定此规范.开发团队根据自己的实际情况,可以对本规范进行补充或裁减.
    2 整体要求
    技术部php开发规范将参照PEAR的规范,基本采用PEAR指定的规范,在其基础上增加、修改或删除部分适合具体开发环境的规范.本规范只针对PHP开发过程中编码的规范,对于PHP开发项目中文件、目录、数据库等方面的规范,将不重点涉及.
    本规范包含了PHP开发时程序编码中命名规范、代码缩进规则、控制结构、函数调用、函数定义、注释、包含代码、PHP标记、文件头的注释块、CVS标记、URL样例、常量命名等方面的规则.
    3 安全规范
    3.1 包含文件
    3.1.1 命名规则
    提取出来具有通用函数的包含文件,文件后缀以.inc来命名,表明这是一个包含文件.
    如果有多个.inc文件需要包含多页面,请把所有.inc文件封装在一个文件里面,具体到页面只需要包换一个.inc文件就可以了
    如:xxx_session.inc
    xxx_comm..inc
    xxx_setting.inc
    mysql_db.inc
    把以上文件以一下方式,封装在xxx.basic.inc文件里面
    require_once("xxx_session.inc");
    require_once("xxx_comm.inc");
    require_once("xxx_setting.inc");
    require_once("mysql_db.inc");
    注:是否需要封装到一个文件,视情况而定,如果每个inc的功能是分散到不同的页面使用的话,就不建议封装.
    3.1.2 存放规则
    一般包含文件不需要直接暴露给用户,所以应该放在 Web Server访问不到的目录,避免因为配置问题而泄露设置信息.
    3.2 安全规则
    请参考产品安全检查表.
    输入和输出
    检查是否做了HTML代码的过滤
    可能出现的问题:如果有人输入恶意的HTML代码,会导致窃取cookie, 产生恶意登录表单,和破坏网站
    检查变量做数据库操作之前是否做了escape
    可能出现的问题:如果一个要写入查询语句的字符串变量包含了某些特殊的字符,比如引号(' ,")或者分号(;) 可能造成执行了预期之外的操作.
    建议采用的方法:使用mysql_escape_string() 或实现类似功能的函数.
    检查输入数值的合法性
    可能出现的问题:异常的数值会造成问题.如果对输入的数值不做检查会造成不合法的或者错误的数据存入UDB、存入其它的数据库或者导致意料之外的程序操作发生.
    举例:
    如果程序以用户输入的参数值做为文件名,进行文件操作,恶意输入系统文件名会造成系统损毁.
    核实对cookie的使用以及对用户数据的处理
    可能出现的问题:不正确的cookie使用可能造成用户数据泄漏
    访问控制
    对内部使用的产品或者供合作方使用的产品,要考虑增加访问控制
    logs
    确保用户的保密信息没有记在log中(例如:用户的密码)
    确保对关键的用户操作保存了完整的用户访问记录
    https
    对敏感数据的传输要采用https
    3.3 一些针对PHP的规则
    设置 register_globals = off (Y!PHP 已经禁止了register_globals,如果你使用Y!PHP可以不考虑这项设置)
    设置 error_reporting = E_ALL (Y!PHP 的缺省设置),并且要修正所有的error和warning
    将实际的操作放在被引用的文件中.把引用文件放到不可以被直接浏览的目录下
    3.4 其它处理规则
    3.4.1 对输入参数值进行转义处理
    页面接到参数需要SQL操作,这时候需要做转义,尤其需要注意";".
    如:$a = " Let's go " ;
    $sql = "Insert into tmp(col) values('$a')" ;
    这种情况出现错误的不确定性.
    3.4.2 操作大HTML文本
    很多时候需要存放一大段HTML文本供页面使用,象用户定制页头页脚等.
    需要剔除脚本标记,避免执行恶意php代码.
    转换"<"">"号,保证代码完整.
    4 编码规范
    4.1 命名规范
    制定统一的命名规范对于项目开发来说非常重要,不但可以养成程序员一个良好的开发习惯,还能增加程序的可读性、可移植性和可重用性,还能很好的提高项目开发的效率.
    4.1.1 变量命名
    变量命名分为普通变量、静态变量、局部变量、全局变量、Session变量等方面的命名规则.
    4.1.1.1 普通变量
    普通变量命名遵循以下规则:
    a. 所有字母都使用小写;
    b. 对于一个变量使用多个单词的,使用'_'作为每个词的间隔.
    例如:$base_dir、$red_rose_price等
    4.1.1.2 静态变量
    静态变量命名遵循以下规则:
    a. 静态变量使用小写的s_开头;
    b. 静态变量所有字母都使用小写;
    c. 多个单词组成的变量名使用'_'作为每个词的间隔.
    例子:$s_base_dir、$s_red_rose_prise等.
    4.1.1.3 局部变量
    局部变量命名遵循以下规则:
    a. 所有字母使用小写;
    b. 变量使用'_'开头;
    c. 多个单词组成的局部变量名使用'_'作为每个词间的间隔.
    例子:$_base_dir、$_red_rose_price等.
    4.1.1.4 全局变量
    全局变量应该带前缀'g',知道一个变量的作用域是非常重要的.
    例如
    global $gLOG_LEVEL;
    global $gLOG_PATH;
    4.1.1.5 全局常量
    全局变量命名遵循以下规则:
    a. 所有字母使用大写
    b. 全局变量多个单词间使用'_'作为间隔.
    例子:$BASE_DIR、$RED_ROSE_PRICE等.
    4.1.1.6 session变量
    session变量命名遵循以下规则:
    a. 所有字母使用大写;
    b. session变量名使用'S_'开头;
    c. 多个单词间使用'_'间隔.
    例子:$S_BASE_DIR、$S_RED_ROSE_PRICE等.
    4.1.2 类
    php中类命名遵循以下规则:
    a. 以大写字母开头;
    b. 多个单词组成的变量名,单词之间不用间隔,各个单词首字母大写.
    例子:class MyClass 或class DbOracle等.
    4.1.3 方法或函数
    方法或函数命名遵循以下规则:
    a. 首字母小写;
    b. 多个单词间不使用间隔,除第一个单词外,其他单词首字母大写.
    例子:function myFunction ()或function myDbOracle ()等.
    4.1.4 缩写词
    当变量名或者其他命名中遇到缩写词时,参照具体的命名规则,而不采用缩写词原来的全部大写的方式.
    例子:function myPear(不是myPEAR) functio getHtmlSource(不是getHTMLSource).
    4.1.5 数据库表名
    数据库表名命名遵循以下规范:
    a. 表名均使用小写字母;
    b. 对于普通数据表,使用_t结尾;
    c. 对于视图,使用_v结尾;
    d. 对于多个单词组成的表名,使用_间隔;
    例子:user_info_t和book_store_v等
    4.1.6 数据库字段
    数据库字段命名遵循以下规范:
    a. 全部使用小写;
    b. 多个单词间使用_间隔.
    例子:user_name、rose_price等.
    4.2 书写规则
    书写规则是指在编写php程序时,代码书写的规则,包括缩进、结构控制等方面规范:
    4.2.1 代码缩进
    在书写代码的时候,必须注意代码的缩进规则,我们规定代码缩进规则如下:
    a. 使用4个空格作为缩进,而不使用tab缩进(对于ultraedit,可以进行预先设置)
    例子:
    for ( $i=0;$i<$count;$i++ )
    {
    echo "test";
    }
    4.2.2 大括号{ }书写规则
    在程序中进行结构控制代码编写,如if、for、while、switch等结构,大括号传统的有两种书写习惯,分别如下:
    a.{直接跟在控制语句之后,不换行,如
    for ($i=0;$i<$count;$i++) {
    echo "test";
    }
    b.{在控制语句下一行,如
    for($i=0;$i<$count;$i++)
    {
    echo "test";
    }
    其中,a是PEAR建议的方式,但是从实际书写中来讲,这并不影响程序的规范和影响用phpdoc实现文档,所以可以根据个人习惯来采用上面的两种方式,但是要求在同一个程序中,只使用其中一种,以免造成阅读的不方便.
    4.2.3 小括号( )和函数、关键词等
    小括号、关键词和函数遵循以下规则:
    a. 不要把小括号和关键词紧贴在一起,要用一个空格间隔;如if ( $a<$b );
    b. 小括号和函数名间没有空格;如$test = date("ymdhis");
    c. 除非必要,不要在Return返回语句中使用小括号. 如Return $a;
    4.2.4 =符号书写
    在程序中=符号的书写遵循以下规则:
    a. 在=符号的两侧,均需留出一个空格;如$a = $b 、if ($a = = $b)等;
    b. 在一个申明块,或者实现同样功能的一个块中,要求=号尽量上下对其,左边可以为了保持对齐使用多个空格,而右边要求空一个空格;如下例:
    $testa = $aaa;
    $testaa = $bbb;
    $testaaa = $ccc;
    4.2.5 if else swith for while等书写
    对于控制结构的书写遵循以下规则:
    a. 在if条件判断中,如果用到常量判断条件,将常量放在等号或不等号的左边,例如:
    if ( 6 == $errorNum ),因为如果你在等式中漏了一个等号,语法检查器会为你报错,可以很快找到错误位置,这样的写法要多注意;
    b. switch结构中必须要有default块;
    c. 在for和wiile的循环使用中,要警惕continue、break的使用,避免产生类似goto的问题;
    4.2.6 类的构造函数
    如果要在类里面编写构造函数,必须遵循以下规则:
    a. 不能在构造函数中有太多实际操作,顶多用来初始化一些值和变量;
    b. 不能在构造函数中因为使用操作而返回false或者错误,因为在声明和实例化一个对象的时候,是不能返回错误的;
    4.2.7 语句断行, 每行控制在80个字符以内
    在代码书写中,遵循以下原则:
    a. 尽量保证程序语句一行就是一句,而不要让一行语句太长产生折行;
    b. 尽量不要使一行的代码太长,一般控制在80个字符以内;
    c. 如果一行代码太长,请使用类似 .= 的方式断行书写;
    d. 对于执行数据库的sql语句操作,尽量不要在函数内写sql语句,而先用变量定义sql语句,然后在执行操作的函数中调用定义的变量;
    例子:
    $sql = "SELECT username,password,address,age,postcode FROM test_t ";
    $sql .= " WHERE username='aaa'";
    $res = mysql_query($sql);
    4.2.8 不要不可思议的数字
    一个在源代码中使用了的赤裸裸的数字是不可思议的数字,因为包括作者,在三个月内,没人它的含义.例如:
    if      (22 == $foo)
    {
    start_thermo_nuclear_war();
    }
    else if (19 == $foo)
    {
    refund_lotso_money();
    }
    else
    {
    cry_cause_im_lost();
    }
    你应该用define()来给你想表示某样东西的数值一个真正的名字,而不是采用赤裸裸的数字,例如:
    define("PRESIDENT_WENT_CRAZY", "22");
    define("WE_GOOFED", "19");
    define("THEY_DIDNT_PAY", "16");
    if ( PRESIDENT_WENT_CRAZY == $foo)
    {
    start_thermo_nuclear_war();
    }
    else if (WE_GOOFED == $foo)
    {
    refund_lotso_money();
    }
    else if (THEY_DIDNT_PAY == $foo)
    {
    infinite_loop();
    }
    else
    {
    happy_days_i_know_why_im_here();

    }

达内PHP培训

    4.2.9 true/false和0/1判断
    遵循以下规则:
    a. 不能使用0/1代替true/false,在PHP中,这是不相等的;
    b. 不要使用非零的表达式、变量或者方法直接进行true/false判断,而必须使用严格的完整true/false判断;
    如:不使用if ($a) 或者if (checka()) 而使用if (FALSE != $a)或者 if (FALSE != check())
    4.2.10 避免嵌入式赋值
    在程序中避免下面例子中的嵌入式赋值:
    不使用这样的方式:
    while ($a != ($c = getchar()))
    {
    process the character
    }
    4.2.11 错误返回检测规则
    检查所有的系统调用的错误信息,除非你要忽略错误.
    为每条系统错误消息定义好系统错误文本,并记录错误LOG.
    4.3 程序注释
    每个程序均必须提供必要的注释,书写注释要求规范,参照PEAR提供的注释要求,为今后利用phpdoc生成php文档做准备.程序注释的原则如下:
    a. 注释中除了文件头的注释块外,其他地方都不使用//注释,而使用/* */的注释;
    b. 注释内容必须写在被注释对象的前面,不写在一行或者后面;
    4.3.1 程序头注释块
    每个程序头部必须有统一的注释块,规则如下:
    a. 必须包含本程序的描述;
    b. 必须包含作者;
    c. 必须包含书写日期;
    d. 必须包含版本信息;
    e. 必须包含项目名称;
    f. 必须包含文件的名称;
    g. 重要的使用说明,如类的调用方法、注意事项等;
    参考例子如下:
    <?php
    //
    // +---------------------------------------------------------+
    // | PHP version 4.0                                         |
    // +---------------------------------------------------------+
    // | Copyright (c) 1997-2001 The PHP Group                   |
    // +---------------------------------------------------------+
    // | This source file is subject to  of the PHP license,     |
    // | that is bundled with this packafile LICENSE, and is     |
    // | available at through the world-web at                   |
    // | #/license/2_02.txt.                    |
    // | If you did not receive a copy of the  and are unable to |
    // | obtain it through the world-wide-web,end a note to      |
    // | license@# so we can mail you a immediately.       |
    // +---------------------------------------------------------+
    // | Authors: Stig Bakken <ssb@fast.no>                      |
    // |          Tomas V.V.Cox <cox@#>                |
    // |                                                         |
    // +---------------------------------------------------------+
    //
    // $Id: Common.php,v 1.8.2.3 2001/11/13 01:26:48 ssb Exp $
    4.3.2 类的注释
    类的注释采用里面的参考例子方式:
    /**
    * @ Purpose:
    * 访问数据库的类,以ODBC作为通用访问接口
    * @Package Name: Database
    * @Author: Forrest Gump gump@#
    * @Modifications:
    * No20020523-100:
    * odbc_fetch_into()参数位置第二和第三个位置调换
    * John Johnson John@#
    * @See: (参照)
    */
    class Database
    {
    ……
    }
    4.3.3 函数和方法的注释
    函数和方法的注释写在函数和方法的前面,采用类似下面例子的规则:
    /**
    * @Purpose:
    * 执行一次查询
    * @Method Name: Query()
    *
    * @Param: string $queryStr SQL查询字符串
    * @Param: string $username 用户名
    *
    * @Author: Michael Lee
    *
    * @Return: mixed 查询返回值(结果集对象)
    */
    function($queryStr,$username)
    {……}
    4.3.4 变量或者语句注释
    程序中变量或者语句的注释遵循以下原则:
    a. 写在变量或者语句的前面一行,而不写在同行或者后面;
    b. 注释采用/* */的方式;
    c. 每个函数前面要包含一个注释块.内容包括函数功能简述,输入/输出参数,预期的返回值,出错代码定义.
    d. 注释完整规范.
    e. 把已经注释掉的代码删除,或者注明这些已经注释掉的代码仍然保留在源码中的特殊原因.
    f.
    例子:
    /**
    * @Purpose:
    * 数据库连接用户名
    * @Attribute/Variable Name: db_user_name
    * @Type: string
    */
    var db_user_name;
    4.4 其他规范(建议)
    4.4.1 php代码标记
    所有的php程序代码块标记均使用
    4.4.2 程序文件名、目录名
    程序文件名和目录名命名均采用有意义的英文方式命名,不使用拼音或无意义的字母,同时均必须使用小写字母,多个词间使用_间隔.
    4.4.3 PHP项目通常的文件目录结构
    建议在开发规范的独立的PHP项目时,使用规范的文件目录结构,这有助于提高项目的逻辑结构合理性,对应扩展和合作,以及团队开发均有好处.
    一个完整独立的PHP项目通常的文件和目录结构如下:
    / 项目根目录
    /manage 后台管理文件存放目录
    /css css文件存放目录
    /doc 存放项目文档
    /images 所有图片文件存放路径(在里面根据目录结构设立子目录)
    /scripts 客户端js脚本存放目录
    /tpl 网站所有html的模版文件存放目录
    /error.php 错误处理文件(可以定义到apache的错误处理中)
    以上目录结构是通常的目录结构,根据具体应用的具体情况,可以考虑不用完全遵循,但是尽量做到规范化.
    4.4.4 PHP和HTML代码的分离问题
    对性能要求不是很高的项目和应用,我们建议不采用PHP和HTML代码直接混排的方式书写代码,而采用PHP和HTML代码分离的方式,即采用模版的方式处理,这样一方面对程序逻辑结构更加清晰有利,也有助于开发过程中人员的分工安排,同时还对日后项目的页面升级该版提供更多便利.
    对于一些特殊情况,比如对性能要求很高的应用,可以不采用模版方式.
    4.4.5 PHP项目开发中的程序逻辑结构
    对于PHP项目开发,尽量采用OOP的思想开发,尤其在PHP5以后,对于面向对象的开发功能大大提高.
    在PHP项目中,我们建议将独立的功能模块尽量写成函数调用,对应一整块业务逻辑,我们建议封装成类,既可以提高代码可读性,也可以提高代码重用性.比如,我们通常将对数据库的接口封装成数据库类,有利于平台的移植.
    重复的代码要做成公共的库.(除了我们在plug-in产品上遇到的情况,该产品系列有多个相类似的产品,为了尽可能地减少安装包尺寸,不适合将这些产品共用的所有函数做成公共的库)
    5 特定环境下PHP编码特殊规范
    5.1 变量定义
    XXX环境下的php代码编写要求所有的变量均需要先申明后使用,否则会有错误信息,对于数组,在使用一个不确定的key时,比如先进行isset()的判断,然后再使用;比如下面的代码:
    $array = array();
    $var = isset($array[3]) ? $array[3] : "";
    5.2 引用的使用
    引用在程序中使用比较多,为了公用同一个内存,而不需要另外进行复制,XXX环境下的引用使用时,需要注意下面的情况;
    在对函数的输入参数中使用引用时,不能在调用的时候在输入参数前加&来引用,而直接使用该变量即可,同时必须在函数定义的时候说明输入参数来自引用,比如下面的代码:
    $a = 1;
    function ab(&$var)
    {
    $var ++;
    return $var;
    }
    $b = ab($a) // 注意,此处不能使用 $b = ab(&$a)的方式;
    echo $b."/n";
    echo $a."/n";
    此时 $a和$b都是2;
    XXX环境下对引用的特殊要求源自php.ini文件里面的allow_call_time_pass_reference 项设置, 对外公开的版本是 On ,这样就可以支持&直接加到调用函数时变量前面进行引用,但是这一方法遭到抗议,并可能在将来版本的PHP/Zend里不再支持.受到鼓励的指定哪些参数按引用传递的方法是在函数声明里.你被鼓励尝试关闭这一选项(使用 off,XXX的所有运行环境下都是off)并确认你的脚本仍能正常工作,以保证在将来版本的语言里它们仍能工作.
    5.3 变量的输入输出
    在XXX环境下,对web通过GET或者POST方法传递来的参数均要求进行严格的过滤和合法性验证,不推荐使用直接的$_GET、$_POST或者$_REQUEST获取,而通过XXX的XXX_yiv模块提供的方法获取和过滤处理
    规范完!
    说明:规范中提到的XXX环境是特别指的xx曾经工作的XXX公司特定开发环境!
    以上就是达内PHP培训给大家做的内容详解,更多关于PHP的学习,请继续关注达内PHP培训
<  上一篇:网络营销培训-SEO优化网站网页头部标签优化方案
下一篇:PHP开发的一些注意点总结  >
相关推荐
最新资讯
免费试听课程
  • 全部课程
  • IT课程
  • 设计课程
  • 运营课程
Free courses
最新开班时间
  • 北京
  • 上海
  • 广州
  • 深圳
  • 南京
  • 成都
  • 武汉
  • 西安
  • 青岛
  • 天津
  • 杭州
  • 重庆
  • 厦门
  • 哈尔滨
  • 济南
  • 福州
  • 沈阳
  • 合肥
  • 郑州
  • 长春
  • 苏州
  • 大连
  • 长沙
  • 昆明
  • 温州
  • 太原
  • 南昌
  • 无锡
  • 石家庄
  • 南宁
  • 中山
  • 兰州
  • 佛山
  • 珠海
  • 宁波
  • 贵阳
  • 保定
  • 呼和浩特
  • 东莞
  • 洛阳
  • 潍坊
  • 烟台
  • 运城
  • 开课名称
  • 开班时间
  • 抢座
  • 咨询
  • 开课名称
  • 开班时间
  • 抢座
  • 咨询
预约申请试听课
收起