首先確保CentOS系統已安裝PHP及開發工具(php-devel
、php-pear
),然后通過PECL安裝Xdebug:
sudo yum install php-devel php-pear -y
sudo pecl install xdebug
安裝完成后,需記錄Xdebug擴展的路徑(如/usr/lib64/php/modules/xdebug.so
),后續需在php.ini
中引用。
找到PHP的配置文件(可通過php --ini
命令查看,通常為/etc/php.ini
或/etc/php.d/99-xdebug.ini
),添加以下Xdebug配置(關鍵參數說明):
[xdebug]
zend_extension=xdebug.so # Xdebug擴展路徑(若通過PECL安裝,可直接寫模塊名)
xdebug.mode=debug # 啟用調試模式(Xdebug 3+必需)
xdebug.client_host=127.0.0.1 # 調試客戶端地址(即PhpStorm所在機器IP,本地調試用127.0.0.1)
xdebug.client_port=9003 # 調試端口(默認9003,需與PhpStorm配置一致)
xdebug.idekey=PHPSTORM # IDE標識符,用于關聯PhpStorm(需與PhpStorm設置一致)
修改后保存文件。
使php.ini
配置生效,根據使用的Web服務器執行對應命令:
sudo systemctl restart httpd
sudo systemctl restart nginx && sudo systemctl restart php-fpm
創建info.php
文件(路徑如/var/www/html/info.php
),內容為:
<?php phpinfo(); ?>
在瀏覽器中訪問http://your_server_ip/info.php
,搜索“Xdebug”,若出現Xdebug配置信息(如版本、模式),則說明安裝成功。
打開PhpStorm,進入File -> Settings -> PHP
,點擊“…”選擇PHP解釋器。確保已添加本地或遠程PHP解釋器(如/usr/bin/php
),并檢查Xdebug擴展是否在“Loaded Extensions”列表中。
進入File -> Settings -> PHP -> Servers
,點擊“+”添加新服務器:
127.0.0.1
,遠程調試填服務器IP);80
、443
或8080
);/home/user/project
對應服務器/var/www/html
)。進入File -> Settings -> PHP -> Debug
,檢查以下配置:
php.ini
中xdebug.client_port
一致的端口(默認9003
);php.ini
中xdebug.idekey
一致的值(PHPSTORM
);http://localhost
)。PhpStorm會自動捕獲Xdebug連接,暫停在斷點處。xdebug.client_port
(如9003
)的入站連接:sudo firewall-cmd --add-port=9003/tcp --permanent && sudo firewall-cmd --reload
。php.ini
中的zend_extension
路徑是否正確,以及xdebug.mode
是否設置為debug
。