Die OpenRat-Konfiguration
Die Konfiguration wurde in Version 2 überarbeitet und erfolgt seitdem über die Datei config/config.yml, die im YAML-Format abgelegt ist.
Nachladen weiterer Dateien
Die Datei kann bei include-Anweisungen andere Konfigurationsdateien nachladen.
Umgebungsvariablen
Über Variablen $ in den Werten können Umgebungsvariablen eingebunden werden.
Datenbankparameter
Die Datenbankparameter müssen zwingend eingetragen werden.
- enabled
- Muss auf "true" gesetzt sein, damit die Datenbankverbindung aktiv wird.
- comment
- Bezeichnung für diese Verbindung, wird in der Anmeldemaske angezeigt, sofern mehr als 1 Verbindung konfiguriert.
- dsn
- Muss einer PDO-DSN sein
- user
- Benutzername in der Datenbank
- password
- Kennwort für die Datenbank
- base64
- Wenn true, werden Binärdateien in der Datenbank BASE64-codiert gespeichert. Wenn BLOB-Spalten möglich, dann auf "false" setzen. In PostgreSQL 7 sollte dies auf "true" setzen. Vorsicht, eine Änderung verhindert den Zugriff auf bereits gespeicherte Binärdateien!
- database
- Logischer Name der Datenbank
- prefix
- Präfix für die Tabellen. Ein anderer Wert als "or_" bedingt das Unbenennen der Tabellen. Durch diese Einstellung sind mehrere OpenRat-Instanzen pro logischer Datenbank möglich
- persistent
- Persistente Verbindung ermöglichen. Nur auf "false" setzen, wenn es Probleme mit der Verbindung gibt.
- charset
- Der Zeichensatz, der für die Datenbanktabellen eingestellt ist (optional)
- connection_sql
- Ein SQL-Statement, welches direkt nach Aufbau der Verbindung ausgeführt wird. Dies können treiberspezifische Kommandos sein
- cmd
- Hier kann ein Systembefehl eingetragen werden, der vor Aufbau der Datenbankverbindung ausgeführt wird. Dies kann zum Beispiel ein Skript sein, welches einen SSH-Tunnel zum Datenbankserver aufbaut. Das Skript sollte nichts auf die Standardausgabe schreiben. (optional)
- prepare
- Wenn die Datenbank und der Datenbank-Treiber mit vorbereiteten Statements umgehen kann, sollte hier "true" ausgewählt werden. Bei Problemen bitte "false" verwenden. (optional, Voreinstellung: false)
- transaction
- Einstellung, ob auf der Datenbank Transaktionen verwendet werden sollen. Dies wird empfohlen, da die Datensicherheit so erhöht werden kann. Nicht alle Datenbanktreiber und -tabellen unterstützen Transaktionen. Falls "true", öffnet OpenRat pro Request eine Transaktion. Eine Benutzeraktion wird dann etweder ganz oder garnicht ausgeführt. Achtung, Ggf. muss mit der Einstellung 'connection_sql' ein Autocommit deaktiviert werden. (Empfohlen: "true").
- readonly
- Wenn in der Datenbank nur gelesen werden soll, so wird hier "true" eingetragen. Das CMS führt dann keine Schreibzugriffe aus und öffnet auch keine Schreib-Dialoge. (Voreinstellung: false)
FAQ
Meine Änderungen werden nicht übernommen!
Ein Einlesen der Konfiguration erfolgt nur bei der Benutzeranmeldung. Nach einen Klick auf "Abmelden" wird die Sitzung beendet und die neuen Einstellungen werden geladen.