Installation - Documentation Board+

Cette section vous guide à travers l'installation complète de Board+ sur votre serveur ou environnement local.

Prérequis système

Assurez-vous que votre système répond aux exigences suivantes avant de procéder à l'installation.

Configuration minimale

PHP: 8.1 ou supérieur
Base de données: MySQL 5.7+ / PostgreSQL / SQLite
Web Server: Apache/Nginx avec mod_rewrite
RAM: 512 MB minimum
Disque: 1 GB d'espace libre

Extensions PHP requises

BCMath
Ctype
Fileinfo
JSON
Mbstring
OpenSSL
PDO
Tokenizer
XML

Méthode d'installation 1: Via Composer (Recommandé)

Étape 1: Téléchargement et installation des dépendances

# Cloner le repository
git clone https://github.com/votre-repo/board-plus.git
cd board-plus

# Installer les dépendances PHP
composer install --no-dev --optimize-autoloader

# Installer les dépendances JavaScript
npm install && npm run build

Étape 2: Configuration de l'environnement

# Copier le fichier d'environnement
cp .env.example .env

# Générer la clé d'application
php artisan key:generate

Étape 3: Configuration de la base de données

Modifiez le fichier .env pour configurer votre base de données :

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=board_plus
DB_USERNAME=votre_utilisateur
DB_PASSWORD=votre_mot_de_passe

Étape 4: Migration de la base de données

# Exécuter les migrations
php artisan migrate --seed

# Créer le lien symbolique pour le stockage
php artisan storage:link

Étape 5: Configuration des permissions

# Définir les permissions appropriées
chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Méthode d'installation 2: Via Docker

Si vous préférez utiliser Docker, un fichier Docker Compose est fourni :

# Lancer les conteneurs
docker-compose up -d

# Exécuter les migrations dans le conteneur
docker-compose exec app php artisan migrate --seed

Configuration du serveur web

Apache

Assurez-vous que le module mod_rewrite est activé et que votre configuration pointe vers le dossier public :


    ServerName votre-domaine.com
    DocumentRoot /chemin/vers/board-plus/public

    
        AllowOverride All
        Require all granted

Nginx

server {
    listen 80;
    server_name votre-domaine.com;
    root /chemin/vers/board-plus/public;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

Vérification de l'installation

Après l'installation, vérifiez que tout fonctionne correctement :

# Vérifier la santé de l'application
curl http://votre-domaine.com/health

# Vérifier les permissions
ls -la storage/
ls -la bootstrap/cache/

Installation terminée ! Vous pouvez maintenant accéder à Board+ via votre navigateur. La première fois, vous serez redirigé vers la page d'inscription pour créer le compte administrateur.

Documentation

Installation de Board+