php調試核心工具是xdebug，其配置主要包括設置xdebug.mode、xdebug.client_host與xdebug.client_port。1. 安裝xdebug可通過pecl install xdebug或dockerfile添加擴展；2. 配置php.ini啟用zend_extension并設定調試模式與端口；3. 重啟web服務器使配置生效；4. 在ide（如vs code或phpstorm）中配置launch.json及路徑映射；5. 調試時設置斷點并啟動監聽；6. 若連接失敗，需檢查擴展加載、配置參數、防火墻、路徑映射及網絡連通性；7. xdebug支持多種模式，如debug、develop、coverage、profile等，按需選用；8. 遠程調試需配置client_host為本地ip，并確保網絡可達或使用ssh隧道；9. 其他調試工具包括kint、ray、php_codesniffer與blackfire.io，可依需求配合使用。
PHP調試，說白了，就是讓代碼慢下來，然后我們像醫生給病人做檢查一樣，一步一步地看，到底哪里出了問題。Xdebug，就是那個“聽診器”。
Xdebug配置與使用
Xdebug的配置，說復雜也復雜，說簡單也簡單。關鍵在于搞清楚幾個核心參數：xdebug.mode、xdebug.client_host、xdebug.client_port。
-
安裝Xdebug: 這個步驟根據你的PHP環境有所不同。如果你用的是docker，可以直接在Dockerfile里加上pecl install xdebug。如果是本地環境，用pecl install xdebug或者通過你的包管理器安裝。
立即學習“PHP免費學習筆記（深入）”；
-
配置php.ini: 找到你的php.ini文件（可以通過phpinfo()函數找到），然后添加或修改以下配置：
zend_extension=xdebug.so xdebug.mode=debug xdebug.client_host=127.0.0.1 xdebug.client_port=9000
- zend_extension=xdebug.so：啟用Xdebug擴展。
- xdebug.mode=debug：設置Xdebug的工作模式為調試。
- xdebug.client_host=127.0.0.1：指定調試客戶端（比如你的IDE）所在的IP地址。通常是本地地址。
- xdebug.client_port=9000：指定調試客戶端監聽的端口。
注意： Xdebug 3.x版本和之前的版本在配置上有些差異，主要是xdebug.remote_enable被xdebug.mode取代了。
-
配置IDE: 接下來，需要在你的IDE（比如VS Code、phpstorm）里配置Xdebug。
-
VS Code: 安裝PHP Debug擴展，然后在launch.json文件中配置debug選項。
{ "version": "0.2.0", "configurations": [ { "name": "Listen for XDebug", "type": "php", "request": "launch", "port": 9000, "pathMappings": { "/var/www/html": "${workspaceFolder}" } } ] }pathMappings 這一項非常重要，它告訴Xdebug你的代碼在服務器上的路徑和本地路徑的映射關系。 很多調試不成功的情況都是因為這個配置不對。
-
PhpStorm: PhpStorm通常會自動檢測到Xdebug，你只需要配置Server和Debug configuration。
-
-
開始調試: 在你的代碼中設置斷點，然后通過IDE啟動調試。當代碼執行到斷點時，程序會暫停，你就可以查看變量的值、單步執行代碼等等。
如何解決Xdebug無法連接的問題？
Xdebug連不上，是調試過程中最常見的問題之一。排查思路通常是這樣的：
- 檢查Xdebug是否安裝成功： 通過php -v命令查看PHP版本信息，確認Xdebug是否在已加載的擴展列表中。
- 檢查php.ini配置： 確保xdebug.mode、xdebug.client_host、xdebug.client_port配置正確。尤其注意端口號是否被占用。
- 檢查防火墻： 確保你的防火墻沒有阻止9000端口的連接。
- 檢查IDE配置： 確保IDE的調試配置正確，包括端口號、路徑映射等。
- 檢查網絡： 如果你的代碼運行在虛擬機或Docker容器中，確保你的主機可以訪問虛擬機或容器的IP地址和端口。
- 嘗試使用xdebug_info()函數： 在你的代碼中調用xdebug_info()函數，查看Xdebug的配置信息。這可以幫助你確認Xdebug是否正確加載和配置。
Xdebug的不同模式有什么區別？
Xdebug 3.x 引入了xdebug.mode配置項，取代了之前的xdebug.remote_enable等配置。xdebug.mode可以設置為以下幾個值：
- debug：啟用調試功能。這是最常用的模式。
- develop：啟用開發輔助功能，比如顯示錯誤信息、堆棧跟蹤等。
- coverage：啟用代碼覆蓋率分析功能。
- profile：啟用性能分析功能。
- off：禁用Xdebug。
你可以根據需要選擇合適的模式。通常情況下，調試代碼時使用debug模式，分析性能時使用profile模式。
如何使用Xdebug進行遠程調試？
遠程調試是指你的代碼運行在遠程服務器上，而你的IDE運行在本地。要進行遠程調試，需要做一些額外的配置：
- 確保遠程服務器可以訪問你的本地機器： 你需要知道你的本地機器的IP地址，并確保遠程服務器可以訪問這個IP地址和9000端口。
- 配置xdebug.client_host為你的本地機器的IP地址： 在遠程服務器的php.ini文件中，將xdebug.client_host設置為你的本地機器的IP地址。
- 配置IDE的調試選項： 在IDE中配置調試選項，指定遠程服務器的IP地址和端口號。
- 配置SSH隧道（可選）： 如果你的遠程服務器位于防火墻后面，你可以使用SSH隧道將遠程服務器的9000端口轉發到你的本地機器。
遠程調試可能會涉及到一些網絡配置，需要根據你的實際情況進行調整。
除了Xdebug，還有哪些PHP調試工具？
除了Xdebug，還有一些其他的PHP調試工具，比如：
- Kint: 一個強大的調試工具，可以以更友好的方式顯示變量的值。
- Ray: 一個現代化的調試工具，可以將調試信息發送到桌面應用程序。
- PHP_CodeSniffer: 一個代碼風格檢查工具，可以幫助你保持代碼的風格一致。
- Blackfire.io: 一個專業的性能分析工具，可以幫助你找到代碼中的性能瓶頸。
選擇合適的調試工具取決于你的具體需求。Xdebug是調試代碼的首選工具，而其他的工具可以幫助你進行代碼風格檢查、性能分析等。
