Load parent environment file automatically

2026-07-22 09:10:59 +02:00
parent 9501fdcd25
commit 9518bb8c6a
3 changed files with 93 additions and 3 deletions
@@ -45,7 +45,16 @@ APP_SECRET=<mindestens 32 zufällige Bytes>

 Das bisherige, nicht versionierte `env_vars.php` wird für eine schonende Migration weiterhin geladen. Neue Installationen sollten echte Prozess-/PHP-FPM-Umgebungsvariablen verwenden.

-Eine vollständige Vorlage ohne echte Zugangsdaten liegt in [`.env.example`](.env.example). Sie kann für das Deployment-Panel, Docker Compose (`env_file`) oder als Vorlage für die PHP-FPM-Konfiguration verwendet werden. Die Anwendung lädt `.env`-Dateien nicht selbstständig; die Deployment-Umgebung muss die Werte an den PHP-Prozess weiterreichen.
+Eine vollständige Vorlage ohne echte Zugangsdaten liegt in [`.env.example`](.env.example). Für eine klassische Installation kann sie als `.env` **einen Ordner über dem Projektverzeichnis** abgelegt werden. Diese Datei wird beim Start automatisch geladen. Bereits gesetzte Prozessvariablen und Werte aus der bisherigen `env_vars.php` haben Vorrang.
+
+Beispiel bei einem Projekt unter `/var/www/zefix`:
+
+```text
+/var/www/.env            # echte, nicht versionierte Zugangsdaten
+/var/www/zefix/app.php   # Projekt
+```
+
+Alternativ kann die Vorlage weiterhin für ein Deployment-Panel, Docker Compose (`env_file`) oder die PHP-FPM-Konfiguration verwendet werden.

 ## Optionale Konfiguration