如何在 UNION 查询中正确绑定多个 MATCH AGAINST 参数

在使用 PDO 执行包含多个 SELECT 子句的 UNION 查询时，若所有子句都需引用同一搜索词，不能重复使用相同命名参数（如 :search），而应为每个子句分配唯一参数名（如 :search1, :search2, :search3），再分别绑定或统一传入 execute()。

在使用 PDO 执行包含多个 SELECT 子句的 UNION 查询时，若所有子句都需引用同一搜索词，不能重复使用相同命名参数（如 `:search`），而应为每个子句分配唯一参数名（如 `:search1`, `:search2`, `:search3`），再分别绑定或统一传入 `execute()`。

当构建跨多张表（如 archiveArticles、marketNewsArticles、businessNewsArticles）的全文检索联合查询时，常见的误区是试图在单条 SQL 中多次复用同一个命名参数（例如 :search）。然而，PDO 默认不支持同一命名参数在一条预处理语句中重复出现（即使启用了 PDO::ATTR_EMULATE_PREPARES = true，行为也不可靠且因驱动而异）。因此，最稳妥、可移植性最强的方案是：为每个 MATCH ... AGAINST 子句显式声明独立的参数占位符。

以下是推荐写法（已修正语法错误并优化结构）：

$query = "(SELECT *, 'archive' AS flag 
           FROM `archiveArticles` 
           WHERE `stage` = 1 
             AND MATCH(title, description) AGAINST (:search1 IN BOOLEAN MODE))
          UNION ALL
          (SELECT *, 'market' AS flag 
           FROM `marketNewsArticles` 
           WHERE MATCH(title, description) AGAINST (:search2 IN BOOLEAN MODE))
          UNION ALL
          (SELECT *, 'business' AS flag 
           FROM `businessNewsArticles` 
           WHERE MATCH(title, description) AGAINST (:search3 IN BOOLEAN MODE))";

$select = $dbh->prepare($query);
// 方式一：逐个 bindValue（清晰、易调试）
$select->bindValue(':search1', $value, PDO::PARAM_STR);
$select->bindValue(':search2', $value, PDO::PARAM_STR);
$select->bindValue(':search3', $value, PDO::PARAM_STR);
$select->execute();

// 或方式二：统一 execute() 传参（更简洁）
// $select->execute([
//     ':search1' => $value,
//     ':search2' => $value,
//     ':search3' => $value
// ]);

⚠️ 关键注意事项：

• 移除分号 ;：原始 SQL 中每个子查询末尾的 ; 是非法的，会导致语法错误。UNION 各部分之间仅用 UNION [ALL] 连接，整条语句以单个分号结尾（由 PDO 自动处理，SQL 字符串内无需显式添加）。
• 优先使用 UNION ALL：若无需去重，UNION ALL 比 UNION 性能更高（避免隐式 DISTINCT 排序开销）。
• 全文索引前提：确保 title 和 description 字段在各表上已建立 FULLTEXT 索引，否则 MATCH ... AGAINST 将无法生效或退化为全表扫描。
• 布尔模式安全：IN BOOLEAN MODE 支持 +、-、* 等操作符，但需对用户输入做基础过滤（如移除干扰符号），防止语法错误或意外行为。

✅ 总结：在复杂 UNION 场景中，坚持“一占位符一绑定”原则，不仅规避了 PDO 的参数复用限制，也提升了代码可读性与维护性。参数命名体现语义（如 :search_archive）更佳，但至少保证唯一性——这是稳健实现跨表全文联合检索的基础实践。