推薦代碼調試工具 Xdebug

寫代碼總繞不過須要調試，除了 UnitTest 外，咱們仍是須要藉助 Xdebug 進行調試。

因此今天來講說如何基於本地 Docker 環境下，使用 Xdebug。

這裏的使用，是分別整合到 VS Code 和 PHPStorm 下。

安裝 Xdebug

仍是基於神級武器 —— Laradock。咱們先看看 Laradock 官網是怎麼安裝 Xdebug。

Install xDebug#

1 - First install xDebug in the Workspace and the PHP-FPM Containers:

a) open the .env file
b) search for the WORKSPACE_INSTALL_XDEBUG argument under the Workspace Container
c) set it to true
d) search for the PHP_FPM_INSTALL_XDEBUG argument under the PHP-FPM Container
e) set it to true

2 - Re-build the containers docker-compose build workspace php-fpm

參考：https://laradock.io/documentation/#install-xdebug

咱們修改對應的地方，而後 build，若是出現下面的錯誤提示：

嘗試添加國內源試試：

RUN  sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list

從新 docker-compose up -d nginx 後，在 Windows / Mac 下用命令 ./php-fpm/xdebug status 查看安裝狀態：

配置 Xdebug

目前開發使用 IDE，我的以爲廣泛用的最多的就是 VS Code 和 PHPStorm。因此下面就利用這兩個 IDE，分別說說如何使用 Xdebug 的。

VS Code

在 VS Code 下，若是沒安裝 Xdebug 插件，直接搜索安裝便可：

安裝後，增長 Xdebug 環境配置：

這樣就會項目的 .vscode 文件夾下多了一個 Xdebug 配置文件 launch.json，咱們配置端口號與 php-fpm 下的 Xdebug 一致，咱們再配置 pathMappings 讓 docker 下的項目路徑與本地項目路徑關聯。具體以下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "XDebug listening to Laradock",
            "log": true,
            "type": "php",
            "request": "launch",
            "port": 9000,
            "pathMappings": {
                "/var/www/myrss": "${workspaceFolder}",
            }
        },
        {
            "name": "Launch currently open script",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "port": 9000
        }
    ]
}

好了，咱們啓動 XDebug，打印出以下內容，即表示等待請求：

咱們寫個 Demo，並設置斷點：

Artisan::command('hello', function () {
    $i = 0;
    $i++;

    return "hello".$i;
});

而後啓動 Xdebug，並執行命令：

php artisan hello

咱們能夠看到不少輸入、輸出、斷點等信息：

其中咱們也能看到此時的變量 $i 處於未初始狀態：

咱們在這斷點繼續往下執行：

PHPStorm

在 Mac 或者 Windows 10 下 Docker 的默認 ip 爲：10.0.75.1，

咱們先增長一個 Server，其中：

• Name：laradock
• Host: 10.0.75.1
• mappings，等同於上文 VS Code 配置的 pathMappings

而後，能夠新建 PHP Remote Debug，其中：

• Server：關聯到咱們上面建的 laradock
• IDE key：和 Laradock‘s php-fpm 中配置的保持一致便可

好了，咱們可使用 demo，建立斷點，運行 Debug 等待請求：：

同樣的，執行命令：php artisan hello：

咱們繼續往下走：

總結

用好 Xdebug，更加直觀的瞭解方法中每一個變量的動態變化，能提升咱們跟蹤和排查代碼的問題所在。至於下一步如何更好的使用 Xdebug，就看各自的實際項目和開發須要了。

參考

1. Setting up xDebug with PHPUnit using Docker for Mac and PHPStorm https://intellij-support.jetbrains.com/hc/en-us/community/posts/360000229624-Setting-up-xDebug-with-PHPUnit-using-Docker-for-Mac-and-PHPStorm
2. Laradock + XDebug + MS Code? No problem https://medium.com/full-stack-development/laradock-xdebug-ms-code-no-problem-35a4338deb3f
3. Laradock的xdebug在vscode上使用的配置 https://www.itread01.com/content/1526278934.html
4. 如何設定VSCode XDebug在laradock環境上 https://blog.scottchayaa.com/post/2018/10/16/vscode-phpunit-on-laradock/