M1 Mac上通过Pecl安装Xdebug失败求助（PHP为Homebrew安装）

环境信息 #

• PHP 架构验证：

❯ file $(which php)
/opt/homebrew/bin/php: Mach-O 64-bit executable arm64

• PHP 版本：

❯ php --version
PHP 8.2.0 (cli) (built: Dec  9 2022 16:19:06) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.0, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.0, Copyright (c), by Zend Technologies

尝试过的安装命令 #

• arch -arm64 pecl install xdebug
• sudo pecl install xdebug

报错信息 #

两种方式均触发相同错误，最后4行输出：

checking whether the C compiler works... no
configure: error: in `/private/tmp/pear/temp/pear-build-thatryanKQAoHZ/xdebug-3.2.1':
configure: error: C compiler cannot create executables
See `config.log' for more details
ERROR: `/private/tmp/pear/temp/xdebug/configure --with-php-config=/opt/homebrew/opt/php/bin/php-config' failed

疑问 #

不清楚报错中提到的 config.log 文件所在位置。

解决方案 #

1. 修复 C 编译器问题 #

报错核心是C编译器无法生成可执行文件，先处理基础依赖：

• 安装或重置 Xcode 命令行工具：

  xcode-select --install
  # 若已安装，执行重置
  sudo xcode-select --reset
  

• 验证编译器可用性：

  clang --version
  

  确保输出显示为 arm64 架构的编译器（如 Target: arm64-apple-darwinXX.X）

2. 定位 config.log 文件 #

根据报错路径，config.log 位于临时构建目录：
/private/tmp/pear/temp/pear-build-thatryanKQAoHZ/xdebug-3.2.1/config.log
注意：临时目录可能在安装失败后被自动清理，可重新运行安装命令，在报错前快速访问该路径查看日志。

3. 替代安装方案（推荐） #

直接使用 Homebrew 安装适配的 Xdebug 包，无需手动编译：

• 安装对应 PHP 版本的 Xdebug：

  brew install php@8.2-xdebug
  

• 配置 PHP 加载 Xdebug：
  1. 找到 PHP 配置文件路径：

     php --ini
     

     查看 Loaded Configuration File 对应的路径
  2. 在配置文件末尾添加以下内容：

     zend_extension="xdebug.so"
     xdebug.mode=debug
     xdebug.client_host=localhost
     xdebug.client_port=9003
     

  3. 验证安装：

     php -v
     

     输出中应包含 Xdebug 版本信息

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