本教程探讨了在 php/mysqli 应用中显示标签时常见的 n+1 查询性能瓶颈。针对将标签id存储为逗号分隔字符串的场景,文章详细介绍了如何通过使用 `where in` 子句和动态参数绑定,将多次独立查询优化为单次批量查询。此外,还展示了 php 8.1+ 中更简洁的参数绑定方式,旨在提升标签显示效率和系统性能。
低效的标签显示方法及问题分析
在网站开发中,标签系统是常见功能。然而,当标签ID以逗号分隔的字符串形式存储在主数据表中时,如果采用逐个查询的方式来获取每个标签的名称,就会导致严重的性能问题,即所谓的 N+1 查询问题。这意味着每显示一个标签,就需要执行一次独立的数据库查询。当一个项目关联了多个标签时,数据库查询次数会急剧增加,从而降低页面加载速度和服务器资源利用率。
考虑以下原始的实现方式:
<?php// 假设 $conn 是已建立的 MySQLi 连接// 假设 $row["tags"] 的值为 "1,2,3"// 原始代码中的 json_decode(json_encode()) 是不必要的,explode 即可$tags = explode(',', $row["tags"]); foreach($tags as $tag) { $fetchTags = $conn->prepare("SELECt id, name FROM tags WHERe id = ? AND type = 1"); $fetchTags->bind_param("i", $tag); $fetchTags->execute(); $fetchResult = $fetchTags->get_result(); if($fetchResult->num_rows === 0) { print('No rows'); } while($resultrow = $fetchResult->fetch_assoc()) { ?><span class="badge bg-primary me-2"><?php echo htmlspecialchars($resultrow["name"]); ?></span><?php } $fetchTags->close();}?>登录后复制
上述代码中,如果 $row["tags"] 包含例如 "1,2,3,4,5" 五个标签ID,foreach 循环将执行五次数据库查询。这对于少量标签尚可接受,但随着标签数量的增加,性能瓶颈会变得非常明显。
优化方案:使用 WHERe IN 进行批量查询
解决 N+1 查询问题的关键在于将多次独立的查询合并为一次批量查询。MySQL 的 WHERe IN 子句正是为此而生,它允许我们在一个查询中匹配多个值。结合 mysqli 预处理语句的动态参数绑定,我们可以高效地实现这一目标。
立即学习“PHP免费学习笔记(深入)”;
以下是优化后的实现步骤:

告别低效手工,迎接AI标书新时代!3分钟智能生成,行业唯一具备查重功能,自动避雷废标项


<?php// 假设 $conn 是已建立的 MySQLi 连接// 假设 $row["tags"] 仍然是 "1,2,3,4,5"// 1. 将标签ID字符串转换为数组$tags = explode(',', $row["tags"]);// 检查标签数组是否为空,避免空 IN 子句导致的SQL错误或无意义查询if (empty($tags)) { // 没有标签需要显示,直接返回或进行其他处理 // print('No tags to display'); return; }// 2. 生成动态占位符,例如:?,?,?,?,?$placeholders = implode(',', array_fill(0, count($tags), '?'));// 3. 准备 SQL 查询// 注意:为了安全性,这里的 type = 1 应该是一个固定的条件,或者也通过参数绑定$fetchTags = $conn->prepare('SELECt id, name FROM tags WHERe id IN ('.$placeholders.') AND type = 1 ORDER BY id');// 4. 动态绑定参数// 根据标签数量生成类型字符串,例如 'iiiii' (假设标签ID是整数类型)$types = str_repeat('i', count($tags)); // 使用 splat 运算符 (...) 将 $tags 数组的元素作为独立的参数传递给 bind_param$fetchTags->bind_param($types, ...$tags);// 5. 执行查询$fetchTags->execute();$fetchResult = $fetchTags->get_result();// 处理结果if($fetchResult->num_rows === 0) { print('No rows'); // 或者显示“无相关标签”} else { foreach($fetchResult as $resultRow) { // 确保输出到HTML的内容经过转义,防止XSS攻击 ?><span class="badge bg-primary me-2"><?php echo htmlspecialchars($resultRow["name"]); ?></span><?php }}$fetchTags->close();?>登录后复制
通过上述优化,无论有多少个标签,都只需要执行一次数据库查询,极大地提升了效率。
PHP 8.1+ 简化参数绑定
从 PHP 8.1 版本开始,mysqli_stmt::execute() 方法得到了增强,可以直接接受一个数组作为参数。这进一步简化了动态参数绑定的过程,无需手动生成类型字符串或使用 bind_param()。
<?php// 假设 $conn 是已建立的 MySQLi 连接// 假设 $row["tags"] 仍然是 "1,2,3,4,5"$tags = explode(',', $row["tags"]);if (empty($tags)) { return;}$placeholders = implode(',', array_fill(0, count($tags), '?'));$fetchTags = $conn->prepare('SELECt id, name FROM tags WHERe id IN ('.$placeholders.') AND type = 1 ORDER BY id');// PHP 8.1+ 的简化绑定方式:直接将标签ID数组传递给 execute()$fetchTags->execute($tags); $fetchResult = $fetchTags->get_result();if($fetchResult->num_rows === 0) { print('No rows');} else { foreach($fetchResult as $resultRow) { ?><span class="badge bg-primary me-2"><?php echo htmlspecialchars($resultRow["name"]); ?></span><?php }}$fetchTags->close();?>登录后复制
这种简洁的语法使得代码更加清晰和易于维护。
注意事项与最佳实践
数据库设计: 尽管本教程解决了当前存储方式下的效率问题,但从长远来看,将标签ID以逗号分隔字符串的形式存储在主表中并不是最佳实践。更推荐的数据库设计是使用多对多关系,即通过一个中间关联表(如 item_tags),将主项目与标签进行关联。这样可以更灵活地管理标签,并避免字符串操作的开销。items 表: id, name, ...tags 表: id, name, typeitem_tags 表: item_id, tag_id (复合主键)安全性: 始终使用预处理语句来防止 SQL 注入攻击。本教程中的所有示例都遵循了这一原则。错误处理: 在实际应用中,应该加入更完善的错误处理机制,例如检查 prepare()、execute() 和 get_result() 的返回值,并在出现错误时记录日志或向用户显示友好的错误信息。数据类型: bind_param() 的类型字符串 (str_repeat('i', count($tags))) 应该与数据库中字段的实际数据类型匹配。如果标签ID可能是字符串,则应使用 's'。输出转义: 在将数据库中获取的数据输出到 HTML 页面时,务必使用 htmlspecialchars() 或 htmlentities() 函数进行转义,以防止跨站脚本攻击 (XSS)。总结
通过将低效的 N+1 查询模式转换为高效的 WHERe IN 批量查询,我们显著提升了 PHP/MySQLi 应用中标签显示的性能。无论是使用传统的 bind_param() 结合动态类型字符串和 splat 运算符,还是利用 PHP 8.1+ 提供的 execute() 数组参数简化绑定,都能有效解决性能瓶颈。同时,开发者应持续关注数据库的最佳设计实践,并确保代码的安全性、健壮性与可维护性。
以上就是优化 PHP/MySQLi 标签显示:告别 N+1 查询,实现高效批量获取的详细内容,更多请关注php中文网其它相关文章!