如何让mysqli函数返回错误码而非抛出异常（适配PHP8.2）

维护一个早年用PHP开发的网站，多数函数依赖返回错误而非捕获异常（该行为在旧版PHP中完全合规）。原有代码示例如下：

$tbl_nm = "table_name";

$link = @mysqli_connect($HOSTNAME, $USERNAME, $PASSWD);
if($link !== false)
{
    if(@mysqli_select_db($link, $DBNAME))
    {
        $query = "CREATE TABLE `".$tbl_nm."` (".
            $COL_ID." INT AUTO_INCREMENT PRIMARY KEY, ".
            $COL_DATE." DATE, ".
            $COL_TIME." TIME, ".
            $COL_MSG." TINYTEXT".
            ")";
            
        $res = @mysqli_query($link, $query);     //** EXCEPTION RAISED HERE! **
        if($res === false)
        {
            if(mysqli_errno($link) != 1050)    //1050 - if table already exists
            {
                logMySQLErrorReport($link, "Error creating table");
            }
        }

        //....
    }
    else
    {
        logMySQLErrorReport($link, "Error setting db");
    }
}
else
{
    logMySQLErrorReport($link, "Error connecting");
}

共享主机强制升级到PHP8.2后，原本使用@mysqli_query的代码不再返回错误，而是抛出mysqli_sql_exception（错误信息：PHP Fatal error: Uncaught mysqli_sql_exception: Table 'table_name' already exists），导致网站无法加载。由于此类代码量极大，不想花费数周重构为异常处理，询问是否有设置可强制mysqli函数返回错误码而非抛出异常。

有两种无需大规模重构代码的方法，可让mysqli回到旧版的错误返回模式：

1. 全局配置修改（适合可调整PHP配置的场景） #

• 若能修改php.ini文件，添加或修改以下配置：

  mysqli.default_mode = MYSQLI_REPORT_ERROR
  

  此配置会让mysqli函数出错时返回false并触发PHP警告，原有代码中的@符号可正常抑制警告，与旧版PHP行为一致。
• 若无法修改主php.ini，Apache服务器可尝试在.htaccess中添加：

  php_value mysqli.default_mode MYSQLI_REPORT_ERROR
  

2. 代码层面全局设置（无需修改配置文件） #

在网站入口文件（如index.php或公共初始化文件）的最顶部添加以下代码：

<?php
// 切换mysqli错误模式，禁用异常抛出，恢复旧版错误返回逻辑
mysqli_report(MYSQLI_REPORT_ERROR);

如果需要完全依赖@符号抑制错误，可改为：

mysqli_report(MYSQLI_REPORT_OFF);

这行代码会全局生效，所有后续mysqli函数调用都会回到旧版行为，无需逐个修改现有代码。

内容的提问来源于stack exchange，提问作者c00000fd