本文详解 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 ' ';
echo ' ';
echo ' ';
echo '';
}
// 注意：此处不使用 else-if，避免逻辑耦合；"soon=1" 商品可单独处理或忽略
elseif ($row['soon'] == "1" && (isset($_POST['tech']) || isset($_POST['candle']))) {
// 可选：为即将上线商品添加占位提示（建议统一前端控制，非后端输出）
// echo "{$row['productName']} — Coming Soon
";
}
}
} 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" 的商品
，彻底解决“只显示一个”的问题，并为后续功能扩展（如分页、搜索、状态过滤）打下健壮基础。
