SuperAPI AI 工具集

typo3-solr

测试与质量

查看项目

更新于 10-15 21:10

技能介绍

用途:在 TYPO3 中通过 EXT:solr 连接 Apache Solr 服务器,实现全文搜索、分面(facets)与自动补全,并排查索引与查询问题。

主要能力:EXT:solr 负责核心搜索集成;EXT:tika 用于从文件提取文本与元数据;EXT:solrfal 用于将 FAL 文件索引进 Solr;EXT:solrconsole 提供后端管理控制台;EXT:solrdebugtools 用于查询调试与评分分析。索引流程为:编辑内容触发 PSR-14 事件,写入索引队列(tx_solr_indexqueue_item),由调度器轮询并通过 HTTP POST 将文档发送到 Solr 核心。

使用方式:通过 Composer 安装,命令为 composer require apache-solr-for-typo3/solr。本地开发推荐 DDEV 插件:ddev add-on get ddev/ddev-typo3-solr 后 ddev restart;常用命令包括 ddev solrctl apply、ddev solrctl wipe、ddev exec -s typo3-solr solr --version、ddev launch :8984、ddev logs -s typo3-solr。站点配置在 config/sites/<identifier>/config.yaml 中设置 solr_enabled_read、solr_host_read、solr_port_read、solr_scheme_read、solr_path_read、solr_core_read。连接信息建议用 helhum/dotenv-connector 按环境注入,避免硬编码。

适用场景:TYPO3 站点的全文搜索、分面筛选、自动补全,以及 PDF、DOCX、XLSX 等文件内容检索(需 EXT:tika 与 EXT:solrfal)。

限制与注意:需按官方 Version Matrix 匹配 EXT:solr、TYPO3、Apache Solr 与 configset 版本;本技能目标为 TYPO3 v14.x 与 EXT:solr 14.0.x。Apache Solr 9.8.0+ 因 CVE-2025-24814 禁止通过 configset 的 lib 指令加载 JAR,solr-typo3-plugin 需从 configsets/ext_solr_*/typo3lib/ 移至 Solr 根目录 /typo3lib/。Docker 部署不要将管理 API 暴露到公网,需自行配置认证与 TLS。向量/语义搜索属于独立的版本与配置集成,服务器支持不代表 TYPO3 插件已启用。具体价格、托管容量与支持版本需向服务商确认,资料未提供。