本文详解 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 ' @@##@@';
echo ' <p>' . htmlspecialchars($row["productPrice"]) . ' SEK</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/code/11194" title="良精商城网店购物系统"><img
src="https://img.php.cn/upload/webcode/000/000/013/176527260248495.png" alt="良精商城网店购物系统" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/code/11194" title="良精商城网店购物系统">良精商城网店购物系统</a>
<p>良精商城网店购物系统是一套能够适合不同类型商品、超强灵活的多功能在线商店系统，三级分销 PC+移动端+微网站，为您提供了一个完整的在线开店解决方案。良精网店购物系统除了拥有一般网上商店系统所具有的所有功能，还拥有着其它网店系统没有的许多超强功能。多种独创的技术使得系统能满足各行业广大用户的各种各样的需求，是一个经过完善设计并适用于各种服务器环境的高效、全新、快速和优秀的网上购物软件解决方案。</p>
</div>
<a href="/xiazai/code/11194" title="良精商城网店购物系统" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>';
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><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</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" 的商品，彻底解决“只显示一个”的问题，并为后续功能扩展（如分页、搜索、状态过滤）打下健壮基础。
