如何实现GET传参与ACF复选框多值匹配的WordPress文章查询

问题原因 #

你之前遇到的报错是因为将数组直接传递给了meta_query中单个条件的value参数，而LIKE比较需要字符串类型的值，WordPress内部调用addcslashes()时收到数组，因此触发类型错误。同时，多颜色时直接用单个LIKE无法匹配序列化存储的ACF复选框值，需要拆分多值为多个OR关系的查询条件。

解决方案代码 #

以下是完整的处理逻辑，实现多颜色任意匹配的功能：

// 初始化meta_query，默认用AND关联其他搜索条件
$meta_query = array('relation' => 'AND');

// 处理GET传递的颜色参数
if (isset($_GET['colors']) && trim($_GET['colors']) !== '') {
    // 清理参数并拆分数组
    $raw_colors = sanitize_text_field($_GET['colors']);
    $color_list = array_filter(explode(',', $raw_colors)); // 过滤空值，避免无效条件
    
    if (!empty($color_list)) {
        // 构建颜色查询的OR条件组
        $color_conditions = array('relation' => 'OR');
        
        foreach ($color_list as $color) {
            $color_conditions[] = array(
                'key'     => 'your_color_field', // 替换为你的ACF颜色字段键名
                'value'   => esc_sql(trim($color)), // 转义并去除首尾空格
                'compare' => 'LIKE'
            );
        }
        
        // 将颜色条件组加入主meta_query
        $meta_query[] = $color_conditions;
    }
}

// 构建WP_Query参数
$search_args = array(
    'post_type'      => 'your_post_type', // 替换为你的目标文章类型
    'posts_per_page' => -1, // 根据需求调整每页显示数量
    'meta_query'     => $meta_query
);

// 执行查询
$custom_search_query = new WP_Query($search_args);

关键说明 #

1. 参数处理：使用array_filter过滤拆分后的空值，避免因参数中多余逗号产生无效查询条件；用sanitize_text_field和esc_sql确保参数安全，防止SQL注入。
2. 条件结构：多颜色时通过relation => 'OR'的条件组，让每个颜色单独作为一个LIKE条件，只要文章的ACF颜色字段包含其中任意一个值即可匹配。
3. ACF存储适配：ACF复选框字段默认以序列化数组存储值，LIKE查询可以匹配到序列化字符串中的单个颜色值，因此该逻辑适配绝大多数ACF复选框配置。

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