源码编译php不是一键部署，需手动管理依赖、配置和生命周期，适合定制sapi、调试核心或验证补丁；普通开发推荐包管理器。
直接编译安装 PHP 源码不是“一键部署”，而是需要你主动管理依赖、配置和生命周期；它适合需要定制 SAPI（如 embed、phpdbg）、调试核心、或验证某个未发布补丁的场景，普通 Web 开发用包管理器（apt / brew / phpbrew）更稳妥。
确认系统基础依赖是否齐全
PHP 编译过程会失败于静默缺失的工具链或头文件，而不是报出明确的“缺 xx”——常见卡点包括：autoconf、libxml2-dev、zlib1g-dev、openssl-dev（或 libssl-dev）、curl-dev。macOS 用户需额外确保 Xcode Command Line Tools 已安装（xcode-select --install），且 pkg-config 可用。
建议一次性装全（以 Ubuntu/Debian 为例）：
sudo apt update && sudo apt install -y \ build-essential autoconf automake libtool \ pkg-config re2c bison \ libxml2-dev libsqlite3-dev libonig-dev \ libcurl4-openssl-dev libssl-dev zlib1g-dev \ libpng-dev libjpeg-dev libfreetype6-dev
注意：libonig-dev 是 PHP 7.3+ 正则引擎必需，漏掉会导致 configure 阶段通过但 make 报 oniguruma.h: No such file 错误。
立即学习“PHP免费学习笔记（深入）”；
configure 参数选哪些才不踩坑
./configure 不是参数越多越好。默认启用太多扩展反而容易因依赖缺失中断编译；应按需显式开启，其余靠 make install 后用 php -m 验证，再通过 ext/xxx/config0.m4 手动启用。
最小可用 Web 环境推荐组合：
./configure \ --prefix=/usr/local/php-dev \ --with-cli \ --with-apxs2=/usr/bin/apxs2 \ --enable-fpm \ --with-curl \ --with-openssl \ --with-zlib \ --enable-mbstring \ --with-pdo-sqlite \ --with-sqlite3
关键说明：
-
--prefix必须指定，否则默认装到/usr/local，易与系统包冲突 -
--with-apxs2路径要真实存在（Ubuntu 是/usr/bin/apxs2，CentOS 是/usr/sbin/apxs），否则 FPM 成为唯一可用 SAPI - 不要加
--enable-debug到生产环境构建，它会让 PHP 运行慢 3–5 倍且禁用 OPcache -
--with-openssl和--with-curl若提示找不到库，检查是否装了libssl-dev（头文件）而非仅openssl（二进制）
make 时遇到 “undefined reference to `BZ2_bzDecompressInit’” 类链接错误
这是典型的静态链接阶段找不到 libbz2 符号，原因通常是：libbz2-dev 未安装，或 configure 时没触发检测（比如你没加 --with-bz2，但某个依赖扩展（如 phar）悄悄启用了它）。
解决方式分两步：
- 先装依赖：
sudo apt install libbz2-dev（Ubuntu/Debian）或brew install bzip2（macOS） - 重新运行
./configure（不必make clean，configure 会覆盖旧缓存） - 若仍报错，临时关闭相关模块：在
ext/phar/config0.m4中注释掉PHP_ARG_WITH(bz2, ...)相关段，或 configure 时加--without-bz2
这类错误本质是 configure 脚本对系统库探测不鲁棒，不能只看报错位置，得回溯 configure 输出里有没有 checking for BZ2 support... no 这类提示。
源码编译最耗时间的环节其实是反复试错——依赖漏一个、路径写错一位、configure 参数互斥，都可能导致 make 卡在 97% 然后崩。建议把 ./configure 命令保存为 build.sh，每次改完先 git clean -xfd 再重来，比手动删 Makefile 和 config.status 更可靠。
