XF2.x Einstellungen in der Config.php

Alle Informationen, die XenForo für die Verbindung zu dem Datenbankserver benötigt, befinden sich in der Datei src/config.php.

Je nachdem, wie du XenForo installiert hast, kann config.php durch Kopieren des Inhalts der ursprünglichen src/config.php.default-Datei erstellt worden sein, oder der XenForo-Installer hat sie für dich erstellt.

Normalerweise enthält die Konfigurationsdatei nur eine Handvoll Einstellungen, die gerade ausreichen, damit dein XenForo funktioniert, aber es gibt eine Reihe von zusätzlichen Optionen, die du hinzufügen kannst, um die Funktionsweise von XenForo zu ändern.

Diese Einstellungen steuern grundlegende Funktionen der XenForo-Installation, und eine falsche Konfiguration kann dazu führen, dass die Seite nicht mehr funktioniert. Wenn es Probleme gibt, mach die Änderungen an der config.php rückgängig und versuche es erneut.

Im Folgenden findest du eine Liste aller Einstellungen, die über config.php gesteuert werden können. Diese Variablennamen müssen genau so eingegeben werden, wie sie hier angezeigt werden, sonst wird die Einstellung ignoriert. Bei den Variablennamen und -werten wird zwischen Groß- und Kleinschreibung unterschieden.

In jedem Fall wird der Variablenname mit seinem Standardwert angezeigt, zum Beispiel: $config['variableName'] = 'default-value';

---

Verbindung zur Datenbank​

$config['db']['host'] = 'localhost';
$config['db']['port'] = 3306;
$config['db']['socket'] = null;

Der Name oder die IP-Adresse, der Port und der Socket des Datenbankservers, der deine XenForo-Datenbank hostet. Diese Informationen erhältst du von deinem Hosting-Anbieter.

$config['db']['username'] = '';
$config['db']['password'] = '';
$config['db']['dbname'] = '';

Den Benutzernamen und das Passwort, mit dem du dich mit deinem Datenbankserver verbindest, und den Namen der Datenbank, die auf deinem Server gehostet wird und in der deine Foren installiert sind.

Vollständige Unicode-/Emoji-Unterstützung​

$config['fullUnicode'] = false;

Diese Einstellung teilt XenForo mit, ob die notwendigen Schritte für die Unterstützung von vollem Unicode in den Foreninhalten durchgeführt wurden oder nicht. Vollständiger Unicode wird verwendet, um die Verwendung von Emoji im Text zu unterstützen.

Wenn deine XenForo-Installation mit Version 2 begonnen hat und nicht von XenForo 1 aktualisiert wurde, ist deine Datenbank bereits im vollständigen Unicode-Format und du kannst diese Einstellung zusammen mit einem wahren Wert in deiner config.php-Datei platzieren.

Wenn deine XenForo-Installation von XenForo 1 aktualisiert wurde, musst du den Unicode-Konvertierungsprozess ausführen, bevor du den vollen Unicode verwenden kannst, und diese Einstellung sollte bis dahin auf false belassen werden.

Full unicode support requires at least MySQL 5.5.

Wie man auf vollständigen Unicode für Emoji-Unterstützung umstellt...

Einstellungen für Cookies​

Wenn du Einstellungen für das Setzen von Cookies in den Browsern deiner Besucher konfigurieren musst, kannst du die folgenden Einstellungen verwenden. Sei jedoch gewarnt, dass falsche oder ungültige Werte für diese Einstellungen dazu führen können, dass du und deine Besucher sich nicht bei deinem XenForo-Benutzerkonto, einschließlich des Admin-Kontrollzentrums, anmelden können.

Der Hauptgrund für die Änderung dieser Werte ist die Anpassung an mehrere XenForo-Installationen in derselben Domain. Wenn nur eine einzige XenForo-Installation in der Domain vorhanden ist, müssen diese Einstellungen nicht geändert werden.

Ändere diese Werte nur, wenn du sie wirklich brauchst und du weißt, was du tust. Wenn Probleme auftreten, dann setze diese Werte auf ihre Standardwerte zurück.

$config['cookie']['prefix'] = 'xf_';

