Betrieb
Konfiguration in der .env
Die Schlüssel der .env, ihre Vorgaben und ihre Wirkung. Die kommentierte Vorlage ist
.env.example.
Grundlagen
| Schlüssel | Bedeutung |
|---|---|
APP_ENV |
Im Betrieb production |
APP_DEBUG |
Im Betrieb false. true zeigt bei Fehlern interne Pfade und Konfigurationswerte |
APP_KEY |
Wird von key:generate gesetzt. Verlust macht verschlüsselte Sitzungen, das gespeicherte Mail-Passwort und die Zwei-Faktor-Geheimnisse unlesbar |
APP_URL |
Vollständige öffentliche Adresse mit https://, ohne Schrägstrich am Ende. Steht in allen Links in System-Mails |
APP_TIMEZONE |
Zeitzone für Anzeige und gespeicherte Zeitstempel. Standard Europe/Berlin. Nur vor dem ersten Produktivdatensatz ändern — siehe unten |
APP_NAME |
Nur Präfix für Cache-, Session- und Queue-Schlüssel — nicht der angezeigte Name |
DB_* |
Datenbank-Zugang. DB_PREFIX nur bei geteilter Datenbank und nur vor der ersten Migration setzen |
SESSION_DRIVER |
database (Standard) |
SESSION_LIFETIME |
Leerlauf in Minuten, bis eine Sitzung verfällt. Standard 120 |
SESSION_SECURE_COOKIE |
Auf einer Installation mit HTTPS true. Ohne diesen Schalter kann das Session-Cookie im Klartext übertragen werden |
SESSION_SAME_SITE |
lax (Standard) — Schutz gegen Cross-Site-Requests |
QUEUE_CONNECTION |
database (Standard). Die Aufträge arbeitet der Queue-Worker ab — siehe Cron einrichten |
MAIL_* |
Nur Ausgangswerte. Sobald unter Einstellungen → E-Mail ein Zugang gepflegt ist, hat dieser Vorrang |
LOG_LEVEL |
warning (Vorgabe in .env.example). Fehlt der Schlüssel, gilt debug |
Mehrere Domains auf derselben Installation. Zeigen weitere Domains auf diesen Server —
www.davor, eine Testdomain, die nackte IP —, funktioniert die Anwendung über jede von ihnen vollständig. Ausgegeben wird aber immer die Adresse ausAPP_URL: Die Links in System-Mails — Passwort zurücksetzen, Einladung, Adresse bestätigen — tragen sie, gleich über welche Domain die Mail ausgelöst wurde. Links und Formulare innerhalb einer geöffneten Seite bleiben auf dem Host, über den zugegriffen wird.Wer die Oberfläche angemeldet über eine andere Domain öffnet, sieht unter der Kopfzeile einen dauerhaften Hinweis, der beide Adressen nennt. Besucher öffentlicher Seiten sehen ihn nie.
Fehlt
APP_URLoder steht dort kein Schema (https://) davor, gilt der Host der Anfrage. Einstellungen → Systemdaten meldet diesen Zustand als Warnung.
Zwei
.env-Syntaxregeln, die stumm zuschlagen. Ein#in einem nicht quotierten Wert schneidet ihn ab — ausGe#heimwirdGe, ohne Fehlermeldung. Und ein Leerzeichen in einem nicht quotierten Wert ist ein Parse-Fehler, nach dem die Anwendung gar nicht mehr startet. Passwörter, Schlüssel und alles mit Sonderzeichen deshalb immer in doppelte Anführungszeichen setzen. Im Zweifel nachsehen statt annehmen:php artisan tinker --execute="var_dump(env('MAIL_PASSWORD'));"
Formrelay-eigene Schlüssel
| Schlüssel | Standard | Bedeutung |
|---|---|---|
FORMRELAY_NAME |
Formrelay |
Ausgangswert des angezeigten Namens; überschreibbar in Einstellungen → Allgemein |
FORMRELAY_UPDATE_CHECK |
true |
Ausgangswert für „Auf neue Fassungen hinweisen" (Einstellungen → Systemdaten). false, wenn diese Installation keine Verbindung nach außen aufbauen soll — die Abfrage verrät dem Anbieter IP-Adresse und Zeitpunkt |
FORMRELAY_UPDATE_SOURCE |
GitLab-API des Projekts | Woher die Release-Liste kommt. Nur ändern, wenn du eine eigene Fassung pflegst. Leer schaltet die Abfrage ab |
FORMRELAY_DNS_CHECKS |
true |
SPF- und DMARC-Hinweise zur Absenderdomain (Installer, Einstellungen → E-Mail, formrelay:mail-test). Gefragt wird der Resolver des Servers nach den TXT-Einträgen der eigenen Domain. false, wenn er nach außen nicht antwortet |
FORMRELAY_SEED_ADMIN_EMAIL, FORMRELAY_SEED_ADMIN_PASSWORD |
admin@example.com, password |
Nur für php artisan db:seed in Entwicklung und CI. Im Betrieb ohne Wirkung |
Aufbewahrungsfristen stehen nicht in der .env, sondern in der Datenbank — ein
Administrator stellt sie unter Einstellungen → Funktionen ein.
Zwei Pfade stehen nicht in der .env, sondern in config/formrelay.php: env_file und
version_file. Vorgabe ist jeweils null — die .env bzw. die Datei VERSION im
Projektverzeichnis.
Nach jeder Änderung an der .env:
php artisan config:cache
Zeitzone
Standard ist Europe/Berlin, nicht Laravels Vorgabe UTC. Für Installationen in
anderen Zonen: APP_TIMEZONE=Europe/Vienna (oder Europe/Zurich und so weiter).
Diese Entscheidung gehört an den Anfang. Zeitstempel werden in dieser Zone geschrieben und gelesen. Wird die Zone später gewechselt, verschiebt sich die Deutung aller bereits gespeicherten Werte um die Differenz der Zonen. Bei einer laufenden Installation ist das kein Konfigurations-, sondern ein Datenthema.
Quelle dieser Seite: docs/betrieb/konfiguration.md im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die
Markdown-Datei, nicht in diese Seite.