PHP 分类列表仅显示一个商品的解决方案

本文详解 php 中因逻辑结构错误导致分类页面仅显示一条“soon=2”商品的问题，通过修正 `while` 循环与条件判断的嵌套关系，确保所有符合条件的商品正确渲染。

在开发基于 PHP 的商品分类展示功能时，一个常见却隐蔽的错误是：将关键的条件判断（如 if($row["soon"] == "2")）错误地置于 while 循环外部，或因重复调用 fetch_assoc() 导致数据游标提前移动。这正是本案例中“选择任意分类后仅显示一个商品”的根本原因——原始代码中存在冗余的 $row = $result->fetch_assoc() 调用，且 if($row["soon"] == "2") 的逻辑未被完整包裹在循环体内，导致后续迭代被跳过或中断。

✅ 正确结构：所有渲染逻辑必须严格位于 while 内部

核心修复原则是：每一次 fetch_assoc() 获取的 $row，都应在单次循环迭代中完成全部业务判断与 HTML 输出。以下是重构后的清晰、安全写法：

  query($sql);

  // 检查查询结果
  if ($result && $result->num_rows > 0) {
      while ($row = $result->fetch_assoc()) {
          // 【关键】所有分支逻辑均在此循环内处理
          if ($row['soon'] == "2") {
              // ✅ 正常上架商品：完整渲染卡片
              echo '
';
              echo '  
' . htmlspecialchars($row["productName"]) . '
';
              echo '  
';
              echo '    @@##@@';
              echo '    
' . htmlspecialchars($row["productPrice"]) . ' SEK
';
              echo '    ';
              echo '      Go to product ';
              echo '    ';
              echo '  
';
              echo '
';
          }
          // 注意：此处不使用 else-if，避免逻辑耦合；"soon=1" 商品可单独处理或忽略
          elseif ($row['soon'] == "1" && (isset($_POST['tech']) || isset($_POST['candle']))) {
              // 可选：为即将上线商品添加占位提示（建议统一前端控制，非后端输出）
              // echo "
{$row['productName']} — Coming Soon

							

								
								

									良精商城网店购物系统
									
良精商城网店购物系统是一套能够适合不同类型商品、超强灵活的多功能在线商店系统，三级分销 PC+移动端+微网站，为您提供了一个完整的在线开店解决方案。良精网店购物系统除了拥有一般网上商店系统所具有的所有功能，还拥有着其它网店系统没有的许多超强功能。多种独创的技术使得系统能满足各行业广大用户的各种各样的需求，是一个经过完善设计并适用于各种服务器环境的高效、全新、快速和优秀的网上购物软件解决方案。
								
								下载 
							
						
立即学习“PHP免费学习笔记（深入）”；
";
          }
      }
  } else {
      // 无结果时的友好提示
      echo '
Sorry!
';
      echo '
There is not any product in this category yet!
';
  }

  $conn->close();
  ?>

⚠️ 关键注意事项

• 永远不要在 while 外部或循环中重复调用 fetch_assoc()：它会推进结果集指针，造成数据丢失；
• 使用 htmlspecialchars() 和 (int) 强制类型转换：防止 XSS 攻击与 SQL 注入风险（尽管本例未拼接 SQL，但输出用户数据必须转义）；
• 避免混合 PHP 逻辑与 HTML 输出：推荐统一使用 echo 拼接（如上），提升可读性与调试效率；
• 启用错误报告：在开发环境务必开启 error_reporting(E_ALL); ini_set('display_errors', 1);，快速暴露未定义变量、SQL 错误等；
• 数据库字段设计建议：soon 字段宜使用 TINYINT(1) 或 ENUM('0','1','2') 替代字符串，提高查询性能与语义清晰度。

通过以上重构，每个分类页将稳定、完整地渲染所有 soon = "2" 的商品，彻底解决“只显示一个”的问题，并为后续功能扩展（如分页、搜索、状态过滤）打下健壮基础。