Alle Cookies werden durch ihren Namen identifiziert, und den Namen der von XenForo gesetzten Cookies wird normalerweise das Präfix xf_ vorangestellt, damit sie von den von anderen Systemen gesetzten Cookies unterschieden werden können. Eine Folge des Änderns dieses Wertes ist, dass die "Erinnere dich an mich"-Einstellung für alle angemeldeten Besucher zurückgesetzt wird, die sich dann bei ihrem nächsten Besuch auf der Seite erneut anmelden müssen.

Der Wert des Präfixes sollte nur Buchstaben, Zahlen und Unterstriche enthalten, wobei Groß- und Kleinschreibung zu beachten sind.

$config['cookie']['path'] = '/';

Mit dem Standardwert von / sind die von XenForo gesetzten Cookies in allen Bereichen der Webseite verfügbar. Wenn dies geändert werden soll, damit XenForo-Cookies nur in einem bestimmten Bereich der Webseite verfügbar sind, ändere den Wert so, dass er den Verzeichnispfad zum richtigen Bereich der Webseite enthält, beginnend mit dem Stammverzeichnis der Webseite, /.

Beispielwerte:

• '/' XenForo-Cookies sind für alle Bereiche der Webseite verfügbar.
• '/forum/' XenForo-Cookies können nur von Seiten gelesen werden, die sich innerhalb des forum-Forenverzeichnisses befinden, das unter http://example.com/forum zu finden ist, wobei example.com für die Adresse der Webseite steht.
• '/path/to/other/folder/' XenForo-Cookies können nur von Seiten gelesen werden, die sich im Verzeichnis path/to/other/folder befinden, das sich unter http://example.com/path/to/other/folderbefindet.
  • Cookies können nicht von Seiten gelesen werden, die sich in Ordnern oberhalb dieses Ortes befinden, d.h.:
  • http://example.com/path
  • http://example.com/path/to
  • http://example.com/path/to/other

Wenn du einen Cookie-Pfad angibst, der das Setzen von Cookies innerhalb des XenForo-Stammverzeichnisses nicht zulässt, kann XenForo die gesetzten Cookies nicht lesen und kritische Vorgänge wie das Einloggen schlagen fehl.

$config['cookie']['domain'] = '';

Ähnlich wie bei der Einstellung für den Cookie-Pfad können auf diese Weise eine Domain angegeben werden, von der die Cookies gelesen werden können. Es ist unüblich, diesen Wert auf etwas anderes als den Standardwert einzustellen, aber wie beim Cookie-Pfad solltest du sehr vorsichtig sein, wenn du ihn änderst, denn wenn du einen Wert eingibst, der XenForo daran hindert, seine eigenen Cookies zu lesen, werden wichtige Funktionen unterbrochen, wie die Möglichkeit, eingeloggt zu bleiben.

Der Grund für die Einstellung dieses Wertes besteht darin, die gemeinsame Nutzung von Cookies auf mehreren Subdomains zu ermöglichen, z. B. würde eine Einstellung von .example.com den Zugriff auf Cookies auf allen Subdomains von example.com ermöglichen, wie www.example.com und other.example.com. In den meisten Fällen kann diese Einstellung in der Standardeinstellung belassen werden.

Beispielwerte:

• '' erlaubt es, dass Cookies nur in der Domain, in der sie gesetzt wurden, gelesen werden können
• '.example.com' erlaubt das Lesen von Cookies auf example.com und jeder Subdomain davon
• 'subdomain.example.com' erlaubt das Lesen von Cookies nur auf subdomain.example.com

---

Quelle: Config.php options | Manual | XenForo

 

[McAtze]

Erweiterte Einstellungen​

Diese Einstellungen sind nicht standardmäßig in der config.php enthalten, da XenForo in den meisten Fällen die Standardwerte verwendet. Wenn du dich entscheidest, eine dieser Einstellungen zu verwenden, stelle sicher, dass du den Betrieb deines Forums vollständig testest, bevor du das System in einer Produktionsumgebung laufen lässt.

Seitenweite Deaktivierung der Funktionen​

Einige XenForo-Systeme können vollständig über die config-Datei deaktiviert werden, ohne dass das Admin-Kontrollpanel überhaupt aufgerufen werden muss. Wenn du eine dieser Einstellungen auf false setzt, wird die entsprechende Funktionalität vollständig deaktiviert.

Wenn ein System über die Datei config.php deaktiviert wurde, kann es nicht über das Admin-Kontrollpanel wieder aktiviert werden - nur eine Änderung der Konfigurationsdatei kann die Funktionalität des Systems wiederherstellen.

