PHP PDO多行数据只显示一行？正确循环与HTML集成方法

本教程旨在解决使用PHP PDO从数据库获取多行数据时，在HTML页面中却只显示一行的常见问题。文章深入剖析了问题根源，即循环逻辑与HTML结构分离导致的变量覆盖，并提供了将PHP循环嵌入HTML结构内部的正确实现方式，确保所有查询结果都能被动态渲染，有效生成如下拉菜单等动态列表。

1. 问题背景与常见误区

在使用PHP PDO从数据库查询多行数据并将其动态渲染到HTML页面（例如生成下拉菜单、列表项等）时，开发者常常会遇到一个困扰：尽管数据库中存在多条记录，但最终在页面上却只显示了第一条或最后一条数据。这通常不是PDO本身的问题，而是PHP循环逻辑与HTML结构集成方式不当所致。

常见的错误模式是：

1. 在PHP代码块中，使用 foreach 或 while 循环遍历PDO查询结果集。
2. 在循环内部，将每一行的数据赋值给一个或几个变量。
3. 循环结束后，在HTML代码中尝试使用这些变量来生成动态内容。

这种做法的根本问题在于，当循环结束后，用于存储数据的变量（如 $categ）将只保留循环中最后一次迭代的值。因此，当你在循环外部引用这些变量时，无论数据有多少行，最终都只会显示最后一行的数据。

考虑以下示例数据库表结构 mall_category：

以及一段错误的PHP/HTML代码：

prepare("SELECT `id`, `cat_slug` FROM mall_category WHERE name = :acces");
    $stmt->execute(['acces' => $acces]);
    $result = $stmt->fetchAll(PDO::FETCH_ASSOC);

    // 错误的循环方式：在这里遍历并赋值给单个变量
    foreach ($result as $row) {
        $categ = $row['cat_slug']; // $categ 会被每一次迭代覆盖，最终只保留最后一行数据
    }
} catch(PDOException $e){
    echo "数据库查询失败: " . $e->getMessage();
}
// $conn->close(); // 如果是自定义的 $pdo 对象，可能需要关闭连接
// 如果是直接的PDO实例，在脚本结束时会自动关闭
?>


    Electronics
    

      
      
'>
    

在上述错误示例中，foreach 循环在PHP代码块中执行完毕后，$categ 变量将只包含 "Miscellaneous"（即 'Electronics' 类别中的最后一条记录）。因此，HTML部分无论有多少数据，最终都只会显示一个链接，且内容为 "Miscellaneous"。

2. PDO数据获取基础

在解决问题之前，我们先回顾一下使用PDO获取多行数据的标准流程：

1. 建立数据库连接： 创建 PDO 类的实例。
2. 准备SQL语句： 使用 prepare() 方法预处理SQL查询，这有助于防止SQL注入。
3. 绑定参数： 使用 execute() 方法执行预处理语句，并通过数组传递参数，将占位符替换为实际值。
4. 获取结果集： 使用 fetchAll() 方法获取所有匹配的行。PDO::FETCH_ASSOC 参数指示返回一个索引为列名的关联数组。

setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // 准备SQL查询
    $stmt = $conn->prepare("SELECT `id`, `cat_slug` FROM mall_category WHERE name = :acces");
    // 执行查询并绑定参数
    $stmt->execute(['acces' => $acces]);
    // 获取所有结果行，以关联数组形式
    $result = $stmt->fetchAll(PDO::FETCH_ASSOC);

} catch (PDOException $e) {
    // 捕获并处理数据库连接或查询错误
    echo "数据库连接或查询失败: " . $e->getMessage();
    // 在错误发生时，确保 $result 仍然是一个空数组，避免后续代码出错
    $result = [];
} finally {
    // 关闭数据库连接（将PDO对象设置为null）
    $conn = null;
}
?>

至此，$result 变量中已经包含了所有符合条件的数据行，它是一个包含多个关联数组的数组。

3. 正确的PHP与HTML集成方式

要正确地将多行数据渲染到HTML页面，关键在于将PHP的循环逻辑嵌入到需要重复生成的HTML元素内部。这样，在每一次循环迭代中，都会生成一个新的HTML元素，并使用当前迭代的数据填充它。

以下是解决上述问题的正确代码实现：

 1, 'cat_slug' => 'Cellphones and Accessories'],
//     ['id' => 2, 'cat_slug' => 'Computers and Accessories'],
//     ['id' => 3, 'cat_slug' => 'House Appliances'],
//     ['id' => 4, 'cat_slug' => 'Miscellaneous']
// ];
?>


    Electronics
    

     元素，并使用当前 $row 的数据
            ?>
            
'>
            
        
无可用分类
        
    

代码解析：

1. PHP数据获取与HTML分离： 在HTML渲染之前，先完成所有PHP数据获取逻辑，将结果存储在 $result 数组中。
2. 嵌入循环： foreach ($result as $row) 循环被放置在
   标签内部，紧邻
   • 标签之前。
   • 动态生成
   • ： 在每次循环迭代中， 标签会暂时中断PHP模式，允许我们输出一个
   • 标签。
   • 使用当前行数据： 在
   • 标签内部，我们直接使用当前迭代的 $row 变量来访问 cat_slug 数据 ($row['cat_slug'])，而不是一个在循环外定义的单一变量。
   • htmlspecialchars()： 为了安全起见，所有从数据库获取并显示在HTML中的数据都应该通过 htmlspecialchars() 函数进行处理，以防止跨站脚本攻击 (XSS)。

通过这种方式，每次循环都会生成一个独立的