Depannage

Depannage

Cette page regroupe les problemes les plus frequents et leur solution.

Page blanche ou erreur 500

• Verifiez que APP_KEY est bien renseigne dans .env (sinon lancez php artisan key:generate).
• Verifiez les permissions d'ecriture sur storage/ et bootstrap/cache/ (le serveur web doit pouvoir y ecrire).
• Consultez le detail de l'erreur dans storage/logs/laravel.log.
• En local uniquement, mettez temporairement APP_DEBUG=true dans .env pour voir le message d'erreur complet dans le navigateur. Ne faites jamais cela en production, cela peut exposer des informations sensibles.

Erreur "419 Page Expired" en soumettant un formulaire

• Le jeton CSRF a expire (session trop ancienne) ou APP_URL ne correspond pas a l'URL reellement utilisee pour acceder au site. Verifiez que APP_URL dans .env correspond exactement au domaine utilise, y compris le protocole (http ou https).
• Videz les cookies du site et reessayez.

Les avatars ou emotes ne s'affichent pas apres upload

• Le lien symbolique de stockage est probablement manquant. Lancez :

php artisan storage:link

• Verifiez que le dossier storage/app/public est accessible en lecture par le serveur web.
• Si vous utilisez Nginx et que l'upload d'une image echoue silencieusement, verifiez client_max_body_size dans la configuration du server block (voir Production Nginx).

Les emails ne partent pas

• Par defaut, MAIL_MAILER=log : les emails sont ecrits dans storage/logs/laravel.log au lieu d'etre envoyes. C'est le comportement normal en local.
• En production, configurez un vrai transport SMTP dans .env (voir la page Configuration) et verifiez les identifiants aupres de votre fournisseur.

Les modifications de code ou de style ne s'affichent pas

• Apres une modification des fichiers Blade, CSS ou JavaScript en production, recompilez les assets avec npm run build, puis videz les caches Laravel :

php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

• En developpement, utilisez npm run dev pour beneficier du rechargement a chaud, et evitez de laisser les caches de configuration/route actifs (php artisan optimize:clear si besoin).

Erreur de connexion a la base de donnees

• Verifiez DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD dans .env.
• Verifiez que le service MySQL/MariaDB est bien demarre : sudo systemctl status mysql.
• Verifiez que l'utilisateur MySQL dispose bien des droits sur la base (GRANT ALL PRIVILEGES ON forum.* TO ...).

Les tests automatises echouent

• Assurez-vous d'avoir installe les dependances de developpement (composer install, sans l'option --no-dev).
• Verifiez que la base de donnees de test est correctement configuree (voir phpunit.xml et la configuration .env.testing si presente).

Si un probleme persiste, verifiez storage/logs/laravel.log ainsi que les journaux du serveur web (/var/log/apache2/ ou /var/log/nginx/ en production), qui contiennent generalement la cause exacte de l'erreur.