Die Beschreibungen dieser Einstellungen erklären, was passiert, wenn du ihren Wert auf false setzt.

• $config['enableMail'] = true;
• $config['enableMailQueue'] = true;
• $config['enableListeners'] = true;
• $config['enableTemplateModificationCallbacks'] = true;
• $config['enableGzip'] = true;
• $config['enableContentLength'] = true;
• $config['enableTfa'] = true;
• $config['enableLivePayments'] = true;
• $config['enableClickjackingProtection'] = true;
• $config['enableReverseTabnabbingProtection'] = true;
• $config['enableApi'] = true;
• $config['enableAddOnArchiveInstaller'] = false;
• $config['enableOneClickUpgrade'] = true;

enableMail
Deaktiviert vollständig alle E-Mail-Versandfunktionen in XenForo. Es werden überhaupt keine E-Mails versendet, niemals.

enableMailQueue
Deaktiviert das E-Mail-Warteschlangensystem. Alle in der Warteschlange verbliebenen E-Mails werden nicht versendet, und jede neue E-Mail wird sofort nach ihrer Erstellung versendet, anstatt in einer Warteschlange für das Versenden in einem Stapel gespeichert zu werden.

enableListeners
Deaktiviert alle Code-Event-Listener in XenForo. Dies schaltet weitgehend alle Add-on-Funktionen aus und kann nützlich sein, um den Zugriff auf das System und das Kontrollpanel wiederherzustellen, wenn ein Add-on defekt ist und die Möglichkeit dazu unterbrochen hat.

enableTemplateModificationCallbacks
Deaktiviert die Möglichkeit, dass Änderungen an Templates über einen PHP-Callback ausgeführt werden. Ähnlich wie enableListeners kann dieser Schalter verwendet werden, um den Zugriff auf ein System wiederherzustellen, das durch einen defekten Callback unbrauchbar gemacht wurde.

enableGzip
Standardmäßig komprimiert XenForo die endgültige HTML- und CSS-Ausgabe von Seiten, die es mit dem gzip-Komprimierungssystem erzeugt, das dann von den Browsern Ihrer Besucher unsichtbar dekomprimiert wird, wenn die Daten empfangen werden. Dies kann die Ladezeiten von Seiten erheblich beschleunigen. Wenn du diese Funktion jedoch deaktivieren und die HTML- und CSS-Daten als unkomprimierten reinen Text senden möchtest, deaktiviere diese Einstellung.

enableContentLength
Normalerweise sendet XenForo einen Content-Length HTTP-Header. In einigen Serverkonfigurationen kann der Inhalt zwischen dem Senden durch XenForo und dem Empfang durch den Endbenutzer geändert werden. In dieser Situation wird der Content-Length-Header möglicherweise nicht korrekt aktualisiert, weshalb er deaktiviert werden sollte.

enableTfa
Deaktiviert die Zwei-Faktor-Authentifizierung (2FA), das System, bei dem sich Benutzer mit einem Benutzernamen und einem Passwort sowie einer zusätzlichen Information, z.B. einem Code von ihrem Telefon, anmelden müssen. Nützlich, wenn du den Zugang zu deinem Admin-Kontrollpanel verloren hast oder wenn du verhindern willst, dass Benutzer überhaupt 2FA verwenden.

enableLivePayments
Wenn diese Funktion deaktiviert ist, werden überhaupt keine Zahlungen verarbeitet. Die Zahlungsanbieter werden nicht kontaktiert und es werden keine Transaktionen versucht. Nützlich für den Betrieb einer Testseite mit einer Kopie einer Live-Datenbank.

enableClickjackingProtection
Normalerweise sendet XenForo den HTTP-Header X-Frame-Options mit dem Wert SAMEORIGIN, um Click-Jacking durch bösartige Skripts zu verhindern.
Wenn diese Einstellung aktiviert ist, verhindert sie Clickjacking-Angriffe, bei denen dein Forum in einen iFrame eingebettet wird und der Benutzer dazu verleitet wird, etwas anzuklicken. Dies kann jedoch auch gültige Verwendungen der iFrame-Einbettung deaktivieren. Deaktiviere die Funktion nur, wenn du dir über die Auswirkungen im Klaren bist.

