PHP源码开启扩展：手动编译添加MySQLi模块

本文深入解析了PHP源码编译中手动添加MySQLi等核心扩展的关键原理与实操要点，明确指出这类扩展不支持动态加载，必须在configure阶段通过正确参数（如--with-mysqli）启用构建逻辑，否则即使放置.so文件也完全无效；文章系统梳理了重编译前必须清理的缓存与中间文件、各高频扩展（gd/openssl/curl）的易错参数写法、依赖开发包的安装前提，并提供了多维度验证方法（php -i、常量检测、ldd检查），还特别提醒PHP 8.2+与旧版MySQL兼容时需启用mysqlnd驱动，帮助开发者避开从配置、编译到验证全流程中的典型陷阱。

configure 时没加 --with-mysqli，编译完就不能动态加载吗？

不能。PHP 的 mysqli、gd、openssl 这类“核心扩展”（非 zend_extension）在源码编译阶段就决定是否内置。它们不走 extension= 配置文件加载路径，而是直接编译进 php 可执行文件或作为静态模块存在。你如果跳过了 configure 参数，哪怕后续把 mysqli.so 放进 ext/ 目录也无效——因为源码里压根没启用对应模块的构建逻辑。

重新编译前必须清理哪些残留？

很多人重跑 ./configure && make && make install 后发现扩展还是没生效，问题常出在缓存和中间文件上：

• make clean 必须执行（清空 objs/ 和已编译的 .o 文件）
• 删掉 Makefile 和 config.status（否则 ./configure 可能跳过参数校验）
• 确认 php.ini 加载的是新安装路径下的配置（用 php -i | grep "Loaded Configuration File" 检查）
• 别漏掉依赖库：比如 --with-mysqli 需系统已装 mysql-client 头文件（Ubuntu 是 libmysqlclient-dev，CentOS 是 mariadb-devel）

常见扩展的 configure 参数怎么写才不踩坑？

不同扩展对参数格式敏感，写错一个字符就静默失效：

• mysqli：--with-mysqli=/usr/bin/mysql_config（路径必须指向真实的 mysql_config，不是 mysqld）
• gd：--with-gd --with-jpeg-dir=/usr --with-png-dir=/usr --with-freetype-dir=/usr（各图形库路径要和系统实际一致，Ubuntu 22.04 的 freetype 头文件在 /usr/include/freetype2，但参数仍填 /usr）
• openssl：--with-openssl（默认找 /usr，若装在 /opt/openssl 则写 --with-openssl=/opt/openssl）
• curl：--with-curl（需提前装 libcurl4-openssl-dev 或等价包）

注意：所有 --with- 参数都要求对应开发包（-dev 或 -devel）已安装，否则 configure 会提示 not found 但可能继续执行，导致后续编译失败。

验证扩展是否真被编译进去了？

别只信 php -m | grep mysqli ——那是查已启用的模块，而你要确认它是不是静态链接进来的：

• 运行 php -i | grep "mysqli"，看到 mysqli support => enabled 且没有 mysqli.default_socket 报错，才算通过
• 检查 php -r "echo MYSQLI_VERSION;" 是否输出版本号（若报 undefined constant，说明 mysqli 根本没编译进去）
• 用 ldd $(which php) | grep mysql 查看二进制是否链接了 mysql 客户端库（静态编译时可能不显示，但动态链接时必现）

最易忽略的一点：如果你用的是 PHP 8.2+，--with-mysqli 默认绑定 MySQL 8.0 协议，若后端是老版本 MySQL 5.7，得额外加 --enable-mysqlnd 并用 mysqlnd 驱动替代，否则连接时可能卡在握手阶段。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。