Configuration

Configuration

Forum PHP separe deux niveaux de configuration : les variables d'environnement (.env, techniques, definies au deploiement) et les reglages du site (stockes en base de donnees, modifiables depuis le panel admin sans toucher au serveur).

1. Variables d'environnement (.env)

Application

• APP_NAME : nom de l'application, utilise comme titre par defaut.
• APP_ENV : local en developpement, production en production.
• APP_KEY : cle de chiffrement generee par php artisan key:generate. Ne jamais la partager ni la committer.
• APP_DEBUG : true en local pour voir les erreurs detaillees, false obligatoirement en production.
• APP_URL : URL publique du site. Doit correspondre exactement a l'URL utilisee (impacte les liens generes, les assets, les uploads).
• APP_LOCALE / APP_FALLBACK_LOCALE : fr par defaut, avec les fichiers de langue francais fournis dans lang/fr.

Base de donnees

• DB_CONNECTION : mysql par defaut.
• DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD : acces a votre base MySQL/MariaDB.

Session et cache

• SESSION_DRIVER : database par defaut (la table des sessions est creee par les migrations).
• CACHE_STORE : database par defaut. Les reglages du site (voir plus bas) sont mis en cache indefiniment et invalides automatiquement a chaque modification depuis l'admin.

Mail

• MAIL_MAILER : log par defaut, ce qui ecrit les emails (notifications, avertissements de moderation) dans storage/logs/laravel.log au lieu de les envoyer reellement. Pratique en local, a changer en production.
• En production, configurez un vrai transport SMTP : MAIL_MAILER=smtp, puis MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_FROM_ADDRESS, MAIL_FROM_NAME.

Stockage de fichiers

• FILESYSTEM_DISK : local par defaut. Les avatars et les emotes uploades sont stockes dans storage/app/public et exposes publiquement via le lien symbolique cree par php artisan storage:link. Ce lien doit exister aussi bien en local qu'en production.

File d'attente

• QUEUE_CONNECTION : database par defaut. A ce jour, aucune tache n'est envoyee en file d'attente par l'application (les notifications sont envoyees de maniere synchrone), donc aucun worker n'est necessaire pour le fonctionnement de base. Si vous ajoutez des jobs asynchrones a l'avenir, vous devrez lancer php artisan queue:work (par exemple via un service systemd) en plus du serveur web.

2. Reglages du site (panel admin)

Une fois connecte avec un compte administrateur, la section /admin permet de configurer, sans toucher au serveur :

• Titre et description du site.
• Texte et lien du footer.
• Lien de soutien (Stripe), activable ou non.
• Theme : couleurs du mode clair et du mode sombre, police, avec plusieurs presets predefinis et un bouton de reinitialisation.
• Categories du forum.
• Liens et categories du pied de page.
• Badges et emotes (upload d'images, normalisees automatiquement en 64x64 pixels pour les emotes).
• Roles des utilisateurs (membre, moderateur, administrateur).

Ces reglages sont stockes dans la table settings et mis en cache automatiquement. Toute modification via l'admin invalide le cache et prend effet immediatement, sans qu'il soit necessaire de redemarrer quoi que ce soit.

Pour le detail des fonctionnalites de ce panel, voir Panel Admin.

3. Langue

Le projet est fourni en francais par defaut (lang/fr), y compris les messages de validation, d'authentification et de pagination. Si vous souhaitez ajouter une autre langue, utilisez le mecanisme standard de Laravel (lang/<code>) et changez APP_LOCALE dans .env.

Voir ensuite : Compte administrateur pour creer votre premier administrateur, ou un guide de production : Apache / Nginx.