PHP 代码简洁之道(小结)

为什么要写简洁的代码

提高代码可读性
减少检查和调试时间
方便后期维护

如何写简洁的代码

1. 避免深度嵌套

在实际开发中，有时会因为一些条件 or 逻辑的限制导致 if/else, for/while等语句深深嵌套，这是一个代码质量不高的体现，因为嵌套中我们很难一下子理解程序运行的流程以及代码实现的功能，从而给后期的维护和优化带来了困难。

例如下面这个伪代码：

for($i=0;$i<2;$i++){
  if($i==0){
    for($j=0;$j<3;$j++){
      if($j==0){
        //do something
      }else if($j==1){
        //do something else
      }else{
        //do something other
      }
    }
  }else{
    for($j=0;$j<4;$j++){
      if($j==0){
        //do something
      }else if($j==1){
        //do something else
      }else if($j==2){
        //do something more
      }else{
        //do something other
      }
    }
  }
}

上述代码中的if和for语句嵌套比较多，导致代码可读性比较差。为了突出代码重点，可以使用函数/类的方式进行重构，如下：

function function1(){
  //do something
}
function function2(){
  //do something else
}
function function3(){
  //do something more
}
function function4(){
  //do something other
}

for($i=0;$i<2;$i++){
    if($i==0){
        for($j=0;$j<3;$j++){
            if($j==0){
                function1();
            }else if($j==1){
                function2();
            }else{
                function4();
            }
        }
    }else{
        for($j=0;$j<4;$j++){
            if($j==0){
                function1();
            }else if($j==1){
                function2();
            }else if($j==2){
                function3();
            }else{
                function4();
            }
        }
    }
}

使用函数/类的方式，把代码拆分成更小，更清晰的部分，提高了代码的可读性，同时也让代码更易于维护。

2. 使用函数来封装重复代码

在很多情况下，我们需要对一段代码进行重复调用。如果这时直接复制代码片段然后粘贴，在后期的维护和改动中就会产生很大的麻烦，因为需求变化就需要修改多处代码，这也是一个不太优秀的实现方式。

下面这个伪代码演示了具有重复代码的一个函数：

function callApi1(){
  //发送网络请求1
  //解析返回结果1
  //返回结果
}
function callApi2(){
  //发送网络请求2
  //解析返回结果2
  //返回结果
}
//调用
$result1 = callApi1();
$result2 = callApi2();

为了避免复制粘贴和需求变化时修改多处代码的问题，可以把重复的代码进行封装，使用函数/类的方式对其进行抽象，如下：

function callApi($url){
  //发送网络请求
  $response = sendRequest($url);
  //解析返回结果
  $result = parseResponse($response);
  //返回结果
  return $result;
}
//调用
$result1 = callApi($url1);
$result2 = callApi($url2);

使用抽象出来的函数/类进行封装，减少了代码的冗余，利于后期的维护，同时也提高了代码的重复利用率。