deploy: documenter le workflow d'installation fraîche

- Ajoute .env.example avec toutes les variables requises (DB_DSN, OIDC_*,
  SMTP_*, SESSION_NAME, ADMIN_EMAIL…) — DB_DSN était absent et cassait
  database/migrate.php au premier déploiement.
- Clarifie migrate-init.php : réservé aux serveurs existants antérieurs au
  système de migrations ; pour une installation fraîche, migrate.php suffit
  (applique tout depuis migration_000).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-14 08:47:29 +02:00
parent 8a85c15372
commit 2c8e31baff
2 changed files with 61 additions and 3 deletions
+41
View File
@@ -0,0 +1,41 @@
# Folio — variables d'environnement requises
# Copier ce fichier en .env dans le répertoire racine du site et remplir les valeurs.
# Ce fichier est versionné. Le .env ne l'est pas.
# Application
APP_URL=https://example.com
APP_ENV=prod
APP_DEBUG=0
# Authentification admin (email de l'administrateur principal)
ADMIN_EMAIL=
# Nom du cookie de session (doit être unique par site)
SESSION_NAME=SID_SITE
# SSO OIDC
OIDC_ISSUER=https://idp.example.com/realms/myrealm
OIDC_CLIENT_ID=
OIDC_CLIENT_SECRET=
# OIDC_REDIRECT_URI= (optionnel, défaut : APP_URL + oidc/callback)
# PostgreSQL — DB_DSN est requis par database/migrate.php
DB_DSN=pgsql:host=127.0.0.1;port=5432;dbname=mydb
DB_HOST=127.0.0.1
DB_PORT=5432
DB_NAME=mydb
DB_USER=myuser
DB_PASS=
# SMTP (commentaires, formulaire de contact)
SMTP_HOST=
SMTP_PORT=587
SMTP_SECURE=tls
SMTP_USER=
SMTP_PASS=
SMTP_FROM=
SMTP_FROM_NAME=
# Formulaire de contact
CONTACT_EMAIL=
CONTACT_FROM_EMAIL=