Apache Solr und TYPO3: Profi-Suche mit Filtern, Vorschlägen und Vektorsuche

Die normale Suche von TYPO3 durchsucht Titel und Inhalt. Das reicht für kleine Internetseiten. Große Projekte brauchen mehr Leistung. Sie müssen oft tausende Seiten durchsuchen. Sie müssen auch Dateien durchsuchen. Dafür brauchen Sie eine eigene Technik für die Suche. Apache Solr macht genau das. Das Programm EXT:solr verbindet TYPO3 und Apache Solr sehr gut.

Dieser Text erklärt die Arbeit mit EXT:solr. Seit Solr 9.8 gibt es das Modul llm. Ab Solr 10 heißt es language-models. Das Modul macht eine Vektorsuche möglich. Vektorsuche bedeutet: Der Computer versteht den Sinn von Wörtern. Wir zeigen Ihnen den Einbau dieser Profi-Suche.

Inhaltsverzeichnis  

Was EXT:solr macht  

EXT:solr verbindet TYPO3 mit einem Apache Solr Server . Das ergibt eine vollständige Profi-Suche:

Aufbau des Systems  

Das System besteht aus vier Teilen. Diese Teile arbeiten zusammen:

So funktioniert der Weg der Daten:

1. Redakteure erstellen Inhalte in TYPO3.
2. Ein Programmteil bemerkt diese Änderungen durch PSR-14 Events . Das Programm schreibt einen Eintrag in die Warteschlange.
3. Ein Planerprogramm arbeitet die Warteschlange ab. Es sendet die Daten an den Solr Server.
4. Das Suchprogramm auf der Internetseite fragt den Solr Server ab. Es zeigt die Ergebnisse an.

Übersicht der Programme  

Passende Versionen  

composer require apache-solr-for-typo3/solr:dev-main

Setup in unter 10 Minuten  

Start mit Composer  

composer require apache-solr-for-typo3/solr

Lokale Arbeit mit DDEV  

Der schnellste Weg für lokale Tests ist das DDEV Addon :

ddev add-on get ddev/ddev-typo3-solr
ddev restart

Sie stellen die Cores in dieser Datei ein .ddev/typo3-solr/config.yaml:

config: 'vendor/apache-solr-for-typo3/solr/Resources/Private/Solr/solr.xml'
typo3lib: 'vendor/apache-solr-for-typo3/solr/Resources/Private/Solr/typo3lib'
configsets:
  - name: 'ext_solr_13_1_0'
    path: 'vendor/apache-solr-for-typo3/solr/Resources/Private/Solr/configsets/ext_solr_13_1_0'
cores:
  - name: 'core_de'
    schema: 'german/schema.xml'
  - name: 'core_en'
    schema: 'english/schema.xml'

Und in .ddev/config.yaml erstellen Sie die Cores nach dem Start:

hooks:
  post-start:
    - exec-host: ddev solrctl apply

Docker Live System  

Für Live Systeme gibt es ein fertiges Docker Image . Es enthält fertige Cores für alle Sprachen:

services:
  solr:
    image: typo3solr/ext-solr:13.1
    ports:
      - "8983:8983"
    volumes:
      - solr-data:/var/solr
    restart: unless-stopped

volumes:
  solr-data:
    driver: local

Hosting Dienste  

Sie wollen keinen eigenen Server betreiben? Es gibt zwei einfache Möglichkeiten:

TYPO3 Site Konfiguration  

Schreiben Sie die Verbindung in diese Datei config/sites/<identifier>/config.yaml:

solr_enabled_read: true
solr_host_read: solr
solr_port_read: '8983'
solr_scheme_read: http
solr_path_read: /
solr_core_read: core_de

Die Warteschlange: Das Herzstück  

Die Index Queue ist eine Warteschlange. Sie bringt Inhalte aus TYPO3 in den Solr Server.

Seiten aufnehmen  

Das Programm nimmt normale Seiten sofort auf. Sie müssen nichts extra einstellen. Das Programm liest die Seite und sendet den Text an Solr.

Beliebige Artikel aufnehmen  