enableReverseTabnabbingProtection
Wenn diese Funktion aktiviert ist, verhindert sie auf Reverse Tabnabbing basierende Phishing-Angriffe, die ausgelöst werden, wenn die Benutzer auf Links zu externen Websites klicken. Dieser Schutz kann jedoch externe Dienste beeinträchtigen, die darauf angewiesen sind, die Verarbeitung von Linkklicks zu ändern (z. B. um Affiliate-Links einzubeziehen). Deaktiviere die Funktion nur, wenn du dir über die Auswirkungen im Klaren bist.

enableApi (2.1+)
Deaktiviert den Zugriff auf die REST-API, die normalerweise über <url>/api/ zugänglich ist.

enableAddOnArchiveInstaller (2.1+)
Dies steuert den Zugriff auf das auf dem Kontrollpanel basierende Add-on-Installations-/Upgrade-System. Wenn es aktiviert ist, kann ein Administrator mit den erforderlichen Berechtigungen eine Zip-Datei mit einem XenForo-Add-on hochladen und es automatisch installieren oder aktualisieren.
Diese Einstellung ist aus Sicherheitsgründen standardmäßig deaktiviert.

enableOneClickUpgrade (2.1+)
Deaktiviert den Zugriff auf das Ein-Klick-Upgrade-System von XenForo im Kontrollpanel.

 

[McAtze]

Volle Unicode-/Emoji-Unterstützung​

$config['fullUnicode'] = false;

Diese Einstellung teilt XenForo mit, ob du die notwendigen Schritte durchgeführt hast, um vollen Unicode in deinem Foreninhalt zu unterstützen. Vollständiger Unicode wird benutzt, um die Verwendung von Emoji im Text zu unterstützen.

Wenn deine XenForo-Installation mit Version 2 begonnen hat und nicht von XenForo 1 aktualisiert wurde, ist deine Datenbank bereits im vollständigen Unicode-Format und du kannst diese Einstellung zusammen mit einem wahren Wert in deiner config.php-Datei platzieren.

Wenn deine XenForo-Installation von XenForo 1 aktualisiert wurde, musst du den Unicode-Konvertierungsprozess ausführen, bevor du vollen Unicode verwenden kannst, und diese Einstellung sollte bis dahin auf false belassen werden.

Die vollständige Unicode-Unterstützung erfordert mindestens MySQL 5.5.

Upgrade auf vollständigen Unicode für Emoji-Unterstützung

 

[McAtze]

Speicherorte von Daten und Skripten​

Wenn du den Ort ändern möchtest, an dem XenForo die Daten und Skripte, die es in Dateien speichert, wie Avatare, Anhänge und Javascript-Dateien, kannst du diese Einstellungen ändern.

• $config['externalDataPath'] = 'data';
• $config['externalDataUrl'] = 'data';
• $config['internalDataPath'] = 'internal_data';
• $config['codeCachePath'] = '%s/code_cache';
• $config['tempDataPath'] = '%s/temp';
• $config['javaScriptUrl'] = 'js';

Pfadvariablen
In jedem dieser Fälle bezieht sich ein Variablenname, der mit Path endet, auf einen internen Dateisystempfad auf dem Server, relativ zu dem Verzeichnis, in dem XenForo installiert ist. Relative Pfade beginnen mit dem XenForo-Installationsverzeichnis. Dieses kann außerhalb des Web-Root-Verzeichnisses festgelegt werden.

Wenn sich deine XenForo-Installation unter /users/yourname/htdocs/xenforo befindet, dann zeigen die folgenden Beispiele, wie sich verschiedene Werte auf diesen Pfad beziehen:

• data - /users/yourname/htdocs/xenforo/data
• ../another-folder - /users/yourname/htdocs/another-folder

Diese Variablen können auch einen absoluten Pfad vom Stammverzeichnis des Servers verwenden, z.B. /users/yourname/htdocs/xenforo/data.

URL-Variablen
Variablen, deren Name mit Url enden, beziehen sich auf einen Pfad relativ zu deinem XenForo-Verzeichnis, wie es von deinem Web-Root aus sichtbar ist. Relative URLs beginnen bei dem XenForo-Installationsverzeichnis. Wenn sich deine XenForo-Installation unter https://example.com/xenforo befindet, zeigen die folgenden Beispiele, wie die verschiedenen Werte ausgewertet werden:

