网站搜索栏查询异常：两次SQL查询结果一致的排查与解决

问题场景 #

要实现网站搜索栏功能：

• 搜索栏为空/未设置时，展示所有记录（不带WHERE子句）
• 搜索栏填写内容后，展示经WHERE子句过滤的匹配记录

但测试时发现两个查询变量返回的SQL语句完全一致，功能无法正常生效。

原代码 #

PHP代码

<?php
require_once 'somefile.php';
$user = new user();
if(isset($_POST['btnSearch'])){
  $searchTerm = $_POST['txtSearch'];
  $items2 = DB::getInstance()->get('items', array('Name', 'LIKE', '%['.$searchTerm.']%'));
  // 预期SQL: "SELECT * FROM items WHERE Name LIKE '%[my_search_term]%'"
  // 实际SQL: "SELECT * FROM items WHERE Id > 0"; --> 不符合预期
  $items = DB::getInstance()->get('items', array('id', '>', '0'));
  // 实际SQL: "SELECT * FROM items WHERE id > 0" --> 符合预期
}
?>

HTML代码

<form method="POST" action="#" class="ftco-section">
<div class="row">
      <input type="text" name="txtSearch" id="txtSearch" placeholder="Search..." />
      <button type="submit" name="btnSearch"><img name="imgSearch" id="imgSearch" 
src="images/search.png" /></button>
    </div>
</form>
...<!-- 展示结果的表格 -->

问题原因 #

原代码存在两个核心问题：

1. 查询执行顺序错误：原本$items = DB::getInstance()->get('items', array('id', '>', '0'));位于$items2查询之前，导致$items2的结果覆盖了$items；调整顺序后又变成$items覆盖$items2，无论搜索状态如何，最终页面只会显示$items对应的所有记录。
2. 逻辑冗余：同时执行两个查询完全没必要，应该根据搜索条件的存在与否，选择执行对应的查询语句。

修复方案 #

调整代码逻辑，根据搜索状态选择对应的查询，而非同时执行两个查询：

<?php
require_once 'somefile.php';
$user = new user();
$items = null;

// 判断是否提交了搜索，且搜索词不为空
if(isset($_POST['btnSearch']) && !empty(trim($_POST['txtSearch']))){
  $searchTerm = trim($_POST['txtSearch']);
  // 执行带搜索条件的查询
  $items = DB::getInstance()->get('items', array('Name', 'LIKE', "%{$searchTerm}%"));
} else {
  // 搜索栏为空或未提交，展示所有记录（若DB类默认不传条件则查询所有）
  $items = DB::getInstance()->get('items');
  // 若DB类必须传条件，可替换为: array('id', '>', '0')
}
?>

补充说明 #

• 对$searchTerm做trim()处理，避免用户输入空格导致的无效搜索
• 原代码中LIKE条件里的[]是多余的，直接用%{$searchTerm}%即可匹配包含搜索词的记录

内容的提问来源于stack exchange，提问作者user3906610