Documentation

Certains articles des la documentation sont en cours de rédaction.

Installation

La plateforme dispose d'un système d'installation automatique qui vous guide pas à pas dans la configuration. Ce processus fonctionne aussi bien en local qu'en production.

Prérequis

Environnement serveur

Avant de commencer l'installation, assurez-vous que votre serveur (local ou distant) dispose des éléments suivants :

  • PHP 8.1 ou supérieur
  • Extensions PHP requises : PDO MySQL, Intl, mbstring
  • Extension recommandée : OPcache (pour de meilleures performances)
  • Base de données : MySQL 8.0+ ou MariaDB 10.3+
  • Droits en écriture sur les dossiers : var/, public/uploads/ et fichier .env.local

Installation en local

Si vous souhaitez développer en local avant la mise en production, vous devez :

  1. Installer un environnement de développement local : MAMP, WAMP, ou Laragon
  2. Installer Composer (gestionnaire de dépendances PHP)
  3. Installer npm (gestionnaire de paquets JavaScript)
Note : Le script d'installation vérifiera automatiquement tous ces prérequis lors de la première étape.

Installation automatique

Préparation des fichiers

1. Installation des dépendances

Ouvrez la console dans le répertoire de votre projet. Pour ce faire :

Rendez-vous dans le répertoire de votre projet (ex : D:\Documents\mon_projet)

ouverture console

Tapez cmd dans la barre d'adresse pour ouvrir la console

ouverture console

Installez les dépendances PHP :

composer install

Compilez les assets :

npm install && npm run build
2. Lancement du serveur

Démarrez votre serveur web :

En local avec Symfony CLI :
symfony serve -d
Le serveur sera accessible sur http://127.0.0.1:8000
En local avec WAMP/MAMP :
Lancez vos services et accédez à votre projet via http://localhost/mon_projet/public
Sur serveur distant :
Accédez directement à votre nom de domaine (ex: https://monsite.com)
3. Accès à l'installateur

Rendez-vous sur l'URL de votre application. Si l'application n'est pas encore configurée, vous serez automatiquement redirigé vers l'installateur à l'adresse :

/install
4. Étapes d'installation guidée

Le système vérifie automatiquement :

  • La version de PHP
  • Les extensions PHP nécessaires
  • Les permissions d'écriture sur les dossiers critiques

Si tous les voyants sont verts, cliquez sur "Continuer" pour passer à l'étape suivante.

Configurez la connexion à la base de données et au serveur SMTP :

Base de données
  • Hôte : 127.0.0.1 (local) ou l'adresse fournie par votre hébergeur
  • Port : 3306 (par défaut)
  • Nom de la base : Le nom que vous souhaitez donner
  • Utilisateur et mot de passe : Les identifiants MySQL
  • Version du serveur : Ex: 8.0, mariadb-10.6
Serveur SMTP (emails)
  • En local (développement) : 127.0.0.1:1025 avec Mailpit
  • En production : Utilisez les paramètres fournis par votre hébergeur
Le système créera automatiquement la base de données et le schéma des tables.

Configurez les informations de votre site et créez le premier compte administrateur :

Informations du site
  • Nom du site
  • Description
  • Logo (optionnel)
  • Favicon (optionnel, sinon un favicon par défaut sera utilisé)
Premier exercice comptable
  • Date de début et de fin de l'exercice
  • Tarif de cotisation
  • Appel de cotisation (texte/description)
Compte administrateur
  • Informations personnelles : Nom, prénom, adresse
  • Email (servira d'identifiant)
  • Mot de passe
Le système créera automatiquement :
  • Le rôle "Administrateur" avec toutes les permissions
  • Le compte bancaire associé (numéro 41100001)
  • Le premier numéro d'adhérent (00001)

Une fois validé, vous serez automatiquement connecté et redirigé vers le tableau de bord !

C'est terminé ! Vous pouvez maintenant commencer à utiliser votre plateforme via l'interface de gestion.
menu gestion

Migration d'un environnement local vers un serveur distant

Si vous avez développé votre site en local et souhaitez le transférer sur un serveur de production, suivez ces étapes :

1. Prérequis hébergement

Vous devez disposer de :

  • Un nom de domaine
  • Un hébergement web compatible PHP 8.1+ et MySQL
  • Un accès FTP/SFTP aux fichiers du serveur
  • Un accès à phpMyAdmin ou équivalent pour la base de données
Hébergeur recommandé : OVH
Si vous avez souscrit à une de nos offres d'assistance, vous pouvez ajouter notre agence comme prestataire technique avec le NicHandle : LC10446-ovh

2. Transfert des fichiers

Utilisez un client FTP (FileZilla, Cyberduck, WinSCP...) pour transférer tous les fichiers de votre projet :

Option A : Installation à la racine

Placez tous les fichiers dans le répertoire www/ ou public_html/ de votre hébergement.

Dans ce cas, configurez le document root de votre domaine pour pointer vers le sous-dossier public/
Option B : Installation dans un sous-répertoire
  1. Créez un sous-répertoire (ex: monapp/) dans www/
  2. Transférez tous les fichiers dans ce sous-répertoire
  3. Créez un sous-domaine dans votre hébergement (ex: monapp.monsite.com)
  4. Définissez le dossier racine du sous-domaine sur monapp/public

3. Configuration de l'environnement

Sur le serveur distant, vous devez créer ou modifier le fichier .env.local avec les paramètres de production :

APP_ENV=prod
APP_DEBUG=false

DATABASE_URL="mysql://user_prod:password_prod@localhost:3306/db_prod?serverVersion=8.0"
MAILER_DSN=smtp://smtp.monhebergeur.com:587?encryption=tls&username=...&password=...

Remplacez les valeurs par celles fournies par votre hébergeur.

4. Migration de la base de données

Étape 1 : Export depuis l'environnement local
  1. Accédez au phpMyAdmin de votre serveur local (WAMP/MAMP)
  2. Sélectionnez votre base de données
  3. Cliquez sur l'onglet "Exporter"
  4. Conservez les options par défaut (méthode rapide, SQL)
  5. Cliquez sur "Exécuter" pour télécharger le fichier .sql
Étape 2 : Import sur le serveur distant
  1. Accédez au phpMyAdmin de votre hébergeur
  2. Créez une nouvelle base de données (si ce n'est pas déjà fait)
  3. Sélectionnez cette base de données
  4. Cliquez sur l'onglet "Importer"
  5. Sélectionnez le fichier .sql exporté précédemment
  6. Cliquez sur "Exécuter"
Vos données (articles, produits, membres, etc.) sont maintenant disponibles sur le serveur distant !

5. Transfert des fichiers uploadés

N'oubliez pas de transférer le contenu du dossier public/uploads/ depuis votre environnement local vers le serveur distant.

6. Vider le cache de production

Connectez-vous en SSH à votre serveur (si disponible) et exécutez :

php bin/console cache:clear --env=prod

Ou supprimez manuellement le contenu du dossier var/cache/prod/ via FTP.

Votre site est maintenant en ligne ! Accédez-y via votre nom de domaine.

Ressources complémentaires