必须预先配置编译环境与依赖库，否则PHP源码编译将失败。首先安装GCC、make、autoconf等工具链并验证版本；接着安装openssl-devel、libcurl4-openssl-dev、zlib1g-dev、libpcre3-dev等核心开发库；根据需要安装libjpeg-dev、mariadb-devel、libsasl2-dev等扩展依赖；通过PKG_CONFIG_PATH、LD_LIBRARY_PATH等环境变量配置库路径；最后运行buildconf、检查configure选项并确保目录权限正确，完成依赖验证与准备。
如果您打算从源码编译安装 PHP，必须预先配置好基础构建环境与必要依赖库，否则 configure 脚本将无法通过检测或编译过程会中止。以下是完成 PHP 源码安装所必需的依赖检查与环境准备步骤：
一、安装基础编译工具链
PHP 源码编译依赖 GNU 编译器集合（GCC）、make 构建工具以及 autoconf 等自动化配置工具。缺少任一组件会导致 configure 命令失败或生成无效的 Makefile。
1、执行 yum groupinstall "Development Tools"（CentOS/RHEL）或 apt-get install build-essential（Ubuntu/Debian）安装核心编译套件。
2、单独安装 autoconf automake libtool m4，确保 autogen.sh 或 configure 生成流程可正常运行。
立即学习“PHP免费学习笔记（深入）”；
3、验证 GCC 版本是否满足要求：运行 gcc --version，确认版本不低于 4.8（PHP 7.4+ 推荐 GCC 5.3+）。
二、安装核心依赖库
PHP 扩展模块（如 OpenSSL、cURL、GD、XML、JSON）在编译时需链接对应开发头文件与静态/动态库。仅安装运行时库（如 openssl）不足以支持编译，必须安装带 -devel 或 -dev 后缀的开发包。
1、安装 OpenSSL 开发包：yum install openssl-devel（CentOS）或 apt-get install libssl-dev（Ubuntu）。
2、安装 cURL 开发支持：yum install curl-devel 或 apt-get install libcurl4-openssl-dev。
3、安装 zlib 支持：yum install zlib-devel 或 apt-get install zlib1g-dev，用于启用 gzip 压缩与 Phar 包支持。
4、安装 PCRE 库：yum install pcre-devel 或 apt-get install libpcre3-dev，保障正则表达式函数（preg_*）可用。
三、安装可选但常用的扩展依赖
若需启用 GD 图像处理、MySQLi/PDO MySQL、LDAP、iconv、bzip2 等功能，须提前安装对应开发包，否则 configure 将自动禁用相关扩展且不报错，易被忽略。
1、GD 扩展依赖：yum install libjpeg-devel libpng-devel freetype-devel 或 apt-get install libjpeg-dev libpng-dev libfreetype6-dev。
2、MySQLi/PDO MySQL 依赖：yum install mysql-devel（旧版）或 yum install mariadb-devel（推荐），Ubuntu 上为 libmysqlclient-dev。
3、LDAP 支持：yum install openldap-devel 或 apt-get install libsasl2-dev。
4、iconv 与 bzip2：yum install libiconv-devel bzip2-devel（部分系统需手动编译 libiconv）；Ubuntu 默认含 libiconv，仅需 apt-get install libbz2-dev。
四、配置系统级环境变量与路径
configure 脚本可能无法自动识别非标准路径下的库或头文件（例如自定义安装的 OpenSSL）。需通过环境变量显式声明搜索路径，避免“not found”错误。
1、设置 export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/usr/lib64/pkgconfig"，确保 pkg-config 可定位已安装库的 .pc 文件。
2、设置 export LD_LIBRARY_PATH="/usr/local/lib:$LD_LIBRARY_PATH"（临时生效），用于运行时链接测试阶段。
3、若 OpenSSL 安装至 /usr/local/ssl，则添加：export OPENSSL_DIR="/usr/local/ssl" 并在 configure 中使用 --with-openssl=$OPENSSL_DIR。
五、验证依赖完整性与权限准备
在执行 ./configure 前，必须确认当前用户对源码目录、目标安装路径及临时构建目录具有完整读写权限，同时确保所有依赖库的头文件实际存在于指定路径中，否则 configure 将静默跳过模块或报错退出。
1、运行 ./buildconf --force 重新生成 configure 脚本（适用于从 Git 克隆的源码）。
2、执行 ./configure --help | grep -E "(openssl|curl|gd|mysql)" 确认关键选项可见，表明依赖探测机制已就绪。
3、创建独立安装目录并授权：mkdir -p /usr/local/php8 && chown $USER:$USER /usr/local/php8。
