作者: 日落

前陣子從 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"
}

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