PHP编译安装的硬性依赖为libxml2、openssl、curl、zlib、sqlite3，缺一则configure报错；MySQL扩展需同时启用--enable-mysqlnd、--with-mysqli=mysqlnd和--with-pdo-mysql=mysqlnd。
PHP 安装时哪些系统库是硬性依赖
Linux 下编译安装 PHP 时，libxml2、openssl、curl、zlib、sqlite3 是默认启用且几乎无法关闭的核心依赖。缺任何一个，configure 阶段就会报错或导致后续扩展（如 pdo_sqlite、openssl 函数）不可用。
常见错误现象：configure: error: xml2-config not found 或 ERROR: Cannot find OpenSSL's ，本质就是对应开发包没装。
- Ubuntu/Debian：运行
sudo apt install libxml2-dev libssl-dev libcurl4-openssl-dev zlib1g-dev libsqlite3-dev - CentOS/RHEL：运行
sudo yum install libxml2-devel openssl-devel curl-devel zlib-devel sqlite-devel（RHEL 8+ 换成dnf） - 注意必须装
-dev或-devel后缀的包，仅装运行时库（如libssl1.1）不够
mysqlnd 和 libmysqlclient 的区别与选型
PHP 7.4+ 默认使用 mysqlnd（MySQL Native Driver），它纯 PHP 实现、无需外部客户端库、支持 mysqli 和 PDO_MySQL，且自带 mysqlnd_ms、mysqlnd_qc 等高级特性。而旧式 libmysqlclient 依赖 MySQL 官方 C 客户端，已逐步弃用。
如果你在 configure 里加了 --with-mysqli=mysqlnd 或 --with-pdo-mysql=mysqlnd，就明确启用了 mysqlnd；若写成 --with-mysqli=/usr 或类似路径，则强制走 libmysqlclient，容易因版本不兼容导致 mysqli_connect(): (HY000/2054): The server requested authentication method unknown to the client。
立即学习“PHP免费学习笔记（深入）”；
- 推荐始终用
--with-mysqli=mysqlnd和--with-pdo-mysql=mysqlnd - 不需要额外安装 MySQL 服务端或客户端二进制，但需确保
pkg-config可查到 mysqlnd（通常默认满足） - 若必须用 libmysqlclient（如对接老 Oracle MySQL 5.6），请确认系统中
mysql_config命令存在且版本 ≥ 5.5
PHP 编译时开启 MySQL 扩展的实际参数组合
单独加 --enable-mysqlnd 不足以让 mysqli 或 PDO_MySQL 可用，必须配合对应扩展开关。常见遗漏是只开 mysqlnd 却没开上层接口。
以下是最小可用组合（以 PHP 8.2 为例）：
./configure \ --enable-mysqlnd \ --with-mysqli=mysqlnd \ --with-pdo-mysql=mysqlnd \ --with-openssl \ --with-zlib
关键点：
-
--enable-mysqlnd是基础驱动，必须最先启用 -
--with-mysqli和--with-pdo-mysql必须显式设为mysqlnd，不能留空或写yes - 如果还用到
mysql_xdevapi（X Protocol），需额外加--enable-mysqlnd-experimental-http（PHP 8.2+） - configure 后检查输出里是否含
mysqlnd => enabled和mysqli support => enabled
安装后 extension_dir 和 .so 文件缺失的排查路径
make install 完成后，mysqli 和 PDO_mysql 的模块文件（如 mysqli.so、pdo_mysql.so）默认生成在 modules/ 目录下，但不会自动复制到 extension_dir 指向的位置，也不会写入 php.ini。
典型问题：php -m | grep mysqli 无输出，或 phpinfo() 里看不到 MySQL 相关模块。
- 先确认模块是否存在：
ls $(php-config --extension-dir)/mysqli.so，若不存在，说明 configure 阶段未启用或 make 失败 - 手动启用：在
php.ini中添加extension=mysqli和extension=pdo_mysql（PHP 7.0+ 支持不带.so后缀） - 注意顺序：
mysqli应在pdo_mysql之前加载（因后者依赖前者） - 若用 php-fpm，改完 ini 后必须重启
php-fpm进程，仅 reload 不生效
mysqlnd 本身是内建驱动，不生成独立 .so 文件，所以看不到 mysqlnd.so 是正常的——它被静态链接进 PHP 主二进制里了。
