前言

有亿亿点点久没有写博客了(开摆了、😭)

本文主要记录📝如何在macOS中从零开始用PhpStorm配置Xdebug调试.

官方文档参考: 配置Xdebug | PhpStorm 文档 零配置调试 | PhpStorm 文档

Xdebug: Documentation » Installation Xdebug: Documentation » All settings

环境(截止文章发布为最新版):

macOS 13.4 Beta版(22F5059b)

PHP 8.2.5 (cli) (built: Apr 13 2023 17:59:46) (安装:brew install php)

Xdebug v3.2.1, Copyright (c) 2002-2023, by Derick Rethans

PhpStorm 2023.1.1 Build #PS-231.8770.68, built on April 28, 2023

配置 Xdebug

安装Xdebug

1
2
3

mkdir /opt/homebrew/lib/php/pecl
arch -arm64 sudo pecl install xdebug # ARM架构(苹果芯片)用户
arch -x86_64 sudo pecl install xdebug # 非ARM架构,也可用命令pecl install xdebug

记录📝文件位置

zend_extension="/opt/homebrew/Cellar/php/8.2.5/pecl/20220829/xdebug.so"

查找php.ini位置

1

php --ini

路径:/opt/homebrew/etc/php/8.2/php.ini

编辑php.ini文件

1
2
3
4
5
6

zend_extension="xdebug.so"
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port="9003"
xdebug.start_upon_error=yes# 可选
xdebug.idekey=PHPSTORM# 可选

提供2种方案,第一种直接调试,方便快捷,第二种,通过web服务器方式,略显麻烦.

在PhpStorm中配置Xdebug

配置服务器端口:9002 (采用方案一可跳过)

配置DBGp代理

至此,IDE的配置完成,接下来在项目中进行单独配置.

项目中配置Web服务器

(采用方案一可跳过)

接下来开启PHP调试连接,然后运行这个web服务器(即本地调试)

在浏览器上激活调试器

在Chrome浏览器中安装此插件 Xdebug helper - Chrome 应用商店 可帮助你设置一个特殊的GET/POST或COOKIE参数来启动和停止调试引擎.

例如下图,处于Debug状态可帮助你直接在浏览器中访问而无需带上参数,例如:http://localhost:9002/phpinfo.php

需注意一点,若采用方案一,第一次调试会弹出对话框,对话框中可以选择路径映射,以便PhpStorm可以将Web服务器上的远程文件映射到项目中的本地文件.但一般不用管,直接接受就行了.