如何基于Drupal 8 Solr Search模块创建高级搜索表单？

我之前帮不少Drupal项目做过Solr高级搜索的定制，刚好能给你一些落地的思路——确实，Solr Facets更多是用来过滤已搜索出的结果，而你要的是「先设置多维度条件再执行搜索」的高级表单，这得靠自定义开发来实现，下面是一步步的具体方案：

1. 先搭一个自定义模块做容器 #

首先创建一个专属的自定义模块（比如叫custom_solr_advanced_search），所有自定义逻辑都放在这里，绝对不要直接修改核心或 contrib 模块的代码，避免后续升级出问题。

2. 用Drupal表单API构建高级搜索表单 #

基于Drupal的Form API创建你的自定义表单，把需要的搜索字段都加进去，比如关键词多字段匹配、日期范围、内容类型筛选、布尔逻辑选项等等。给你一段基础的代码示例：

<?php

namespace Drupal\custom_solr_advanced_search\Form;

use Drupal\Core\Form\FormBase;
use Drupal\Core\Form\FormStateInterface;

class AdvancedSearchForm extends FormBase {

  public function getFormId() {
    return 'custom_solr_advanced_search_form';
  }

  public function buildForm(array $form, FormStateInterface $form_state) {
    // 关键词输入（支持多字段匹配、布尔逻辑）
    $form['keywords'] = [
      '#type' => 'textfield',
      '#title' => $this->t('Keywords'),
      '#description' => $this->t('Use AND/OR to refine, e.g. "Drupal Solr" AND "Advanced Search"'),
    ];

    // 发布日期范围选择器
    $form['date_range'] = [
      '#type' => 'daterange',
      '#title' => $this->t('Published Date'),
      '#date_part_order' => ['year', 'month', 'day'],
      '#date_label_position' => 'within',
    ];

    // 内容类型筛选下拉
    $form['content_type'] = [
      '#type' => 'select',
      '#title' => $this->t('Content Type'),
      '#options' => node_type_get_names(),
      '#empty_option' => $this->t('All Content Types'),
    ];

    // 提交按钮
    $form['actions']['#type'] = 'actions';
    $form['actions']['submit'] = [
      '#type' => 'submit',
      '#value' => $this->t('Run Advanced Search'),
      '#button_type' => 'primary',
    ];

    return $form;
  }

  public function submitForm(array &$form, FormStateInterface $form_state) {
    // 把表单值转换成Solr能识别的查询参数
    $query_params = [];

    // 处理关键词：支持指定搜索字段，比如同时匹配标题和正文
    $keywords = trim($form_state->getValue('keywords'));
    if (!empty($keywords)) {
      $query_params['q'] = "title:\"{$keywords}\" OR body:\"{$keywords}\"";
    }

    // 处理日期范围，转换成Solr的区间查询语法
    $date_range = $form_state->getValue('date_range');
    if (!empty($date_range['value']) && !empty($date_range['end_value'])) {
      $start_date = date('Y-m-d', strtotime($date_range['value']));
      $end_date = date('Y-m-d', strtotime($date_range['end_value']));
      $query_params['fq'][] = "created:[{$start_date}T00:00:00Z TO {$end_date}T23:59:59Z]";
    }

    // 处理内容类型筛选，添加Solr过滤条件
    $content_type = $form_state->getValue('content_type');
    if (!empty($content_type)) {
      $query_params['fq'][] = "bundle:{$content_type}";
    }

    // 跳转到你的Solr搜索结果页面，传递所有查询参数
    $form_state->setRedirect('view.solr_search_results.page_1', [], ['query' => $query_params]);
  }
}

3. 让Solr搜索结果页面识别自定义参数 #

默认的Solr Search模块可能不会自动处理你传递的fq（过滤查询）参数，这时候可以用hook来修改Solr的查询逻辑：

<?php

use Drupal\search_api_solr\SolrBackendInterface;
use Drupal\search_api\Query\QueryInterface;

function custom_solr_advanced_search_search_api_query_alter(QueryInterface $query) {
  $request = \Drupal::request();
  $fq_params = $request->query->get('fq');
  
  if (!empty($fq_params)) {
    $backend = $query->getIndex()->getBackend();
    if ($backend instanceof SolrBackendInterface) {
      // 把所有过滤参数添加到Solr查询中
      foreach ($fq_params as $filter) {
        $query->addFilter($filter);
      }
    }
  }
}

4. 优化用户体验与样式 #

• 用主题系统给表单加样式，比如把日期范围、分类选项分组展示，让界面更清晰
• 添加表单验证：比如关键词不能全是空格、结束日期不能早于开始日期
• 可以加个「保存搜索条件」的功能，或者提供几个常用的搜索预设模板

为什么Solr Facets满足不了你的需求？ #

再明确一下：Facets是基于已搜索结果的动态过滤工具，用户先输入关键词得到结果，再用Facets缩小范围；而你要的高级搜索是先设置所有条件再执行搜索，两者的逻辑顺序完全不同，所以必须靠自定义表单+查询逻辑来实现。

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