PHP编码规范及建议

PHP编码规范及建议

<h3 align=”center”>PHP编码规范及建议</h3>

### 编码规范

– PHP代码文件必须以 <?php 标签开始。

“`
<?php //开头

// 不结尾
“`

– PHP代码文件必须以不带BOM的UTF-8编码。

“`
例sublime, setting增加,”show_encoding” : true
“`

– 每行的字符数不超过 80 个字符

“`
例,sublime
“word_wrap”: “true”,
“wrap_width”: 80,
“`

– tap键4个空格

“`
例,sublime
“tab_size”: 4,
“`

– PHP代码中应该只定义类(trait)/函数/常量/其他会产生副作用的操作(如:生成文件输出以及修改 .ini 配置文件等),只能选其一。

“`
例,
a.php
class A
{

}

b.php
function demo()
{

}

c.php
define(‘A’, value);

d.php
ini_set(‘some_vars’, value);
“`

– 类/trait/Interface的命名必须遵循 StudlyCaps 大写开头的驼峰命名规范。

“`
class StudlyCaps
{

}

trait StudlyCaps
{

}

Interface StudlyCaps
{

}

“`

– 类中的常量所有字母都必须大写,单词间用下划线分隔。

“`
define(‘FOO_BAR’, ‘something more’);

const FOO_BAR = value;

“`

– 方法(类/trait中)名称必须符合 camelCase 式的小写开头驼峰命名规范。

“`
class StudlyCaps
{

    public function studlyCaps()
    {

        // coding…
    }
}

“`

– 函数名称必须符合 snake_case 式的下划线式命名规范。

“`
function snake_case()
{

    // coding…
}

“`

– 私有的(private)方法(类/trait中)名称必须符合 _camelCase 式的前置下划线小写开头驼峰命名规范。

“`
class StudlyCaps
{

    private function _studlyCaps()
    {

        // coding…
    }
}

“`

– 方法名称 第一个单词 为动词。

“`
class StudlyCaps
{

    public function doSomething()
    {

        // coding…
    }
}

“`

– 变量 必须符合 camelCase 式的小写开头驼峰命名规范。

“`

class StudlyCaps
{

    public function doSomething()
    {

        $someVariable = ‘demo’;
        // coding…
    }
}

“`

– 方法/函数 多参数时,之间要有1个空格

“`

class StudlyCaps
{

    public function doSomething($variableOne, $variableTwo)
    {

        // coding…
    }
}

“`

– 运算符/表达式 要有一个空格

“`
$a = $b + $c;
$a = $b . $c;

“`

– 每个 namespace 命名空间声明语句块 和 use 声明语句块后面,必须 插入一个空白行。

“`
namespace Standard;
// 空一行
use Test\TestClass;//use引入类
// 空一行
“`

– 类的开始花括号 “{ “必须 写在函数声明后自成一行,结束花括号”}”也必须写在函数主体后自成一行。

“`
class StudlyCaps
{

}
“`

– 方法/函数的开始花括号 { 必须 写在函数声明后自成一行,结束花括号 }也 必须 写在函数主体后自成一行。

“`
class StudlyCaps
{

    public function studlyCaps()
    {

        // coding…
    }
}

function snake_case()
{

    // coding…
}

“`

– 类的属性和方法 必须 添加访问修饰符(private、protected 以及 public),abstract 以及 final 必须 声明在访问修饰符之前,

而 static 必须 声明在访问修饰符之后。

“`
abstract class StudlyCaps
{

    abstract public function studlyCaps();

    final public static function studlyCapsOne()
    {

    }
}

“`

– 控制结构的关键字后 必须 要有一个空格符,而调用方法或函数时则 一定不可 有。

“`
if ($valueOne === $valueTwo) {

  // code…
}

switch ($valueThree) {

  case ‘value’:
    // code…
    break;

  default:
    // code…
    break;
}

do {

  // code…
} while ($valueFour <= 10);

while ($valueFive <= 10) {

  // code…
}

for ($i = 0; $i < $valueSix; $i++) {

  // code…
}

$demo = new Demo()
$demo->doSomething();

do_something();

“`

– 控制结构的开始花括号 { 必须 写在声明的同一行,而结束花括号 } 必须 写在主体后自成一行。

“`
if ($valueOne === $valueTwo) {

  // code…
}

switch ($valueThree) {

  case ‘value’:
    // code…
    break;

  default:
    // code…
    break;
}

do {

  // code…
} while ($valueFour <= 10);

while ($valueFive <= 10) {

  // code…
}

for ($i = 0; $i < $valueSix; $i++) {

  // code…
}
“`

– 控制结构的开始左括号后和结束右括号前,都一定不可有空格符。

“`
if ($valueOne === $valueTwo) {// 控制结构(右边和)左边不加空格
  // code…
}
“`

### 编码建议

– sql过长

“`
// heredoc语法
$sql = <<<SQL
SELECT delivery_id
FROM d_test
WHERE delivery_id
IN (123,234)
GROUP BY delivery_id
HAVING SUM(send_number) <= 0;
SQL;
“`

– if等控制结构条件过长

“`
if ($a > 0
    && $b > 0
    && $c > 0
    && $d > 0
    && $e > 0) {

}
“`

– 方法或函数参数大于三个换行

“`
public function tooLangFunction(
      $valueOne   = ”,
      $valueTwo   = ”,
      $valueThree = ”,
      $valueFour  = ”,
      $valueFive  = ”,
      $valueSix   = ”)
{

    //coding…
}
“`

