PHP使用mysqli接口调用MariaDB存储过程的最佳实践是什么？

这个packets out of order报错的核心原因是你错误地在预编译语句对象（$stmt）上调用next_result()，而PHP mysqli中存储过程返回的多结果集是绑定在数据库连接对象（$connection）上的，而非语句对象上。
存储过程执行完成后，除了你查询得到的业务结果集外，还会额外返回一个存储过程执行状态的空结果集。第一次调用存储过程后你没有正确清空连接上残留的所有结果集，导致连接状态异常，第二次调用prepare()时就会抛出报文顺序错误。C API的封装逻辑和PHP mysqli不同，所以相同逻辑的C++代码可以正常运行。

只需要调整结果集清空的逻辑，改为对连接对象调用next_result()消费所有残留结果即可，修正后的get_person函数代码如下：

function get_person($connection, $first_name)
{
   $query = "CALL Get_By_First_Name(?)";
   if (($stmt = $connection->prepare($query)))
   {
      $stmt->bind_param('s', $first_name);
      if ($stmt->execute())
      {
         $stmt->store_result();
         $stmt->bind_result($id, $fname, $lname, $pets);

         while($stmt->fetch())
            printf("%3d %20s %20s %2d.\n", $id, $fname, $lname, $pets);

         $stmt->free_result();
         $stmt->close(); // 先关闭语句对象
         // 清空连接上所有残留的结果集
         while ($connection->more_results() && $connection->next_result()) {
             $dummyResult = $connection->store_result();
             if ($dummyResult instanceof mysqli_result) {
                 $dummyResult->free();
             }
         }
      } else {
          // 可选：增加执行错误处理
          $stmt->close();
      }
   }
}

• 如果你的存储过程只会返回一个业务结果集，也可以在第一次调用存储过程完成后直接执行$connection->next_result()一次，不需要循环，就能把状态结果集消费掉
• 对于不需要复用参数的简单存储过程调用，也可以直接用$connection->query()方法执行，调用完成后用同样的逻辑清空连接残留结果即可
• 极端场景下也可以每次调用存储过程后新建连接，但会增加额外的性能开销，不推荐

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