编译 PHP 8.0.27 并启用调试能力需启用 ZTS、--enable-debug、--enable-phpdbg 等关键参数，安装调试依赖，禁用非必要模块，并通过 phpdbg/gdb/VS Code 进行断点调试。
编译 PHP 8.0.27 源码并开启调试能力，核心在于启用 ZTS（Zend Thread Safety）支持、编译调试符号、保留 Zend 扩展接口，并配合 GDB 或 IDE 进行断点调试。这不是简单 ./configure && make 就能完成的事，尤其在生产级调试场景下，需兼顾可调试性与运行一致性。
以下步骤基于 Linux（如 RHEL 7.6 / Ubuntu 20.04+）环境，已验证适用于 PHP 8.0.27 源码包（官方 tar.gz 版本）：
✅ 编译前准备：安装依赖与清理环境
确保系统已安装基础开发工具链和调试依赖：
# Ubuntu/Debian sudo apt update && sudo apt install -y \ build-essential autoconf bison re2c libxml2-dev libsqlite3-dev \ libonig-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev \ libssl-dev libgmp-dev libsodium-dev gdb valgrind # RHEL/CentOS 7/8 sudo yum groupinstall -y "Development Tools" sudo yum install -y \ autoconf bison re2c libxml2-devel sqlite-devel oniguruma-devel \ curl-devel libjpeg-devel libpng-devel freetype-devel openssl-devel \ gmp-devel libsodium-devel gdb valgrind
⚠️ 注意：不要用
phpize或pecl安装扩展；所有扩展应通过--enable-*或--with-*在主 configure 阶段声明，否则调试时符号可能缺失。立即学习“PHP免费学习笔记（深入）”；
✅ 配置阶段：关键参数启用调试支持
进入解压后的 PHP 源码目录（如 php-8.0.27/），执行：
./configure \ --prefix=/usr/local/php8027-debug \ --enable-debug \ --enable-zts \ --enable-maintainer-zts \ --with-zend-multibyte \ --with-curl \ --with-openssl \ --with-gd \ --with-jpeg \ --with-png \ --with-freetype \ --enable-opcache \ --enable-cli \ --enable-phpdbg \ --without-iconv \ --disable-cgi \ --disable-fpm \ --disable-phpdbg-webhelper
重点说明：
-
--enable-debug：生成带完整调试符号（DWARF）的二进制，gdb php可见变量名、函数栈、源码行号； -
--enable-zts+--enable-maintainer-zts：启用线程安全模式，是phpdbg和部分扩展（如 pthreads 模拟）调试前提； -
--enable-phpdbg：内置轻量级 CLI 调试器，支持phpdbg -qrr script.php启动交互式调试； -
--without-iconv：避免某些旧版 iconv 库引发的符号冲突（常见于 RHEL 7）； -
--disable-fpm/--disable-cgi：聚焦 CLI 调试，减少干扰模块；后续如需 FPM 调试，可单独加--enable-fpm --with-fpm-systemd并用gdb --args /path/to/php-fpm -F。
✅ 编译与安装
make -j$(nproc) # 利用全部 CPU 核心加速 sudo make install
安装后验证：
/usr/local/php8027-debug/bin/php -v # 输出应含 "debug" 字样，例如： # PHP 8.0.27 (cli) (built: Sep 15 2026 09:15:22) (DEBUG)
检查调试符号是否有效：
file /usr/local/php8027-debug/bin/php | grep debug # 应输出包含 "with debug info" readelf -S /usr/local/php8027-debug/bin/php | grep debug
✅ 调试实操：三种常用方式
▪ 用 phpdbg 快速断点调试（推荐入门）
/usr/local/php8027-debug/bin/phpdbg -qrr -e index.php # 进入交互后输入： # (phpdbg) break index.php:10 # (phpdbg) run # (phpdbg) print $varname
▪ 用 gdb 调试 CLI 脚本（适合深入 Zend 内核）
gdb --args /usr/local/php8027-debug/bin/php index.php (gdb) break zend_execute_ex (gdb) run (gdb) bt # 查看调用栈 (gdb) info locals # 查看局部变量（需源码路径正确）
? 提示：若
gdb提示找不到源码，执行set substitute-path /path/to/php-src /your/real/path/php-8.0.27
▪ 配合 VS Code + php-debug 插件（图形化友好）
需额外配置 launch.json，指定 "runtimeExecutable" 为 /usr/local/php8027-debug/bin/php，并确保 php.ini 中 zend_extension=phpdbg.so 已启用（phpdbg.so 位于 /usr/local/php8027-debug/lib/php/extensions/debug-zts-*/ 下）。
不复杂但容易忽略：
编译后的 php 二进制默认不加载任何扩展，调试前务必用 -d extension=xxx.so 显式启用，或复制一份 php.ini-development 到 /usr/local/php8027-debug/lib/ 并修改 extension_dir 指向正确的 debug 扩展目录。
