一文掌握PHP Xdebug 本地與遠程調試

原文連接：一文掌握PHP Xdebug 本地與遠程調試

好久沒寫PHP了、一樣很好久沒有用XDebug了，近期有個簡單的場景要用到，簡單記錄一下關鍵步驟。

本地調試

本地環境:

$ php -v
PHP 7.3.4 (cli) (built: Apr  8 2019 10:21:33) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.4, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.3.4, Copyright (c) 1999-2018, by Zend Technologies
    with Xdebug v2.7.1, Copyright (c) 2002-2019, by Derick Rethans

環境搭建

// 安裝xdebug
$ pecl install xdebug

// 配置xdebug
$ vim /usr/local/etc/php/7.3/conf.d/ext-xdebug.ini

[xdebug]
 zend_extension="xdebug.so"
 xdebug.remote_enable=On
 xdebug.remote_port=9001
 xdebug.idekey=PHPSTORM
 xdebug.remote_connect_back = 1

// 重啓php服務
$ brew services restart php@7.3

IDE 配置

我是在~/Downloads/xdebug/ 目錄下放了一個簡單的PHP文件test.php來測試，在這個目錄下用php -S 127.0.0.1:7790起了個http服務，可參考進行下述配置。

IDEA的幾個配置項



開啓監聽

效果演示

設置以後, 在IDE裏打上斷點, 在瀏覽器打開這個連接便可開啓測試

http://127.0.0.1:7790/test.php?XDEBUG_SESSION_START=PHPSTORM

效果以下:

瀏覽器沒有必要安裝 Xdebug Helper 插件。

---

遠程調試

與上一篇聯動, 本篇是遠程調試, 主要記錄一下過程

本地環境:

# php -v
PHP 7.2.16 (cli) (built: Mar 10 2019 21:22:49) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Xdebug v2.8.0-dev, Copyright (c) 2002-2019, by Derick Rethans

環境搭建

// 若是沒有安裝過須要先行安裝
# yum install -y php-devel gcc

// 安裝xdebug
# cd /usr/local/src
# git clone https://github.com/xdebug/xdebug.git
# cd xdebug
# ./rebuild.sh

// xdebug配置文件
# vim /etc/php.d/xdebug.ini

zend_extension=xdebug.so
xdebug.remote_enable=On
xdebug.remote_port=11955
xdebug.idekey=PHPSTORM

// 重啓PHP服務
# systemctl restart php-fpm
# systemctl status php-fpm

而後重點來了，必定不要忘記開放上面配置的xdebug.remote_port端口號，開放此端口號、開放此端口號、開放此端口號。

開放端口每一個系統都不太同樣，在CentOS7中可使用firewall-cmd來操做

# firewall-cmd --zone=public --add-port=11955/tcp --permanent
# firewall-cmd --reload

IDE 配置

IDE的配置與本地調試不太同樣，總的來講有兩種方式，一種是經過在IDE配置Remote Debug, 須要配置登陸遠端服務器；一種是經過ssh來作遠程端口轉發到本地來實現相似本地調試的方式。
在這裏，我選用了後一種方式來操做。

遠程端口轉發

// HOST 爲遠程服務器在~/.ssh/config的配置host名, 能夠替換爲你的 好比 root@1.1.1.1
ssh -NT -R 11955:127.0.0.1:9001 HOST

這樣就實現了遠程xdebug端口11955到本地9001的映射。

IDE配置

與本地調試的配置不同的地方就是host和port，其餘地方大同小異。

IDEA-PHP-Servers的配置:
host 爲遠程web服務的域名, port 爲遠程web提供服務的端口號。
同時須要注意的是：須要勾選 path mappings, 並正確配置要debug的工程目錄在遠程和本地兩個環境的映射關係。

IDEA-PHP-XDebug-DBGp-Proxy的配置:
更改host和port爲遠程web服務配置，與上一步相同

效果演示

設置以後, 在IDE裏打上斷點, 在瀏覽器打開這個連接便可開啓測試

http://example.com/test.php?X...

效果以下:

一樣的，瀏覽器沒有必要安裝 Xdebug Helper 插件。