– 链式操作超过两个

“`
$this->nameTest->functionOne()
               ->functionTwo()
               ->functionThree();
“`

– 数组php5.4以后,使用[]

“`
$a = [
    ‘aaa’ => ‘aaa’,
    ‘bbb’ => ‘bbb’
];
“`

– 单引号多引号
    – 字符串中无变量,单引号
    – 字符串中有变量,双引号

“`
$str = ‘str’;
$arg = “$str”;
“`

– 声明类或者方法或函数添加描述&属性描述&作者

“`
/**
 * 类描述
 *
 * desc
 */
class StandardExample
{

  /**
   *  常量描述.
   *
   * @var string
   */
  const THIS_IS_A_CONST = ”;

  /**
   * 属性描述.
   *
   * @var string
   */
  public $nameTest = ”;

  /**
   * 构造函数.
   *
   * 构造函数描述
   * @author name <email>
   * @param  string $value 形参名称/描述
   * @return 返回值类型        返回值描述
   * 返回值类型:string,array,object,mixed(多种,不确定的),void(无返回值)
   */
  public function __construct($value = ”)
  {

    // coding…
  }
“`

– api方法提供测试样例example

“`
/**
 * 成员方法名称.
 *
 * 成员方法描述
 *
 * @param  string $value 形参名称/描述
 *
 * @example domain/api/controller/action?argu1=111&argu2=222
 */
public function testFunction($value = ”)
{

    // code…
}
“`

– 使用try…catch…

“`
try {

    // coding…

} catch (\Exception $e) {

  // coding…
}

“`

– 连续调用多个方法(大于3个)使用foreach

“`
// 改写doSome为doSomething
class StandardExample
{

  /**
   * 方法列表
   *
   * @var array
   */
  private $_functionList = [];

  public function __construct($functionList = array())
  {

    $this->_functionList = $value;
  }

  public function doSome()
  {

    $this->functionOne();
    $this->functionTwo();
    $this->functionThree();
    $this->functionFour();
  }

  public function doSomething()
  {

      foreach($this->_functionList as $function) {

          $this->$function();
      }
  }

  …
}
“`

– 文件顶部进行版权声明

“`
// +———————————————————————-
// | Company Name  xx服务
// +———————————————————————-
// | Copyright (c) 2017 http://domain All rights reserved.
// +———————————————————————-
// | Author: name <email>
// +———————————————————————-
“`

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

发布者:全栈程序员-用户IM,转载请注明出处:https://javaforall.cn/113818.html原文链接:https://javaforall.cn

【正版授权,激活自己账号】: Jetbrains全家桶Ide使用,1年售后保障,每天仅需1毛

【官方授权 正版激活】: 官方授权 正版激活 支持Jetbrains家族下所有IDE 使用个人JB账号...

(0)


相关推荐

  • Delphi中QuotedStr()

    Delphi中QuotedStr()1.定义给字符串两边加单引号并返回.声明:functionQuotedStr(constS:string):string;用函数QuotedStr把字符串S转换成为用引号括起来的字符串。单引号”’”将被插入到字符串s的最前和最后。2.范例特别可以应用在delphi的中的SQL语句,避免漏写的情况。lsstr:=…+QuotedStr(‘STR’)+…lsstr:=…+’WHERE‘’‘+‘abc‘+’’’…’QTmpR2.Close;QT

    2022年10月18日
  • 为什么pycharm找不到模块_pycharm project interpreter

    为什么pycharm找不到模块_pycharm project interpreter如果要连接服务器的话,是需要在deployment里进行操作的,但是有时候不管怎么找,在Pycharm中都找不到。(PS:我就遇到了这样的问题)其实原因很简单,你装的Pycharm可能是社区版,不具有远程连接服务器的功能,只需要下载一个专业版就行。用学生账号免费使用专业版的方法可参照这个:https://blog.csdn.net/weixin_45459911/article/details…

  • 真正的java的四舍五入

    真正的java的四舍五入原文地址:https://blog.csdn.net/qwfylwc/article/details/53939906下面列举让你惊讶的现象,或许你还一直这么用:1、使用Math.round()doubled=1041.735;d=Math.round(d*100)/100.0;//除以100.0而不是100System.out.println(d);…

  • PHP 浏览器缓存_php缓存引擎

    PHP 浏览器缓存_php缓存引擎浏览器缓存动态内容,缓存的内容在浏览器本地,而内容由web服务器生成,任何一方都不可能完成这一系列过程,他们之间有一种沟通机制,这就是缓存协商.如何协商当浏览器向web服务器请求内容时,服务器需要告诉浏览器那些内容可以被缓存,一旦浏览器知道某个内容可以缓存后,下次当浏览器需要请求这个内容时,它便不会直接向服务器请求完整内容,而是询问服务器是否可以使用本地的缓存,服务器在收到浏览器的询问后需要作…

  • 土法炼钢_百度百科[通俗易懂]

    土法炼钢_百度百科[通俗易懂]土法炼钢_百度百科土法炼钢

  • goland激活码3月最新在线激活

    goland激活码3月最新在线激活,https://javaforall.cn/100143.html。详细ieda激活码不妨到全栈程序员必看教程网一起来了解一下吧!

发表回复

您的电子邮箱地址不会被公开。

关注全栈程序员社区公众号