执行PHP mysqli multi_query报Commands out of sync错误如何解决？

Commands out of sync; you can't run this command now 错误本质是MySQL连接中还有未处理完成的结果集，没有完全清空之前的查询结果就尝试执行新的查询，触发了MySQL的客户端保护机制。你现有代码的问题出在multi_query结果遍历的逻辑存在遗漏。

• 首先确认setup.sql里的语句执行完成后，所有返回的结果集是否都被正确读取、释放
• 检查现有代码的循环逻辑：use_result()返回的结果集没有手动释放，且循环终止条件错误，当next_result()返回false时直接终止，此时最后一个结果集还未处理
• 排查后续是否立刻执行了其他数据库查询，multi_query的残留结果集没有清空就执行新查询也会触发报错

修改multi_query的结果遍历逻辑，确保每一个结果集都被正确释放，修正后的完整代码如下：

$sql = file_get_contents("setup.sql");
$sql = str_replace(["WEBSITE_URL", "LICENSE_KEY", "WEBSITE_TITLE"], [rtrim($website->website_url, "/"), $website->license, empty($website->w_title) ? "'Script By JUICYCODES.COM'" : "'" . $website->w_title . "'"], $sql);
if ($db->multi_query($sql)) {
    do {
        // 读取当前结果集
        if ($result = $db->use_result()) {
            // 手动释放结果集
            $result->free();
        }
        // 确认还有更多结果集再调用next_result，避免无结果时调用报错
    } while ($db->more_results() && $db->next_result());
}
// 可选补充：如果后续马上要执行其他单查询，可加一行重置连接状态
$db->store_result();

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