本文主要講述了在 Windows10 下使用 Laradock 部署開發環境,配置 Xdebug 調試PHP代碼所遇到的步驟及趟過的一系列坑。
開啓 Xdebug
在 Laradock(此處我是用的是V10.0)的 .env 文件中,具體參見 Laradock文檔:
WORKSPACE_INSTALL_XDEBUG=true
PHP_FPM_INSTALL_XDEBUG=true
然後重新構建容器:
docker-compose build workspace php-fpm
這裏我並沒有更改 laradock/workspace/xdebug.ini
和 laradock/php-fpm/xdebug.ini
, 完全使用默認,也不建議新手對其進行更改。
需要注意的是重新構建容器,容器內需要從外網下載一些依賴文件,由於衆所周知的原因,
這可能會花費一些時間。
好在,新版本的 Laradock 設置了 UBUNTU_SOURCE=ustc 這個配置,可以更改其所使用的Linux操作系統的源。這裏默認是 中科大的源,可以根據自己的需求更改,具體的可以查看laradock/workspace/sources.sh
這個文件。
然後打開 PHPStorm,在File -> Settings -> Lanuages & Frameworks -> PHP -> Servers
,新建一個 Server,保存
由於 xdebug 安裝在容器中,它進行的調試其實是在容器內部進行的,而編輯器(客戶端)在windows上,所以這裏需要進行目錄映射,否則會報錯:
cannot find a local copy of the file …
配置完成後,可以點擊這裏的檢驗進行驗證
驗證結果如下即爲配置正確,最後一句的警告可以忽略
接下來就可以開始代碼的調試了。