PHP代碼靜態分析工具PHPStan

<blockquote>最近發現本身寫的PHP代碼運行結果總跟本身預想的不同，排查時發現大可能是語法錯誤，在運行以前錯誤已經種下。多是本身粗枝大葉，或者說<code>php -l</code>檢測太簡單，不過的確是有一些語法錯誤埋藏得太深（畢竟PHP是動態語言），那麼有沒有辦法，在代碼代碼正式運行以前，把語法錯誤全找出來呢？</blockquote> <p>這裏介紹一款PHP代碼靜態分析工具：<a href="https://github.com/phpstan/phpstan" rel="nofollow noreferrer">PHPStan</a>，不須要運行代碼，也能夠對代碼進行嚴格的語法檢測，儘可能將代碼運行錯誤率降到最低。</p> <h2>PHPStan</h2> <h3>安裝</h3> <p>目前，PHPStan<code>V0.10.2</code>要求系統環境的PHP版本不低於7.1。用Composer全局安裝：</p> ```$ composer global require phpstan/phpstan ```php

<h3>使用</h3> <p>PHPStan靜態分析的使用方法十分簡單：</p> ```$ phpstan analyse [-c|--configuration CONFIGURATION] [-l|--level LEVEL] [--no-progress] [--debug] [-a|--autoload-file AUTOLOAD-FILE] [--errorFormat ERRORFORMAT] [--memory-limit MEMORY-LIMIT] [--] [<paths>]... ```laravel

<ul> <li>configuration：運行配置文件的路徑；</li> <li>level：嚴格級別，0-7，越大越嚴格；</li> <li>no-progress：不顯示進度；</li> <li>debug：debug模式；</li> <li>autoload-file：自動加載文件的路徑；</li> <li>errorFormat：錯誤格式；</li> <li>memory-limit：內存限制；</li> <li>paths：待分析的文件路徑。</li> </ul> <p>好比，分析一個PHP文件：</p> ```$ phpstan analyse --level=7 --autoload-file=/PATH/TO/vendor/autoload.php /PATH/TO/someone.php ```git

<h2>PHPStan in VSCode</h2> <p>固然，語法分析應該是編輯器作的事，寫完代碼還要切換到命令終端執行<code>phpstan</code>，未免過於繁瑣。因此這裏推薦一款VSCode擴展：<a href="https://marketplace.visualstudio.com/items?itemName=breezelin.phpstan" rel="nofollow noreferrer">PHP Static Analysis</a>。</p>github

<p>首先，用Composer全局安裝PHPStan；而後，在VSCode的擴展管理中搜索<code>PHP Static Analysis</code>，安裝第一個匹配的擴展；重載VSCode重載窗口後，擴展會自動分析VSCode下打開的PHP文件。</p> <p>運行效果：<br></p>segmentfault

<p>好比，聲明瞭一個變量未調用，調用了一個未聲明的變量和調用了一個未定義的方法等等這樣錯誤都會被檢測出了。</p> <p>不過，寬鬆一點地來講，其實<code>$this->array()</code>方法是存在的，只是經過魔術方法<code>__call()</code>實現的。</p> <h2>PHPStan with Laravel</h2> <p>高嚴格級別的PHPStan檢測到調用未聲明的類方法時，會報告類中方法不存在的錯誤，即便這個類定義了<code>__call()</code>或<code>__callStatic()</code>。</p> <p>不少應用框架爲了優雅，大量使用了魔術方法，好比<a href="https://laravel.com/" rel="nofollow noreferrer">Laravel</a>。<br>用PHPStan檢測Laravel項目，天然會報告不少調用未聲明類方法的錯誤，對於這個問題，能夠藉助<a href="https://github.com/barryvdh/laravel-ide-helper" rel="nofollow noreferrer">laravel-ide-helper</a>來下降誤報。</p> <h3>安裝laravel-ide-helper</h3> ```$ cd /PATH/TO/LARAVEL_PROJECT $ composer require barryvdh/laravel-ide-helper ```app

<h3>注入LaravelIdeHelper</h3> <p>編輯<code>app/Providers/AppServiceProvider.php</code>裏的註冊方法：</p>composer

&lt;?php
    ...
    public function register()
    {
        if ($this-&gt;app-&gt;environment() !== 'production') {
            $this-&gt;app-&gt;register(\Barryvdh\LaravelIdeHelper\IdeHelperServiceProvider::class);
        }
        // ...
    }

<h3>生成_ide_helper.php</h3> ```$ cd /PATH/TO/LARAVEL_PROJECT $ php artisan ide-helper:generate ```框架

<p>這時，Laravel框架中的Facade類，本來經過<code>__callStatic()</code>獲取的靜態方法，所有在_ide_helper.php聲明瞭，在PHPStan檢測Laravel項目代碼時引入<code>_ide_helper.php</code>文件，就能夠減小誤報。</p> <h3>PHPStan配置</h3> <p>在Laravel項目的根目錄下，新建<code>phpstan.neon</code>文件：</p> ``` parameters: autoload_files: - %currentWorkingDirectory%/_ide_helper.php ```編輯器

<p>在Laravel項目的根目錄下，執行<code>phpstan</code>命令時，會自動使用<code>phpstan.neon</code>這個配置。</p> <h2>最後</h2> <p>代碼的語法錯誤，應該在編寫的時候及時發現，儘可能減小正式運行時錯誤。</p>ide