一文掌握PHP Xdebug 本地與遠(yuǎn)程調(diào)試

MrZONT 發(fā)布于2019-07-01 12:42 / 1716人閱讀

摘要：原文鏈接一文掌握本地與遠(yuǎn)程調(diào)試很久沒寫了同樣很很久沒有用了，近期有個(gè)簡單的場景要用到，簡單記錄一下關(guān)鍵步驟。配置與本地調(diào)試的配置不一樣的地方就是和，其他地方大同小異。

原文鏈接：一文掌握PHP Xdebug 本地與遠(yuǎn)程調(diào)試

很久沒寫PHP了、同樣很很久沒有用XDebug了，近期有個(gè)簡單的場景要用到，簡單記錄一下關(guān)鍵步驟。

本地調(diào)試

本地環(huán)境:

$ 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

環(huán)境搭建

// 安裝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服務(wù)
$ brew services restart php@7.3

IDE 配置

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

IDEA的幾個(gè)配置項(xiàng)

開啟監(jiān)聽

效果演示

設(shè)置之后, 在IDE里打上斷點(diǎn), 在瀏覽器打開這個(gè)鏈接即可開啟測試

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

效果如下:

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

遠(yuǎn)程調(diào)試

與上一篇聯(lián)動(dòng), 本篇是遠(yuǎn)程調(diào)試, 主要記錄一下過程

本地環(huán)境:

# 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

環(huán)境搭建

// 如果沒有安裝過需要先行安裝
# 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服務(wù)
# systemctl restart php-fpm
# systemctl status php-fpm

然后重點(diǎn)來了，一定不要忘記開放上面配置的xdebug.remote_port端口號(hào)，開放此端口號(hào)、開放此端口號(hào)、開放此端口號(hào)。

開放端口每個(gè)系統(tǒng)都不太一樣，在CentOS7中可以使用firewall-cmd來操作

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

IDE 配置

IDE的配置與本地調(diào)試不太一樣，總的來說有兩種方式，一種是通過在IDE配置Remote Debug, 需要配置登錄遠(yuǎn)端服務(wù)器；一種是通過ssh來做遠(yuǎn)程端口轉(zhuǎn)發(fā)到本地來實(shí)現(xiàn)類似本地調(diào)試的方式。
在這里，我選用了后一種方式來操作。

遠(yuǎn)程端口轉(zhuǎn)發(fā)

// HOST 為遠(yuǎn)程服務(wù)器在~/.ssh/config的配置host名, 可以替換為你的 比如 root@1.1.1.1
ssh -NT -R 11955:127.0.0.1:9001 HOST

這樣就實(shí)現(xiàn)了遠(yuǎn)程xdebug端口11955到本地9001的映射。

IDE配置

與本地調(diào)試的配置不一樣的地方就是host和port，其他地方大同小異。

IDEA-PHP-Servers的配置:
host 為遠(yuǎn)程web服務(wù)的域名, port 為遠(yuǎn)程web提供服務(wù)的端口號(hào)。
同時(shí)需要注意的是：需要勾選 path mappings, 并正確配置要debug的工程目錄在遠(yuǎn)程和本地兩個(gè)環(huán)境的映射關(guān)系。

IDEA-PHP-XDebug-DBGp-Proxy的配置:
更改host和port為遠(yuǎn)程web服務(wù)配置，與上一步相同

效果演示

設(shè)置之后, 在IDE里打上斷點(diǎn), 在瀏覽器打開這個(gè)鏈接即可開啟測試