PHP Mysqli Query返回值类型解析与代码示例

核心结论：返回值类型取决于 SQL 类型与执行状态

在使用 mysqli_query() 或 $link->query() 执行 SQL 时，返回值主要分为三类情况：

1. 成功且包含结果集（如 SELECT）：返回 mysqli_result 对象。
2. 成功但不包含结果集（如 INSERT, UPDATE, DELETE）：返回布尔值 true。
3. 执行失败（无论语句类型）：返回布尔值 false。

代码实例验证

以下代码演示了上述四种典型场景的返回值差异。请确保您的环境已配置好 MySQL 服务及正确的账户权限。

<?php
// 建立连接
$link = new mysqli('localhost', 'root','123','test');

// 场景1：SELECT 查询 - 成功且有结果集
$sql = 'select uName from userInfo';
$a = $link->query($sql);
echo '有结果集
';
var_dump($a);

// 场景2：INSERT 插入 - 成功但无结果集
$sql = "insert into userInfo values('hh','22')";
$b = $link->query($sql);
echo '
没有结果集
';
var_dump($b);

// 场景3：SELECT 查询 - 语法错误或字段不存在导致失败
$sql = 'select uN from userInfo'; // 假设列名 uN 不存在
$c = $link->query($sql);
echo '有结果集错误
';
var_dump($c);

// 场景4：INSERT 插入 - 数据约束或语法错误导致失败
$sql = "insert into userInfo values('','hh','22')"; // 列数不匹配或约束冲突
$d = $link->query($sql);
echo '
没有结果集错误
';
var_dump($d);
?>

运行结果分析

执行上述代码后，浏览器输出将呈现以下特征，这印证了之前的分类逻辑：

有结果集
object(mysqli_result)#2 (0) {
}

没有结果集
bool(true)

有结果集错误
bool(false)

没有结果集错误
bool(false)

关键点解读

• 对象 vs 布尔值：只有当 SQL 明确期望返回数据行（通常是 SELECT）且执行无误时，才会得到对象。其他成功操作仅返回 true。
• 失败的统一性：一旦 SQL 执行出错（如字段名错误、主键冲突、语法错误），无论原本是 SELECT 还是 INSERT，返回值一律为 false。
• 调试建议：由于失败时都返回 false，在实际开发中，建议在判断返回值之前或之后，配合 $link->error 获取具体的错误信息，以便定位问题。

最佳实践建议

为了避免因类型混淆导致的逻辑错误，建议采用如下模式处理查询：

1. 检查资源有效性：对于 SELECT 查询，首先判断是否为 false（失败），然后再尝试遍历结果集。
2. 使用 try-catch 或前置检查：现代 PHP 项目中，也可考虑结合 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT); 开启异常模式，从而直接抛出异常代替返回 false，使代码更清晰。