手把手教你phpstorm如何調試Docker中PHP項目

本機一直使用docker開發，對于習慣使用調試的人來說，PHP放在docker容器中又多了一層難度。

當然，這只適用于還不懂配置的時候，一旦掌握竅門，其實是簡單不過的事情，和本機配置幾乎無任何難度差別。

1 環境

開始之前，我們先做一些環境假設：

• 本機安裝了docker
• 有一個安裝了xdebug擴展的PHP容器
• 代碼在本機的目錄是：/Users/gary/dnmp/www/localhost
• 代碼映射到容器目錄：/var/www/html/localhost
• 項目使用域名localhost，并在主機hosts和nginx配置中綁定
• PHP-FPM通過9000端口與nginx容器/應用連接

這里的域名不一定是localhost，如果你用了Laravel、Yii、Thinkphp等框架，那一般會用類似 mydev.com、dev.awaimai.com、awaimai.dev的域名，本文一樣適用。

2 php.ini配置

主要配置如下：

[XDebug]  xdebug.remote_enable = 1  xdebug.remote_handler = "dbgp"  xdebug.remote_host = host.docker.internal

這幾行的作用是：

• 開啟xdebug遠程調試
• 調試方式用dggp
• 遠程地址用host.docker.internal，也就是docker容器所在的主機。如果主機是Linux系統，host.docker.internal可能用不了，需要改用PHP容器和主機同一虛擬網絡下的IP，在主機中用docker network inspect dnmp_default命令可找到，其中dnmp_default是容器的所在的網絡。

這里我們沒有配置xdebug.remote_port，因為xdebug默認使用9000，與我們FPM一致了，不用再設置。如果FPM使用其他端口，remote_port也要改成相應端口。

配置完成后，重啟PHP容器。

2 PHPStorm配置

1 菜單選擇 Run – Edit Configurations，

2 在彈出的框中點左上角的 + 號，選擇 PHP Web Page。

3 現在還沒有任何的服務器，我們要加一個。如下，點擊 server 右側的 ... 按鈕。

4 然后就是配置服務器的信息，這里就是docker容器了。

• Name：服務器名稱，隨便寫都可以。
• Host：域名，這里我用localhost，如果你的域名類似awaimai.dev，那就填awaimai.dev。
• Port：連接服務器的端口。這里我們通過nginx連到PHP，用的是80端口，所以這里保留默認80。
• Debugger：用Xdebug。
• Use path mappings：這里一定要勾選，然后填寫本地代碼與容器代碼的映射關系。如果用的是框架，這里就填框架的根目錄。

然后點擊OK保存。

5 返回后，

• Name：填寫一個配置名稱，隨便填，這里我們調試首頁，填Index。
• Server：下拉選擇服務器，這里我們選擇剛加的localhost。
• Start URL：起始調試的頁面，/表示首頁，如果是其他頁面，比如/home/index，那就填/home/index。

點擊OK保存。

3 開始調試

返回代碼窗口，在代碼前打一個【斷點】，再點擊【調試按鈕】，如下：

PHPStorm就會自動打開瀏覽器，等程序執行到斷點時，自動停止。

這里我們就可以看到PHP中的全局變量、調用棧、臨時變量，

并且可以單步調試，非常方便。