Installation locale

Installation locale

Ce guide explique comment installer Forum PHP sur votre machine de developpement. Verifiez d'abord la page Prerequis.

1. Recuperer le projet

git clone https://github.com/Cut0x/forum-php.git
cd forum-php

2. Installer les dependances

composer install
npm install

3. Configurer l'environnement

Copiez le fichier d'exemple puis generez la cle d'application :

cp .env.example .env
php artisan key:generate

Ouvrez .env et renseignez au minimum :

• APP_URL : l'URL sous laquelle vous accederez au site en local (par exemple http://localhost:8000 si vous utilisez php artisan serve, ou http://forum.local si vous utilisez un vhost Apache local, voir plus bas).
• DB_DATABASE, DB_USERNAME, DB_PASSWORD : vos identifiants MySQL.

4. Creer la base de donnees

mysql -u root -e "CREATE DATABASE forum CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

Adaptez la commande si votre utilisateur MySQL necessite un mot de passe.

5. Migrer et peupler la base

php artisan migrate --seed
php artisan storage:link

Le seeder par defaut cree les categories, les badges et les reglages de base du site, sans contenu de demonstration.

Pour peupler le forum avec des utilisateurs, sujets et messages factices (utile pour tester l'interface) :

php artisan db:seed --class=DemoContentSeeder

6. Compiler les assets front-end

npm run build

Pendant le developpement, vous pouvez utiliser le mode watch avec rechargement a chaud :

npm run dev

7. Lancer le serveur

L'option la plus simple pour du developpement local est le serveur integre de PHP :

php artisan serve

Le site est alors accessible sur http://127.0.0.1:8000.

Si vous preferez utiliser Apache via XAMPP en local, configurez un vhost dedie pointant vers le dossier public/ du projet. Ne faites jamais pointer un vhost directement sur la racine du projet, uniquement sur public/. Exemple :

<VirtualHost *:80>
    ServerName forum.local
    DocumentRoot "C:/chemin/vers/forum-php/public"

    <Directory "C:/chemin/vers/forum-php/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Ajoutez ensuite 127.0.0.1 forum.local a votre fichier hosts, et reglez APP_URL=http://forum.local dans .env.

8. Creer un compte administrateur

Voir la page dediee : Compte administrateur.

9. Verifier que tout fonctionne

Lancez la suite de tests automatises :

php artisan test

Vous pouvez ensuite ouvrir le site dans votre navigateur, creer un compte, publier un sujet, et verifier l'acces au panel admin une fois votre compte promu administrateur.

Pour la suite : Configuration pour ajuster les reglages du site, ou directement un guide de mise en production si vous deployez le projet : Apache ou Nginx.