Umgebungsvariablen #

Diese Seite richtet sich an Entwickler, die ein DXP-Projekt konfigurieren. Ein Symfony-Projekt liest seine Einstellungen aus Umgebungsvariablen; das Skeleton hält Standardwerte in .env und die Werte Ihres Hosts in .env.local. Alle Variablen unten sind die, die die Anleitung des Skeletons (Abschnitt 4) dokumentiert.

Inhalt #

1. Die Dateien und die Regel
2. Anwendung
3. Datenbank
4. JWT
5. Suche, Cache, E-Mail und der Rest
6. Eine Referenz ohne Geheimnisse aufbewahren
7. Prüfen, was Symfony sieht

Die Dateien und die Regel #

Echte Umgebungsvariablen, die der Webserver oder der Prozessmanager setzt, setzen sich gegen die Dateien durch.

Anwendung #

APP_ENV=prod                  # or dev
APP_SECRET=<32 random hex characters>

APP_DEBUG und APP_HTTP_CACHE werden in den Beispielen der Anleitung in der Konfiguration des Webservers gesetzt (Webserver einrichten).

Datenbank #

MySQL oder MariaDB aus Teilen:

DATABASE_DRIVER=pdo_mysql
DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_NAME=your_db_name
DATABASE_USER=your_db_user
DATABASE_PASSWORD=your_db_password
DATABASE_CHARSET=utf8mb4
DATABASE_COLLATION=utf8mb4_unicode_520_ci
DATABASE_VERSION=mariadb-10.6.0    # or 8.0 for MySQL

PostgreSQL verwendet DATABASE_DRIVER=pdo_pgsql, Port 5432, DATABASE_CHARSET=utf8 und DATABASE_VERSION=16. Ein vollständiger DSN in DATABASE_URL ersetzt die Teile. SQLite verwendet nur den DSN und einen synchronen Messenger-Transport:

DATABASE_URL="sqlite:///%kernel.project_dir%/var/data_%kernel.environment%.db"
MESSENGER_TRANSPORT_DSN=sync://

Details: Datenbanken, SQLite für die Entwicklung.

JWT #

JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
JWT_PASSPHRASE=<64 random hex characters>

Die Schlüsseldateien werden je Installation erzeugt und nie committet (JWT-Authentifizierung).

Suche, Cache, E-Mail und der Rest #

Für Test-E-Mails in der Entwicklung behalten Sie MAILER_DSN=null://null bei und verwenden für Testbenutzer Adressen unter example.invalid, damit keine E-Mail eine echte Person erreicht.

Eine Referenz ohne Geheimnisse aufbewahren #

cp .env.local .env.local.dist
$EDITOR .env.local.dist          # replace every password, secret and passphrase with a placeholder
git add .env.local.dist

Lesen Sie die Datei noch einmal, bevor Sie sie committen.

Prüfen, was Symfony sieht #

php bin/console debug:dotenv               # which files were loaded and the values they set
php bin/console debug:container --env-vars # environment variables used by the container

Verwandte Seiten #

• Installation mit dem Skeleton
• Bereitstellen
• DXP-Skeleton
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.