• data - http://example.com/xenforo/data
• ../another-folder - http://example.com/another-folder
• /a-root-folder - http://example.com/a-root-folder
• /xenforo/my-folder - http://example.com/xenforo/my-folder

Du kannst eine vollständige URL verwenden, einschließlich des Domänennamens, z.B:

• http://example.com/xenforo/data
• //example.com/xenforo/data

Als Pfade angegebene Verzeichnisse müssen vom Webserver beschreibbar sein (chmod 777), sonst kann XenForo keine Daten an diesen Orten speichern.
Wenn einer dieser Pfade und URLs falsch eingestellt sind, werden wichtige XenForo-Funktionen unterbrochen. Ändere sie nur, wenn du genau weißt, was du tust.

externalDataPath
Dies definiert den Pfad zum data-Verzeichnis, in dem XenForo Dateien speichert, die direkt über den Webserver an den Browser gesendet werden, wie z.B. Avatar-Bilder und Anhang-Miniaturansichten. Dieses Verzeichnis muss sich im Web-Root befinden.

externalDataUrl
Legt den Speicherort des data-Verzeichnisses fest, in dem XenForo Avatare und Anhang-Miniaturansichten speichert, die von deinem Webserver aus sichtbar sind.

internalDataPath
Legt den Pfad zum Verzeichnis internal_data fest, das Dateien enthält, die nicht direkt an Webbrowser-Clients geliefert werden, wie z.B. Anhänge.

codeCachePath
Legt den Speicherort des Verzeichnisses code_cache fest, in dem zwischengespeicherte Versionen von PHP-Dateien gespeichert werden, um die Ausführung von XenForo zu beschleunigen. Dies befindet sich normalerweise im Verzeichnis internal_data.

tempDataPath
Legt den Pfad zu dem Verzeichnis fest, in dem temporäre Dateien gespeichert werden, z.B. Anhänge, die gerade hochgeladen wurden und noch verarbeitet werden, bevor sie an ihrem endgültigen Speicherort abgelegt werden. Dieses Verzeichnis befindet sich normalerweise im Verzeichnis internal_data.

javaScriptUrl
Legt den Speicherort des js-Ordners, in dem XenForo die für seine Funktionalität erforderlichen JavaScript-Dateien erwartet, als Pfad auf dem öffentlichen Webserver fest. Dieses Verzeichnis muss sich innerhalb des Web-Root befinden.

 

[McAtze]

Datenbank-Adapter​

• $config['db']['adapterClass'] = 'XF\Db\Mysqli\Adapter';

Der Name der PHP-Klasse, die für die Verbindung zu deiner Datenbank verwendet wird. Wenn du einen MySQL-Server verwendest, gibt es wenig Grund, diese Einstellung zu ändern.

HTTP-Client-Einstellungen​

Diese Einstellungen steuern das Verhalten des internen XenForo-HTTP-Clients, der zum Abrufen von Ressourcen aus dem Internet verwendet wird, wie z. B. Bilder und Webseiten bei Verwendung des Bild- und Link-Proxys.

• $config['http']['sslVerify'] = null;
• $config['http']['proxy'] = null;

Mit der Einstellung sslVerify wird das System gezwungen, das SSL-Zertifikat aller Websites zu überprüfen, die es bei der Anforderung von Ressourcen über SSL/HTTPS besucht. Die Einstellung dieses Wertes auf true kann unter bestimmten Umständen von Vorteil sein, aber es gibt eine Reihe von Möglichkeiten, wie die SSL-Zertifikatsüberprüfung fehlschlagen kann, was dazu führt, dass die angeforderte Ressource nicht abgerufen werden kann. Im Zweifelsfall solltest du diese Einstellung unverändert lassen.

Wenn du möchtest, dass der interne XenForo-HTTP-Client seine Anfragen über einen Proxy ausführt, gib die Adresse des Proxy-Servers in der Proxy-Einstellung ein.

Andere Variablen​

• $config['globalSalt'] = '<unique value>';

Diese Variable definiert einen geheimen Wert, der zum Verschlüsseln der Werte verschiedener Caches, Cookies und anderer Daten verwendet wird, um zu verhindern, dass die Daten von schädlichen Programmen gestohlen oder gefälscht werden. Gib den globalen Salt-Wert niemals an Dritte weiter, da dies die Sicherheit deiner XenForo-Installation gefährden würde.​

