使用 PHP 和 ApacheSolr 实现企业搜索

封面图 • 2025-09-25 • PHP

使用 **PHP** 和 **Apache Solr** 实现企业搜索是一个非常常见的场景。Solr 是一个基于 Java 的高性能搜索服务器，能够提供强大的全文搜索、分面搜索、高亮等功能。而 PHP 可以作为前端语言来与 Solr 进行交互。

---

## ✅ 一、概述

### 目标：
实现一个企业级的搜索功能，允许用户通过关键词搜索内容，并展示结果。

### 技术栈：
- **PHP**：用于构建前端逻辑
- **Apache Solr**：用于数据索引和搜索
- **Solr PHP Client**：用于 PHP 与 Solr 通信（如 `Solarium` 或 `Zend_Search_Lucene`）

---

## 🔧 二、环境准备

### 1. 安装 Apache Solr

#### 下载 Solr：
```bash
wget https://archive.apache.org/dist/lucene/solr/9.0.0/apache-solr-9.0.0.zip
unzip apache-solr-9.0.0.zip
cd apache-solr-9.0.0
```

#### 启动 Solr：
```bash
./bin/solr start -e cloud
```

> 默认端口是 `8983`，访问 `http://localhost:8983/solr/` 查看管理界面。

---

### 2. 创建 Solr Collection（核心）

```bash
./bin/solr create -c your_core_name -n data_driven_schema_config
```

---

### 3. 配置 Schema（可选）

在 `solr/your_core_name/conf/schema.xml` 中定义字段类型和字段：

```xml
<field name="id" type="string" indexed="true" stored="true" required="true" />
<field name="title" type="text_general" indexed="true" stored="true" />
<field name="content" type="text_general" indexed="true" stored="true" />
<field name="timestamp" type="date" indexed="true" stored="true" />
```

---

## 🧩 三、PHP 与 Solr 交互

### 使用 Solarium 库（推荐）

#### 安装 Solarium：

```bash
composer require solarium/solarium
```

#### 示例代码：添加文档到 Solr

```php
<?php
require 'vendor/autoload.php';

use Solarium\Client;
use Solarium\QueryType\Update\Query\Document;

// 配置 Solr 客户端
$config = [
    'host' => 'localhost',
    'port' => 8983,
    'path' => '/solr/your_core_name',
    'core' => 'your_core_name'
];

$client = new Client($config);

// 创建更新查询
$update = $client->createUpdate();

// 添加文档
$doc = new Document();
$doc->addField('id', '1');
$doc->addField('title', '示例标题');
$doc->addField('content', '这是示例内容，用于测试 Solr 索引。');
$doc->addField('timestamp', date('c'));

$update->addDocument($doc);
$update->addCommit();

// 执行查询
$result = $client->execute($update);

echo "文档已成功添加到 Solr！";
```

---

### 示例代码：搜索文档

```php
<?php
require 'vendor/autoload.php';

use Solarium\Client;
use Solarium\QueryType\Select\Query\Query;

// 配置 Solr 客户端
$config = [
    'host' => 'localhost',
    'port' => 8983,
    'path' => '/solr/your_core_name',
    'core' => 'your_core_name'
];

$client = new Client($config);

// 创建 select 查询
$query = $client->createSelect();

// 设置查询条件
$query->setQuery('content:示例');

// 执行查询
$resultSet = $client->select($query);

// 输出结果
foreach ($resultSet as $document) {
 echo "ID: " . $document->id . " ";
 echo "Title: " . $document->title . " ";
 echo "Content: " . $document->content . " <hr>";
}
```

---

## 🧠 四、企业级优化建议

### 1. 分页支持

在搜索中加入分页参数：

```php
$query->setStart(0); // 起始位置
$query->setRows(10); // 每页条数
```

### 2. 高亮显示

```php
$highlight = $query->getHighlighting();
$highlight->setFields(['title', 'content']);
$highlight->setSimplePre('');
$highlight->setSimplePost('');
```

### 3. 分面搜索（Faceting）

```php
$facetSet = $query->getFacetSet();
$facetSet->createFacetField('category');
```

### 4. 自动补全（Suggester）

配置 Solr 的 suggester 功能，实现自动补全提示。

---

## 🧰 五、工具推荐

| 工具 | 用途 |
|------|------|
| [Solarium](https://solarium.readthedocs.io/) | PHP 与 Solr 交互的客户端库 |
| [Solr Admin UI](http://localhost:8983/solr/) | Solr 管理界面 |
| [Postman](https://www.postman.com/) | 测试 Solr API 接口 |

---

## 📦 六、部署建议

- 将 Solr 部署在独立服务器上，确保性能。
- 使用 PHP-FPM + Nginx 提高性能。
- 对大型数据集使用批量导入脚本（如从数据库导出为 XML 或 JSON）。
- 定期重建索引或使用增量更新。

---

## 📘 七、参考资料

- [Apache Solr 官方文档](https://solr.apache.org/)
- [Solarium 官方文档](https://solarium.readthedocs.io/)
- [Solr PHP 客户端教程](https://github.com/solariumphp/solarium)

---

如果你有具体的业务需求（比如搜索字段、权限控制、多语言支持等），我可以进一步帮你设计架构和代码。需要我帮你生成一个完整的项目结构吗？