PHP分类只显示一个商品的解决方法

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《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 输出。以下是重构后的清晰、安全写法：

<div class="card-deck col-lg-12 col-md-12 col-sm-12 justify-content-center text-center">
  <?php
  // 构建动态 SQL 查询
  if (isset($_POST['candle'])) {
      $sql = "SELECT * FROM products WHERE category = 'candle'";
  } elseif (isset($_POST['cloth'])) {
      $sql = "SELECT * FROM products WHERE category = 'cloth'";
  } elseif (isset($_POST['tech'])) {
      $sql = "SELECT * FROM products WHERE category = 'tech'";
  } else {
      $sql = "SELECT * FROM products";
  }

  $result = $conn->query($sql);

  // 检查查询结果
  if ($result && $result->num_rows > 0) {
      while ($row = $result->fetch_assoc()) {
          // 【关键】所有分支逻辑均在此循环内处理
          if ($row['soon'] == "2") {
              // ✅ 正常上架商品：完整渲染卡片
              echo '<div class="product_card col-xl-3 col-lg-4 col-md-5 col-sm-12 box-shadow">';
              echo '  <div class="card-header"><h3 class="product_name my-0 font-weight-normal">' . htmlspecialchars($row["productName"]) . '</h3></div>';
              echo '  <div class="card-body">';
              echo '    <img class="pic" src="productsImages\\' . $row["productID"] . '.jpeg" height="150" width="120" alt="' . htmlspecialchars($row["productName"]) . '">';
              echo '    <p>' . htmlspecialchars($row["productPrice"]) . ' SEK</p>';
              echo '    <a class="toProduct" href="products_index.php?id=' . (int)$row['productID'] . '">';
              echo '      <button class="btn_to_product btn btn-lg btn-outline-dark">Go to product <i class="fas fa-arrow-alt-circle-right"></i></button>';
              echo '    </a>';
              echo '  </div>';
              echo '</div>';
          }
          // 注意：此处不使用 else-if，避免逻辑耦合；"soon=1" 商品可单独处理或忽略
          elseif ($row['soon'] == "1" && (isset($_POST['tech']) || isset($_POST['candle']))) {
              // 可选：为即将上线商品添加占位提示（建议统一前端控制，非后端输出）
              // echo "<p><em>{$row['productName']} — Coming Soon</em></p>";
          }
      }
  } else {
      // 无结果时的友好提示
      echo '<h2 class="col-12">Sorry!</h2>';
      echo '<h3 class="col-12">There is not any product in this category yet!</h3>';
  }

  $conn->close();
  ?>
</div>

⚠️ 关键注意事项

• 永远不要在 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" 的商品，彻底解决“只显示一个”的问题，并为后续功能扩展（如分页、搜索、状态过滤）打下健壮基础。

今天关于《PHP分类只显示一个商品的解决方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！