Normalerweise generiert XenForo sein eigenes sicheres globales Passwort, und du brauchst es nur zu ändern, wenn du dein eigenes definieren willst.​

• $config['checkVersion'] = true;

Wenn aktiviert, prüft das System, ob die in den XenForo-PHP-Skripten gespeicherte Versionsnummer mit der in der XenForo-Datenbank gespeicherten Versionsnummer übereinstimmt, und verhindert den Zugriff auf die Foren durch reguläre Besucher, wenn die Nummern nicht übereinstimmen, wie es der Fall wäre, wenn du die Dateien gerade hochgeladen hast, um ein Upgrade durchzuführen, aber den Upgrade-Prozess noch nicht durchgeführt hast.​

• $config['passwordIterations'] = 10;

Konfiguriert die Stärke des bcrypt-basierten Passwortspeichersystems. Höhere Zahlen sind sicherer, aber jede Erhöhung des Wertes dieser Einstellung verdoppelt ungefähr die Zeit, die für die Generierung oder Validierung eines Passworts benötigt wird, was zu einer höheren Serverauslastung führt.​

• $config['maxImageResizePixelCount'] = 20000000;

Die maximale Größe eines Bildes (in der Gesamtzahl der Pixel), die XenForo versuchen wird, die Größe zu ändern. Bilder, die größer als dieser Wert sind, werden einfach nicht angepasst und können daher abgelehnt werden. Dies wird mit Breite × Höhe berechnet.​

• $config['adminLogLength'] = 60;

Die Anzahl der Tage, die das Protokoll aller Administratoraktivitäten im Admin-Kontrollzentrum aufbewahrt wird. Nachdem diese Anzahl von Tagen seit der Protokollierung einer Aktion verstrichen ist, wird sie aus der Datenbank gelöscht.​

• $config['chmodWritableValue'] = 0;

Wenn dieser Wert ungleich Null ist, werden alle von XenForo erstellten Dateien automatisch auf diesen Wert geändert (chmodded). Verzeichnisse werden ebenfalls mit diesem Wert chmodifiziert, obwohl sie auch immer für Benutzer, Gruppen und Global ausführbar sind. In den meisten Situationen ermittelt XenForo den richtigen chmod-Wert automatisch.​

• $config['proxyUrlFormat'] = 'proxy.php?{type}={url}&hash={hash}';

Legt das Format für Links fest, die den Bild- und Link-Proxy verwenden.​

Das Format muss die Token {type}, {url} und {hash} enthalten und auf proxy.php verweisen, es sei denn, du hast ein alternatives Skript oder System zur Bearbeitung der Proxy-Anfragen.​

• $config['jobMaxRunTime'] = 8;

Legt die Zeitspanne in Sekunden fest, die Verarbeitungsaufträge laufen dürfen, bevor sie für die weitere Verarbeitung in einem weiteren Durchgang ausgesetzt werden, falls möglich.​

• $config['fsAdapters'] = [];

Legt eine Liste von Dateisystemadaptern fest, die für das System verfügbar sind und verwendet werden können. Dies ist eine erweiterte Power-User-Funktion, die zu einem späteren Zeitpunkt ausführlich dokumentiert wird.​

 

[McAtze]

Cache-Einstellungen​

Für große XenForo-Seiten kann es von Vorteil sein, einen Cache-Mechanismus zu verwenden, um die Seitengenerierung zu beschleunigen.

Die Einstellungen für die Zwischenspeicherung fallen alle in den Abschnitt $config['cache'] und werden im Abschnitt Cache dieses Handbuchs ausführlicher behandelt.

Wenn du einen Cache konfigurierst, kannst du ihn jederzeit deaktivieren, indem du den Wert dieser Option auf false setzt:

• $config['cache']['enabled'] = false;

Einstellungen für den Cache...

Cache-Einstellungen auf Seitenebene​

Wenn ein Cache-Mechanismus konfiguriert wurde, ist es möglich, ganze Seiten für Gastbenutzer mit dem pageCache zwischenzuspeichern. Dieses äußerst leistungsfähige System kann große Mengen an Cache-Ressourcen verbrauchen, weshalb es standardmäßig deaktiviert ist, bis ihm Ressourcen zugewiesen werden. Alle Details und Optionen sind im Abschnitt Cache-Unterstützung > Caching von Gastseiten im Handbuch beschrieben.

