Extension:CirrusSearch/de

This page is a translated version of the page Extension:CirrusSearch and the translation is 37% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎français • ‎русский • ‎中文 • ‎日本語
MediaWiki-Erweiterungen
OOjs UI icon advanced.svg
CirrusSearch
Erscheinungsstatus: stabil
Einbindung Search, API , Hook
Beschreibung Implementiert eine Suchfunktion in MediaWiki, die Elasticsearch benutzt.
Autor(en) Nik Everett, Chad Horohoe, Erik Bernhardson
Letzte Version Kontinuierliche Aktualisierungen
Kompatibilitätspolitik Release-Zweige
MediaWiki 1.29+
PHP 5.6+
Datenbankänderungen Nein
Lizenz GNU General Public License 2.0 or later
Herunterladen
README

  • $wgCirrusSearchServers
  • $wgCirrusSearchMaxRetries
  • $wgCirrusSearchSoftCommitTimeout
  • $wgCirrusSearchHardCommitTimeout
  • $wgCirrusSearchHardCommitMaxPendingDocs
  • $wgCirrusSearchCacheResultTime
  • $wgCirrusSearchCacheCleanupThread
  • $wgCirrusSearchFilterCacheSize
  • $wgCirrusSearchFilterCacheAutowarmCount
  • $wgCirrusSearchQueryResultCacheSize
  • $wgCirrusSearchQueryResultCacheAutowarmCount
  • $wgCirrusSearchDocumentCacheSize
  • many others
Übersetze die CirrusSearch Erweiterung wenn sie auf translatewiki.net verfügbar ist
Prüfe die Benutzungs- und Versionsmatrix.
Vagrant-Rolle cirrussearch
Probleme Offene Aufgaben · Einen Fehler melden

Die CirrusSearch-Erweiterung implementiert eine Suchfunktion in MediaWiki, die Elasticsearch benutzt.

Diese Seite beschreibt die Installation. Nach erfolgreicher Installation geht es bei Help:CirrusSearch/de weiter zur Benutzung.

Projektziele

  • Keine seltsamen Abhängigkeiten, die die Installation erschweren
    • Die einzigen Abhängigkeiten sollten reine PHP-Mediawiki-Erweiterungen und Elasticsearch selbst sein
  • Einen nahezu in Echtzeit aktualisierten Suchindex für Wikiseiten bereitstellen, der durch andere MediaWiki-Erweiterungen erweiterbar ist.
  • Alle Abfrageoptionen bereitstellen, die MWSearch Usern lieferte und mehr

Abhängigkeiten

PHP und cURL
Elasticsearch

  • MediaWiki 1.29.x und 1.30.x benötigen Elasticsearch 5.3.x oder 5.4.x.
  • MediaWiki 1.31.x und 1.32.x benötigen Elasticsearch 5.5.x oder 5.6.x.
  • MediaWiki 1.33.x und 1.34.x benötigen Elasticsearch 6.5.x (6.5.4 empfohlen).

Zu beachten ist, dass zusätzlich eine Java-Installation, wie OpenJDK, benötigt wird.

Elastica
  • Elastica ist eine PHP-Bibliothek um mit Elasticsearch zu reden. Elastica kann nach der Anleitung weiter unten installiert werden.
Andere
  • Aufgrund der tatsächlichen Handhabung der Aufträge durch die CirrusSearch-Erweiterung ist es ratsam, Aufträge in redis aufzusetzen, um Nachrichten wie Notice: unserialize(): Error at offset 64870 of 65535 bytes in JobQueueDB.php und Unsupported operand types zu verhindern. Siehe task T157759.

Installation

Elastica

Obwohl unten beschrieben wird, dass man Composer nur ausführen soll soll, wenn man von Git installiert, kann es nötig sein, Composer trotzdem auszuführen, um alle PHP-Abhängigkeiten zu installieren.

  • Lade die Erweiterung herunter und lege die Datei(en) in ein Verzeichnis namens Elastica in deinem Ordner extensions/ ab.
  • Führe nur bei der Installation von Git Composer aus, um PHP-Abhängigkeiten zu installieren, indem Du composer install --no-dev im Erweiterungsverzeichnis ausgibst. (Siehe T173141 für mögliche Komplikationen.)
  • Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
    wfLoadExtension( 'Elastica' );
    
  •   Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.

CirrusSearch

  • Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
    wfLoadExtension( 'CirrusSearch' );
    
  • Now follow the setup instructions in the CirrusSearch README delivered with your extension i.e. $IP/extensions/CirrusSearch/README. Note that all info in it might not apply to your version of the extension, especially the version of Elasticsearch supported.
  • Configure as required.
  •   Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.

An Nutzer, die MediaWiki 1.33 und früher betreiben:

Die oben stehenden Anweisungen beschreiben die neue Installationsanweisung für diese Erweiterung unter Verwendung von wfLoadExtension(). Falls du diese Erweiterung in einer dieser früheren Versionen (MediaWiki 1.33 und früher)  – an Stelle von wfLoadExtension( 'CirrusSearch' ); – installieren musst, benutze:

require_once "$IP/extensions/CirrusSearch/CirrusSearch.php";

Upgrading

Please follow the upgrade instructions in the CirrusSearch UPGRADE file.

Configuration

The configuration options of CirrusSearch are documented at the docs/settings.txt file, and also in the CirrusSearch.php file.

See also documentation on CirrusSearch configuration profiles.

Hooks

CirrusSearch extension defines a number of hooks that other extensions can make use of to extend the core schema and modify documents. The following hooks are available:

API

CirrusSearch features can be used in API queries. Searching happens via the normal search API, action=query&list=search; you can use CirrusSearch-specific features, such as the morelike: special prefix to find pages related to Marie Curie and radium: api.php?action=query&list=search&srsearch=morelike:Marie_Curie%7Cradium&srlimit=10&srprop=size&formatversion=2 Custom APIs and parameters are provided for querying CirrusSearch configuration and debug information:

See also

Local development

Elastic Search service can be run with the Vagrant role (cirrussearch) and MediaWiki Vagrant.

For Docker, you can use a command like docker run -d --name elasticsearch -p 9200:9200 -p 9300:9300 -e "discovery.type=single-node" elasticsearch:6.8.2. Then follow the installation and configuration directions. If your web host is in a container you'll want to make sure the above container is on the same network, and in LocalSettings.php you will want to reference elasticsearch as the host name. This will not have the WMF plugins but can be sufficient for basic testing.