Sie können jede TYPO3 Tabelle in die Suche aufnehmen. Sie machen das mit TypoScript. Hier ist ein Beispiel für EXT:news:

plugin.tx_solr.index.queue {
    news = 1
    news {
        type = tx_news_domain_model_news

        fields {
            title = title
            abstract = teaser
            author = author

            content = SOLR_CONTENT
            content {
                cObject = COA
                cObject {
                    10 = TEXT
                    10.field = bodytext
                }
            }

            category_stringM = SOLR_RELATION
            category_stringM {
                localField = categories
                multiValue = 1
            }

            url = TEXT
            url {
                typolink.parameter = {$plugin.tx_news.settings.detailPid}
                typolink.additionalParams = &tx_news_pi1[controller]=News&tx_news_pi1[action]=detail&tx_news_pi1[news]={field:uid}
                typolink.additionalParams.insertData = 1
                typolink.returnLast = url
            }
        }
    }
}

Die drei Inhalts-Objekte im Überblick:

Dynamische Felder  

EXT:solr nutzt besondere Endungen für Felder. So können Sie eigene Felder einfach hinzufügen :

Überprüfung  

EXT:solr bemerkt Änderungen an Einträgen. Es gibt zwei Arten dafür:

• Sofort (Standard): Das System verarbeitet Änderungen sofort beim Speichern.
• Verzögert: Das System sammelt Änderungen in einer Warteschlange. Ein Planerprogramm arbeitet die Liste später ab.

Sie stellen das in den Extension Settings ein. Der Punkt heißt monitoringType.

Hash Strategie  

Das System nutzt eine Site-Hash-Strategie. Das trennt Daten von verschiedenen Internetseiten. Wir empfehlen Strategie 1 für neue Projekte. Ein Wechsel der Strategie braucht einen neuen Suchlauf für alle Seiten.

Suche konfigurieren  

Grundlegende Einstellungen  

plugin.tx_solr {
    enabled = 1
    search {
        targetPage = 42
        initializeWithEmptyQuery = 1
        showResultsOfInitialEmptyQuery = 0
        trustedFields = url
    }
}

Filter Navigation  

Facetten sind Filter. Filter machen die Suche sehr einfach :

plugin.tx_solr.search {
    faceting = 1
    faceting {
        facets {
            contentType {
                label = Inhaltstyp
                field = type
            }
            category {
                label = Kategorie
                field = category_stringM
            }
            year {
                label = Jahr
                field = year_intS
                type = queryGroup
                queryGroup {
                    2026.query = [2026-01-01T00:00:00Z TO 2026-12-31T23:59:59Z]
                    2025.query = [2025-01-01T00:00:00Z TO 2025-12-31T23:59:59Z]
                }
            }
        }
    }
}

Verfügbare Arten für Filter: options (Standard), queryGroup, hierarchy, dateRange, numericRange.

Suchvorschläge  

plugin.tx_solr {
    suggest = 1
    suggest {
        numberOfSuggestions = 10
        suggestField = spell
        showTopResults = 1
        numberOfTopResults = 5
    }
}

Hervorhebung und Rechtschreibung  

plugin.tx_solr.search {
    results {
        resultsHighlighting = 1
        resultsHighlighting {
            fragmentSize = 200
            wrap = <mark>|</mark>
        }
    }
    spellchecking = 1
    sorting = 1
}

Vektor und Hybridsuche mit Solr 9.8  

Apache Solr 9.8 hat das Modul llm. Ab Solr 10 heißt das Modul language-models . Dieses Modul erlaubt eine semantische Suche direkt auf dem Server. Semantische Suche achtet auf den Sinn von Wörtern. Sie brauchen keine extra Datenbank dafür.

Das LLM Modul  

Das Modul löst ein bekanntes Problem. Nutzer suchen oft mit anderen Wörtern als der Text nutzt. Das System wandelt Texte und Suchanfragen in Vektoren um. Vektoren sind Zahlenreihen. Ähnliche Zahlenreihen bedeuten einen ähnlichen Sinn.

Unterstützte Anbieter :

Hybridsuche  

Die beste Einstellung kombiniert zwei Suchen. Sie kombiniert die normale Wortsuche mit der Vektorsuche:

