標籤: PHP

前陣子從 gslin 那邊看到 PHPStan 這個工具，剛好手上有需要測試的程式，就拿來掃一掃。常見的問題大多都可以抓到，甚至連 doc comment 有錯誤也會抓出來。

下面弄個個 demo code 讓大家稍微看一下實際狀況。

Hello.php:

<?php
namespace Zero;

class Hello
{
    /**
     * @param array $name
     */
    public function greeting(): void
    {
        $test = '123';
        echo "Hello $namen";
    }
}

bootstrap.php:

<?php
require __DIR__ . '/../vendor/autoload.php';

$hello = new ZeroHello();
$hello->greeting(123);

然後執行 PHPStan 做 level 5 的分析：

 ------ ------------------------------------------------------ 
  Line   src/Hello.php                                         
 ------ ------------------------------------------------------ 
  10     PHPDoc tag @param references unknown parameter $name  
  14     Undefined variable: $name                             
 ------ ------------------------------------------------------ 

 ------ --------------------------------------------------------------------- 
  Line   src/bootstrap.php                                                    
 ------ --------------------------------------------------------------------- 
  7      Method ZeroHello::greeting() invoked with 1 parameter, 0 required.  
 ------ ---------------------------------------------------------------------

從 PHPStan 給的錯誤訊息，就可以在執行 PHP 之前預防錯誤發生。

不過有一些比較可惜的地方：

• PHPStan 一定要吃 autoload 規則，看起來是為了要解 PHP Refelction 問題，所以比較就的程式就 GG 了
• Hello.php 裡面有個沒使用到的變數 $test 沒有被抓到，不然應該可以再把程式清的更乾淨

今天遇到很奇怪的行為，在 PostMan 將 HTTP POST data 丟給 PHP 以後，參數名稱裡面有 . (dot) 的字元，全部都被改為 _ (underscore) 了。像是 field 名稱為「article.title」的欄位名稱，在 PHP 底下取值必須使用 $_POST[‘article_title’]。

原本以為 RFC 裡面有的定義 reserve word，但是找了半天找不到。最後原因是 PHP 為了支援 register_global，但是 PHP 變數名稱又不允許使用 . (dot) 當作名稱的一部分，最後就自動轉為 _ (underscore)。

這個行為不管有沒有啟動 register_global 都會出現，即使上了 PHP 7.2 都已經不支援了，這個行為仍然存在。

ref:

• https://stackoverflow.com/a/3742678/8681141
• PHP: Variables From External Sources – Manual

後來做了個簡單的測試，在 HTTP POST 依序送出二個 field data：

a.b=100&a_b=200

這時候再印出 $_POST：

var_dump($_POST);

array(1) {
  'a_b' =>
  string(3) "200"
}

所以後面的會打贏前面的 … (所以「世界上的戰爭沒任何人贏了，只有戰爭贏了」)

看到有 Java 工程師在學 PHP 遇到變數初始化的問題，覺得有趣，做個筆記順便複習 PHP 的特性。

Java 是強型別 (strong type) 的程式語言，所有的變數在使用之前都必須給資料型態以及初始值；PHP 則是弱型別，就算不給值、不給資料型態也沒差，interpreter 會在 runtime 的時候自動做型別轉換在繼續執行程式。我想 PHP 這一特性就會讓很多 Java 工程師決得很莫名其妙吧，沒定義的變數到底要怎麼用？執行的時候真的不會出事嗎？ (其實就是會 XD)

先來看正常的寫法：

$x = 'hello';
var_dump($x);  // "hello"

如果變數沒有給值會發生什麼事？

var_dump($x);  // NULL

PHP 把沒有初始化的變數帶入 NULL 來使用，連錯誤訊息都沒噴耶？其實有，只是要調整一下 error reporting 的 level：

error_reporting(E_ALL);

var_dump($x);

// Notice: Undefined variable: x
// NULL

如果拿一個完全沒有被初始化的變數做運算，interpreter 到底會怎麼轉型：

var_dump('123' . $x);  // "123"

$x[] = '123';
var_dump($x);  // array([0] => "123")

好像很強耶，居然會自動轉陣列！那換個方式來玩玩看：

$list = [1, 2, 3];

array_merge($list, $x);

// PHP Warning:  array_merge(): Argument #2 is not an array

其實還是會遇到 interpreter 沒辦法幫你作主的時候。

以 PHP 這類的弱型別寫法，比較保險的作法就是去檢查要被使用的變數到底是否有初始化：

if (isset($x)) {
    var_dump($x);
} else {
    echo 'undefine';
}

// "undefine"

所以使用 PHP 寫程式時變數到底是否需要初始化？其實可以不用，但是若要保險起見 (防禦性程式設計)，要用到的變數建議都要初始化、或是做檢查。StackOverflow 上也有提到：
PHP does not require it, but it is a good practice to always initialize your variables.