• $config['pageCache']['enabled'] = false;

 

[McAtze]

Für Entwickler und Designer​

Debug-Modus​

Der Debug-Modus ist ein spezieller Zustand, in dem XenForo zu Debugging- oder Entwicklungszwecken ausgeführt wird.

• $config['debug'] = false;

Die Einstellung true ist erforderlich, damit bestimmte Funktionen wie der Designer-Modus und der Entwickler-Modus funktionieren.

Aktivieren Sie niemals den Debug-Modus auf einer Live-Produktionsseite, die dem Internet zugänglich ist.

Die Ausführung und die Seitengenerierung laufen nicht nur deutlich langsamer als bei deaktiviertem Debug-Modus, sondern es können auch wichtige Informationen wie der Status interner SQL-Abfragen für Besucher sichtbar werden. Aktiviere den Debug-Modus nur, wenn du an einer privaten XenForo-Installation arbeitest, die vor möglichen böswilligen Besuchern geschützt ist.

​

Designer-Modus​

Der Designermodus ist eine fortgeschrittene Funktion für XenForo-Designer, mit der Templates direkt im Dateisystem bearbeitet werden können, anstatt den Template-Editor im Admin-Kontrollfeld zu verwenden.

• $config['designer']['enabled'] = false;
• $config['designer']['basePath'] = 'src' . \DIRECTORY_SEPARATOR . 'styles';

Die Einstellung enabled schaltet den Designermodus ein und aus, und der Wert basePath steuert den Ort, an dem XenForo die Template-Dateien usw., mit denen der Designer arbeitet, erwartet.

Eine ausführlichere Diskussion über den Designer-Modus befindet sich in der XenForo 2 Entwicklerdokumentation.

Entwickler-Modus​

Der Entwickler-Modus ist eine weitere erweiterte Funktion, diesmal für Entwickler von XenForo-Add-ons.

• $config['development']['enabled'] = false;
• $config['development']['defaultAddOn'] = '';

Die Einstellung enabled schaltet den Entwicklermodus ein und aus. Mit der Einstellung defaultAddOn kann die ID eines Add-ons angegeben werden, wodurch die Add-on-Einstellung für neu erstelltes Material im Admin-Kontrollfeld automatisch auf das von dir angegebene Add-on gesetzt wird.

• $config['development']['skipAddOns] = null;

Um diese Einstellung zu verwenden, setze den Wert auf ein Array von Add-On-IDs, wie z.B. ['addOn1', 'addOn2']. Alle im skipAddOns-Array angegebenen Add-ons werden bei der Ausführung von Entwicklungswerkzeugen wie dem Import und Export von Stammdaten übersprungen.

• $config['development']['throwJobErrors'] = null;

Wenn diese Einstellung auf true gesetzt ist, werden alle Fehler, die normalerweise bei der Ausführung von Entwicklungswerkzeugen wie dem Add-on-Build-Skript unterdrückt werden, ausgelöst und angezeigt, wodurch der Auftragsprozess unterbrochen wird. Dies kann beim Debuggen von Problemen mit der Ausgabe von Development-Jobs nützlich sein.

• $config['development']['fullJs'] = false;

Steuert, ob das System mit den standardmäßigen minimierten und reduzierten JavaScript-Bibliotheken ausgeführt werden soll, wie in der Standardkonfiguration von XenForo, oder ob es stattdessen die vollständigen JavaScript-Dateien verwenden soll.

Wenn der Wert auf true gesetzt wird, fordert XenForo die vollständigen Javascript-Dateien an. Die resultierende Funktionalität ist dieselbe, aber die vollständigen, nicht minimierten Dateien sind beim Debuggen von Problemen, die bei der Entwicklung Ihrer Add-ons auftreten können, einfacher zu durchsuchen.

Die Verwendung der vollständigen Javascript-Dateien führt dazu, dass die Webseite mehr HTTP-Anfragen generiert und mehr Bandbreite verbraucht, was zu einem langsameren Erlebnis für die Besucher führt. Daher empfehlen wir nicht, fullJs auf produktiven Webseiten zu verwenden.

Eine vollständige Erklärung des Entwickler-Modus findet sich in der XenForo 2 Entwickler-Dokumentation.