?q=Kundenbeschwerden Bearbeitung
&rq={!rerank reRankQuery=$rqq reRankDocs=50 reRankWeight=2}
&rqq={!knn_text_to_vector model=openai-embed f=vector topK=50}Kundenbeschwerden Bearbeitung

So finden Sie genaue Wörter und ähnliche Bedeutungen.

Beispiele für die Nutzung  

Fehlersuche in 6 Schritten  

Manchmal funktioniert die Suche nicht. Es gibt vier häufige Gründe. Das sind: Verbindung, Warteschlange, Solr Core oder die Ansicht. Gehen Sie Schritt für Schritt vor.

Ablauf Plan  

Häufige Fehler  

Protokoll einschalten  

Sie können ein genaues Protokoll einschalten. Machen Sie das nur auf Entwicklungs-Servern:

plugin.tx_solr.logging {
    debugOutput = 1
    exceptions = 1
    indexing = 1
    query.rawGet = 1
    query.queryString = 1
}

Und stellen Sie die Datei in config/system/additional.php ein:

$GLOBALS['TYPO3_CONF_VARS']['LOG']['ApacheSolrForTypo3']['Solr']['writerConfiguration'] = [
    \Psr\Log\LogLevel::DEBUG => [
        \TYPO3\CMS\Core\Log\Writer\FileWriter::class => [
            'logFile' => \TYPO3\CMS\Core\Core\Environment::getVarPath() . '/log/solr.log',
        ],
    ],
];

ddev exec tail -f var/log/solr.log

PSR-14 Events für eigene Programme  

EXT:solr sendet an wichtigen Stellen Signale. Diese Signale heißen PSR-14 Events . Sie können diese Signale für eigene Programme nutzen.

Eigene Felder hinzufügen  

<?php

declare(strict_types=1);

namespace MyVendor\MyExt\EventListener;

use ApacheSolrForTypo3\Solr\Event\Indexing\BeforeDocumentsAreIndexedEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener(identifier: 'my-ext/enrich-solr-documents')]
final class EnrichSolrDocuments
{
    public function __invoke(BeforeDocumentsAreIndexedEvent $event): void
    {
        foreach ($event->getDocuments() as $document) {
            $document->addField(
                'custom_score_floatS',
                $this->calculateScore($document)
            );
        }
    }

    private function calculateScore(
        \ApacheSolrForTypo3\Solr\System\Solr\Document\Document $document
    ): float {
        return match ($document->getField('type')['value'] ?? '') {
            'pages' => 1.0,
            'tx_news_domain_model_news' => 0.8,
            default => 0.5,
        };
    }
}

Wichtige Signale  

TYPO3 v14: Änderungen  

Sie nutzen TYPO3 Version 14? Dann gibt es wichtige Änderungen:

• Fluid 5.0: Fluid 5.0 braucht genaue Datentypen. Prüfen Sie Ihre eigenen Vorlagen.
• TypoScriptFrontendController: Einige alte Befehle fallen weg. Sie müssen neue Befehle für Abfragen nutzen.
• TCA: Die Einstellung für Suchfelder ändert sich. Sie müssen jetzt searchable => true für jede Spalte setzen.

Live System Liste  

Fazit  

EXT:solr macht die TYPO3 Suche zu einer Profi-Suche. Sie bekommen Filter, Vorschläge und Vektorsuche. Die Firma dkd Internet Service pflegt das Programm sehr gut. Sie können das Programm mit DDEV sehr schnell lokal testen.

Die drei wichtigsten Punkte:

1. EXT:solr durchsucht alles. Es durchsucht Seiten, Artikel und Dateien. Die Verbindung ist sehr anpassbar.
2. Die Vektorsuche läuft auf dem Solr Server. Das Modul llm bringt semantische Suche in Solr.
3. Die Einrichtung ist einfach. Sie installieren das DDEV Addon. Dann erstellen Sie den Planer. Danach ist alles fertig.

Reicht die normale Suche für Sie? Oder brauchen Sie eine Profi-Suche? Bei mehr als ein paar hundert Seiten brauchen Sie Solr. Das gilt auch für viele Dateien oder Filter.