PHP 8.2 移除的功能 —— MySQLi 不再支持使用 libmysqli 编译

历史上 PHP 支持两个库来连接 MySQL 数据库。对于 mysqli 扩展和 pdo_mysql 扩展，这些库为连接、查询、检索和处理检索数据提供了底层的功能支持。

mysqlnd (MySQL Native Driver)：PHP 项目的一部分，提供了现代性功能，诸如返回原生PHP 数据类型(比如 integer)，像 PHP 内核那样进行内存管理，功能非常强大。
libmysql：一个 MySQL 提供的外部库，不提供 mysqlnd 的所有特性，并且有外部库的不足之处：诸如不能合理跟踪或控制内存使用，并且存在库版本不匹配额潜在风险。再者，libmysql 在 Windows 系统上不可用。
自 PHP 5.4 起，mysqlnd 成为了默认库。不过，可以通过编译时的配置项使用 libmysql 来编译 mysqli 和 pdo_mysql 扩展。
从 PHP 8.2 起，不再支持使用 libmysql 编译 mysqli 扩展。

请注意，仍然可以使用 libmysql 编译 pdo_mysql 扩展，不过将来 pdo_mysql 扩展可能会放弃对 libmysql 的支持。

尝试使用 --with-mysqli=FILE 选项编译 mysqli，会导致编译配置时的配置错误：

./configure --with-mysqli=FOO

Linking mysqli against external library is no longer supported

不太可能会有很多的 PHP 编译会因这一更新而受影响。因为 mysqlnd 功能更加强大、更加安全的特性，而且作为 PHP 默认 MySQL 库使用很长时间了。

libmysql 支持的，而 mysqlnd 没有提供的主要特性是：

LDAP/SASL 授权支持可能会被添加到 mysqlnd ，这一功能有一个 PR 存在。

已经决定，libmysql-style 自动重连的功能不会添加到 mysqlnd 中。一般而言，数据库连接丢失会导致在应用尝试重新连接的地方抛出异常，或者关闭应用。

之前依赖于自动重连功能的应用，现在需要处理可能的异常，并尝试手动重连。

mysqli::ping() 及 mysqli_ping()

如果检测到 mysqli.reconnect INI 配置，mysqli::ping() and mysqli_ping() 函数将支持自动重连。

随着 libmysql 支持的移除，这些函数将不再支持自动重连特性。

libmysql 指定的 mysqli.reconnect INI 配置指令检测也将在 PHP 8.2 移除。这个值用于ping 功能不再支持自动连接。

设置这一指令不会导致任何错误或者警告，也不会再有任何效果。

MySQLi 扩展提供了 mysqli_driver 类用来获取驱动信息(比如客户端版本)，也用来配置驱动的特定特性：比如，由现将移除的 libmysql 库提供的重连特性。

mysqli_driver::$reconnect 属性类似于 mysqli.reconnect INI 指令。

在 PHP 8.2 及以后，mysqli_driver::$reconnect 属性将被移除。尝试读取会导致未定义属性的警告。尝试设置对驱动行为并无影响，会带来动态属性弃用的警告通知。

libmysql 的移除不太可能影响通用的 PHP 编译版本。

在 cPanel 中，mysqli 扩展使用 mysqlnd 编译，要求在 cPanel 控制面板中启用 mysqlnd 和 nd_mysql 插件。

最可能不兼容的是，该更新导致缺乏自动重连功能。libmysql 自动重连特性从一开始就有点不可预测，理想的升级路径是，捕获 mysqli 异常，并手动重新建立连接，或者优雅地退出程序。