php下载安装需要哪些依赖库_mysql扩展安装说明【汇总】_技术教程

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 不生效