本文目录导读：
在PHP项目中处理空的数据库数据（即查询结果为空的情况）是一个很常见的需求，处理得当可以避免各种恼人的错误（如 Trying to get property of non-object、Undefined index 等）,提升用户体验和代码健壮性。
以下是几种常见的处理场景和最佳实践：
核心思路：先判断，后使用
不要假设查询结果一定存在，始终检查结果是否为空,再进行后续操作。
使用 mysqli（面向过程或面向对象）
这是最底层的处理方法，无论是单条查询还是多条查询,都需要检查结果集的行数。
处理单条记录（如：根据ID查询文章）
<?php
$id = $_GET['id'] ?? 0;
$sql = "SELECT * FROM articles WHERE id = ?";
$stmt = $conn->prepare($sql);
$stmt->bind_param("i", $id);
$stmt->execute();
$result = $stmt->get_result();
// 关键步骤：检查是否有数据
if ($result->num_rows > 0) {
$article = $result->fetch_assoc();
// 安全地使用数据
echo "文章标题: " . htmlspecialchars($article['title']);
} else {
// 数据库为空或没有匹配数据时的处理
echo "404 - 文章不存在";
http_response_code(404); // 设置HTTP状态码
}
$stmt->close();
$conn->close();
?>
处理多条记录（如：文章列表）
<?php
$sql = "SELECT * FROM articles ORDER BY created_at DESC";
$result = $conn->query($sql);
if ($result->num_rows > 0) {
// 有数据，循环输出
while ($row = $result->fetch_assoc()) {
echo "<h3>" . htmlspecialchars($row['title']) . "</h3>";
echo "<p>" . substr($row['content'], 0, 200) . "...</p>";
}
} else {
// 数据库为空时的友好提示
echo "<div class='empty-state'>";
echo "<p>😊 当前还没有任何文章，稍后再来看看吧！</p>";
// 可以提供一个引导按钮
echo "<a href='/write' class='btn'>写第一篇文章</a>";
echo "</div>";
}
$result->free();
$conn->close();
?>
使用 PDO（推荐方式）
PDO 提供了更优雅的错误处理机制,推荐用于新项目。
处理单条记录（fetch() 返回 false 表示无数据）
<?php
try {
$stmt = $pdo->prepare("SELECT * FROM articles WHERE id = :id");
$stmt->execute([':id' => $id]);
$article = $stmt->fetch(PDO::FETCH_ASSOC);
if ($article) {
// 有数据，直接使用
echo "标题: " . htmlspecialchars($article['title']);
} else {
// 无数据 - 优雅处理
echo "未找到该文章。";
// 记录日志（可选）
error_log("访问了不存在的文章ID: " . $id);
}
} catch (PDOException $e) {
// 数据库连接或查询出错的处理
echo "系统繁忙，请稍后重试。";
error_log("数据库错误: " . $e->getMessage());
}
?>
处理多条记录（fetchAll() 返回空数组）
<?php
try {
$stmt = $pdo->query("SELECT * FROM products WHERE status = 'active'");
$products = $stmt->fetchAll(PDO::FETCH_ASSOC);
if (count($products) > 0) {
// 有产品数据
foreach ($products as $product) {
echo "<li>" . htmlspecialchars($product['name']) . "</li>";
}
} else {
// 产品列表为空
echo "<div class='empty-cart'>";
echo "<p>暂无上架商品。</p>";
echo "<a href='/shop' class='btn'>浏览所有商品</a>";
echo "</div>";
}
} catch (PDOException $e) {
echo "获取产品列表失败，请刷新页面重试。";
error_log("产品列表查询失败: " . $e->getMessage());
}
?>
使用框架（如 Laravel、ThinkPHP）
现代框架通常都有高度抽象化的数据库操作方法,并且有很好的空数据保护。
Laravel 示例
// 1. 使用 optional() 辅助函数 - 优雅处理 null
$user = User::find($id);
$name = optional($user)->name; // $user 为 null，返回 null，不会报错
// 或者 $name = $user?->name; (PHP 8.0+ 的空安全运算符)
// 2. 使用 firstOrFail() - 找不到就报 404
$article = Article::where('slug', $slug)->firstOrFail(); // 自动返回 404 页面
// 3. 使用 firstOr() / firstOrCreate() - 提供默认值或创建
$category = Category::where('name', $tag)->firstOr(function () {
return new Category(['name' => '未分类']);
});
// 4. 处理集合为空
$articles = Article::where('status', 'published')->get();
if ($articles->isEmpty()) {
// 显示空状态提示
return view('articles.index', ['empty' => true]);
}
- 使用面向对象的方式：优先使用 PDO 或框架的 ORM，而不是
mysqli_*函数。 - 避免使用 错误抑制符：
@$result->fetch()会隐藏真正的问题,应该显式检查。 - 区分“查询结果为空”和“查询执行失败”：
- 结果为空：数据库正常，但数据不存在（如：用户输入了不存在的ID）。
- 执行失败：SQL语句错误、表不存在、数据库连接断开（应抛出异常或记录日志）。
- 提供友好界面：不要直接显示“没有数据”，而应该设计友好的空状态界面，
- “暂无符合条件的记录”
- “购物车是空的，快去逛逛吧！”
- 附带一个行动按钮（如“返回首页”、“创建第一个”）。
- 设置合适的默认值：
- 在
fetchColumn()后使用 或 运算符。 $price = $row['price'] ?? 0;
- 在
一个常见的“预防针”：循环中的假数据
有时为了调试，你可能需要处理 fetchAll() 返回空数组的情况,一个常见的技巧是循环之前判断：
// 坏习惯 - $users 是空数组，foreach 不会执行，但下面的逻辑可能不正确
foreach ($users as $user) {
// ...
}
if (empty($users)) {
echo "没有用户";
}
// 好习惯 - 先判断再循环
if (!empty($users)) {
foreach ($users as $user) {
// ...
}
} else {
echo "没有用户";
}
总结一句话：先检查数据是否存在（if ($result), if (count($data) > 0), $article = fetch(); if ($article)），再使用数据，永远不要假设数据库有值。
