Suche #

Diese Seite richtet sich an Entwickler, die die Suche einer Website bauen. Exponential liefert eine Suchmaschine mit, die ihren Index in der Datenbank der Website hält und nichts weiter braucht; Solr über die Erweiterung ezfind ist die Wahl für Websites, die Relevanzabstimmung, Facetten oder große Mengen brauchen. In beiden Fällen bestimmt das Inhaltsmodell, was durchsuchbar ist.

Inhalt #

1. Zwei Engines
2. Was indexiert wird
3. Wann Inhalte indexiert werden
4. Die Suchseite
5. Suchen aus Templates
6. Suchen aus PHP
7. Den Index neu aufbauen
8. Die Wahl für ein Projekt

Zwei Engines #

settings/solr.ini [SolrSettings] Enabled=false wird mitgeliefert; ./console exp:solr status sagt, ob ein Solr konfiguriert ist und antwortet (Such-Backends). Dieses Repository gibt nicht an, welche Solr-Versionen eZ Find braucht; entnehmen Sie das dem eigenen Repository der Erweiterung.

Was indexiert wird #

Jedes Attribut, dessen Klassenattribut durchsuchbar ist (is_searchable), wird über seinen Datentyp indexiert; entfernen Sie das Häkchen bei Feldern, die nie einen Treffer liefern sollen (interne Notizen, Codes). Objektname, Klasse und Sektion werden ebenfalls indexiert, sodass sich Ergebnisse danach einschränken lassen. Objekte werden nur von Benutzern gefunden, die sie lesen dürfen: Die Suche prüft content/read wie ein Fetch (Sektionen, Rollen und Richtlinien).

Wann Inhalte indexiert werden #

Beim Veröffentlichen, es sei denn, [SearchSettings] DelayedIndexing ist enabled (oder classbased mit DelayedIndexingClassList[]). Dann reiht das Veröffentlichen das Objekt nur ein, und der Cronjob indexcontent.php des Standardteils indexiert es später. Das Veröffentlichen großer Objekte geht so schneller, aber eine Website mit verzögertem Indexieren hängt von Cron ab: Ohne Cron erscheinen neue Inhalte nie in der Suche (Verzögertes Indexieren und Cron, Cronjobs).

Die Suchseite #

/content/search ist die Such-View; /content/advancedsearch das erweiterte Formular. Das Ergebnis-Template ist content/search.tpl Ihrer Design-Kette: Überschreiben Sie es passend zur Website, behalten Sie den Feldnamen SearchText und blättern Sie mit dem mitgelieferten Navigator (Template für Suchergebnisse). Die Grenzen der eingebauten Engine sind Einstellungen in [SearchSettings]:

Suchen aus Templates #

{def $result = fetch( 'content', 'search', hash(
        'text', $search_text,
        'subtree_array', array( $node.node_id ),
        'limit', 10,
        'offset', $view_parameters.offset ) )}
{foreach $result.SearchResult as $hit}
    {node_view_gui content_node=$hit view='line'}
{/foreach}
<p>{$result.SearchCount} results</p>
{undef $result}

Die Parameter des Fetch search (kernel/content/function_definition.php): text, subtree_array, offset, limit, publish_timestamp, publish_date, section_id, class_id, class_attribute_id, ignore_visibility, limitation und sort_by; class_id nimmt numerische Klassen-IDs. Verwenden Sie ihn für ein Suchfeld, das auf einen Teil der Website beschränkt ist; für Listen ohne Suchtext ist ein Fetch list oder tree günstiger (Inhalte in Templates abrufen).

Suchen aus PHP #

eZSearch::search( $text, $params ) führt die konfigurierte Engine aus; derselbe Code funktioniert also mit der eingebauten Engine und mit eZ Find. Prüfen Sie die Parameter, die Ihre Engine annimmt, in ihrer Klasse, bevor Sie sich darauf verlassen (kernel/classes/ezsearch.php, die von SearchEngine genannte Engine-Klasse).

Den Index neu aufbauen #

Nach einem Import, einem Datenbankumzug oder wenn Ergebnisse falsch sind:

php bin/php/updatesearchindex.php --clean --allow-root-user

--clean leert zuerst den Index. Führen Sie es als Benutzer der Website aus, auf einer großen Website in einer ruhigen Stunde. Mit eZ Find indexieren Sie mit den eigenen Werkzeugen der Erweiterung neu.

Die Wahl für ein Projekt #

Verwandte Seiten #

• Suchen: die Sicht der Redakteure
• Suchstatistik
• Kurs für Trainer zur Suche
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.