需安装系统编译工具链及开发包：Ubuntu/Debian装build-essential和libxml2-dev等，CentOS/RHEL装Development Tools和libxml2-devel等；确认gcc/make在PATH，依赖库用-devel/-dev包；路径须指向含include/lib的父目录。
configure 报错说找不到 gcc 或 make 怎么办
这不是 PHP 本身的问题，而是系统没装基础编译工具链。Linux 发行版默认常不带开发环境，得手动补全。
常见现象：configure: error: no acceptable C compiler found in $PATH 或 make: command not found
- Ubuntu/Debian：运行
sudo apt update && sudo apt install build-essential - CentOS/RHEL 8+：运行
sudo dnf groupinstall "Development Tools" - CentOS/RHEL 7：运行
sudo yum groupinstall "Development Tools"
装完后用 which gcc 和 which make 确认是否在 $PATH 里。如果不在，检查 shell 配置文件（如 ~/.bashrc）是否被修改过，或当前终端是否重新加载了环境。
configure 找不到 libxml2、openssl 等依赖库
PHP 源码编译时会检测扩展依赖的头文件和库文件，只装 runtime 包（比如 libssl1.1）不够，必须装 -dev 或 -devel 后缀的开发包。
立即学习“PHP免费学习笔记（深入）”；
典型错误：configure: error: xml2-config not found. Please check your libxml2 installation.
- Ubuntu/Debian：装
libxml2-dev、libssl-dev、libcurl4-openssl-dev、libjpeg-dev等 - CentOS/RHEL：装
libxml2-devel、openssl-devel、curl-devel、libjpeg-devel
注意：有些库（如 libzip）新版 PHP 要求 >=1.5.0，但系统源里的版本太旧，就得自己编译安装 libzip 并用 --with-libzip=/usr/local 指定路径。
./configure 成功但 make 报错大量 undefined reference
说明链接阶段失败，通常是库路径没被正确识别，尤其当你把依赖装到了非标准路径（比如 /opt/lib 或 /usr/local）。
关键检查点：
- 确认
pkg-config能查到对应库：pkg-config --modversion libxml-2.0 - 如果库在
/usr/local，确保LD_LIBRARY_PATH和PKG_CONFIG_PATH已设置：export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH" - configure 时显式传参比依赖环境变量更可靠，例如：
--with-openssl=/usr/local/ssl而不是只靠pkg-config
别依赖 make -j 并行编译来提速——出错时堆栈混乱，先用 make -j1 定位第一处真实报错。
configure 参数写错或漏掉关键扩展导致后续扩展无法启用
PHP 编译是“静态决定”的：configure 阶段没声明的扩展，make install 后不会生成对应 .so 文件，运行时 extension=xxx.so 会直接报错“找不到模块”。
新手最常漏的几个：
-
--enable-mbstring：没加的话，mb_*函数全不可用，且很多框架（Laravel、Symfony）启动即崩 -
--with-curl：不指定路径时可能找不到，尤其系统 curl 是用 OpenSSL 编译的，而你装的 OpenSSL 在非标路径 -
--enable-opcache：不加则opcache.so根本不生成，php.ini 里开也白搭
建议第一次编译先用最小可用集：--enable-cli --enable-mbstring --with-curl --with-openssl --enable-opcache，跑通再逐步加 --with-pdo-mysql 等。
路径设置最容易被忽略的是：configure 里写的路径必须精确到“能访问 include/ 和 lib/ 子目录”的父级，比如 --with-openssl=/usr/local/ssl，而不是 /usr/local/ssl/lib。
