Mac系统Homebrew安装PHP后安装Xdebug失败无法加载问题求助

• 第一步：修复pecl目录软链接错误
  第一次报错failed to mkdir是因为Homebrew安装的PHP路径下/usr/local/Cellar/php/8.0.9/pecl默认是指向/usr/local/lib/php/pecl的软链接，误删后没有重建正确的映射，会导致xdebug.so安装到错误路径，PHP加载时找不到文件。执行以下命令修复：

# 删除异常的pecl文件/目录
rm -rf /usr/local/Cellar/php/8.0.9/pecl
# 创建真实的pecl扩展存放目录
mkdir -p /usr/local/lib/php/pecl/20200930
# 重建软链接
ln -s /usr/local/lib/php/pecl /usr/local/Cellar/php/8.0.9/pecl

• 第二步：重新安装Xdebug
  pecl install xdebug
  安装完成后执行以下命令确认扩展文件存在：
  ls /usr/local/lib/php/pecl/20200930/xdebug.so
  如果没有输出结果，执行find /tmp -name xdebug.so找到编译生成的扩展文件，手动复制到上述路径即可。
• 第三步：配置Xdebug加载路径
  执行php --ini查看PHP加载的配置文件路径，在额外配置目录（默认是/usr/local/etc/php/8.0/conf.d/）下创建99-xdebug.ini，写入以下内容：

zend_extension="/usr/local/lib/php/pecl/20200930/xdebug.so"
# 以下为基础调试配置可按需添加
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_port=9003

不要只填写zend_extension=xdebug，必须填写绝对路径避免PHP找不到扩展。

• 第四步：重启服务验证
  执行命令重启PHP服务：
  brew services restart php
  再执行php -v，输出的Zend部分如果出现Xdebug版本信息即为安装成功。

内容的提问来源于stack exchange，提问作者npreet