Variables d'environnement

Application, Serveur & Base de données

Application

Variable	Défaut	Description
`DEBUG`	`false`	Interrupteur global dev/prod — lu une seule fois au démarrage via `LazyLock`. Active : niveau de log `debug`, pages d'erreur détaillées, hot reload templates admin. En production (`false`) : niveau `warn`, erreurs génériques.
`BASE_DIR`	`.`	Répertoire racine de l'application
`TZ`	`UTC`	Fuseau horaire IANA de l'application (ex : `Europe/Paris`, `America/New_York`). Accessible via `config.timezone` — à parser avec `chrono-tz` dans le projet.
`LANG`	locale système	Langue de la CLI (`fr`, `en`, `de`, `es`, `it`, `pt`, `ja`, `zh`, `ru`). Priorité : `.env` > locale système (`LC_ALL`, `LC_MESSAGES`) > `en`

Serveur

Variable	Défaut	Description
`IP_SERVER`	`127.0.0.1`	Adresse IP d'écoute
`PORT`	`3000`	Port d'écoute
`SECRET_KEY`	`default_secret_key`	Clé secrète (CSRF, signatures) — à changer en production

Base de données

Connexion

Variable	Défaut	Description
`DATABASE_URL`	—	URL complète (prioritaire sur toutes les variables composantes)
`DB_ENGINE`	`sqlite`	Moteur : `postgres`, `mysql`, `mariadb`, `sqlite`
`DB_USER`	—	Utilisateur (requis sauf SQLite)
`DB_PASSWORD`	—	Mot de passe (requis sauf SQLite)
`DB_HOST`	`localhost`	Host
`DB_PORT`	`5432` / `3306`	Port (défaut selon le moteur)
`DB_NAME`	`local_base.sqlite`	Nom de la base de données

Pool de connexions

Variable	Défaut	Description
`DB_MAX_CONNECTIONS`	`100`	Taille maximale du pool
`DB_MIN_CONNECTIONS`	`20`	Taille minimale du pool

Timeouts

Variable	Défaut	Unité	Description
`DB_CONNECT_TIMEOUT`	`2`	secondes	Timeout d'établissement de connexion
`DB_ACQUIRE_TIMEOUT`	`500`	millisecondes	Timeout d'acquisition depuis le pool
`DB_IDLE_TIMEOUT`	`300`	secondes	Durée d'inactivité avant fermeture
`DB_MAX_LIFETIME`	`3600`	secondes	Durée de vie maximale d'une connexion

Logging SQL

Variable	Défaut	Description
`DB_LOGGING`	`false`	Active les logs SQL (`true`, `1`, `yes`)

Connexions secondaires — `with_custom_db`

Pour attacher une connexion additionnelle (pool Redis, PostgreSQL secondaire, client MongoDB, etc.), utilisez .with_custom_db() sur le builder. La valeur est accessible dans les handlers via Extension<T> d'Axum.

// main.rs
let redis = redis::Client::open("redis://127.0.0.1/")?;

RuniqueAppBuilder::new(config)
    .with_database().await
    .with_custom_db(redis)   // T: Any + Send + Sync + 'static
    .routes(url::urlpatterns())
    .build().await?
    .run().await

// handler
use axum::Extension;
use redis::Client;

pub async fn mon_handler(
    Extension(redis): Extension<Client>,
    mut req: Request,
) -> AppResult<Response> {
    let mut conn = redis.get_async_connection().await?;
    // ...
}

Tout type implémentant Any + Send + Sync + 'static est accepté. Plusieurs connexions secondaires de types différents peuvent être enregistrées avec des appels .with_custom_db() répétés.