INSTALL.md 4.0 KB

Création de la base et lancement

0. Si « mysql » n’est pas reconnu

La commande mysql doit être exécutable. Soit tu l’ajoutes au PATH, soit tu utilises le chemin complet vers mysql.exe.

Où se trouve mysql.exe ?

  • XAMPP : C:\xampp\mysql\bin\mysql.exe
  • WAMP : C:\wamp64\bin\mysql\mysql8.x.x\bin\mysql.exe (adapte la version)
  • MySQL installé seul : souvent C:\Program Files\MySQL\MySQL Server 8.x\bin\mysql.exe
  • Laragon : C:\laragon\bin\mysql\mysql-8.x.x-w64\bin\mysql.exe

Dans les commandes ci‑dessous, remplace mysql par le chemin complet, par exemple :

& "C:\xampp\mysql\bin\mysql.exe" -u root -p -e "CREATE DATABASE IF NOT EXISTS bmad CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

(Le & en PowerShell permet d’exécuter un chemin entre guillemets.)

Si tu n’as ni XAMPP ni MySQL : installe XAMPP (avec MySQL) ou MariaDB, puis utilise le chemin vers mysql.exe comme ci‑dessus.


1. Créer la base de données

Ouvre un terminal (PowerShell ou CMD) et lance MySQL/MariaDB.

Si MySQL/MariaDB est dans le PATH :

mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS bmad CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

(Entre le mot de passe root quand il est demandé. Si pas de mot de passe, utilise mysql -u root sans -p.)

Avec XAMPP (MySQL dans C:\xampp\mysql\bin) :

C:\xampp\mysql\bin\mysql.exe -u root -p -e "CREATE DATABASE IF NOT EXISTS bmad CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

Avec WAMP (chemin type C:\wamp64\bin\mysql\mysql8.x.x\bin\mysql.exe) :

C:\wamp64\bin\mysql\mysql8.2.0\bin\mysql.exe -u root -p -e "CREATE DATABASE IF NOT EXISTS bmad CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

(Adapte la version MySQL dans le chemin.)


2. Importer le schéma (créer les tables)

Depuis la racine du projet bmad (le dossier qui contient app).

MySQL dans le PATH :

mysql -u root -p bmad < app/sql/schema.sql

Avec XAMPP :

C:\xampp\mysql\bin\mysql.exe -u root -p bmad < app/sql/schema.sql

Si tu es déjà dans le dossier app :

mysql -u root -p bmad < sql/schema.sql

3. Fichier de configuration .env

Dans le dossier app, copie le fichier d’exemple puis édite-le :

PowerShell (depuis la racine du projet) :

cd app
Copy-Item .env.example .env
notepad .env

CMD :

cd app
copy .env.example .env
notepad .env

Dans .env, vérifie ou modifie :

  • DB_HOST=localhost
  • DB_NAME=bmad
  • DB_USER=root
  • DB_PASS= (ton mot de passe MySQL, ou vide si pas de mot de passe)

Sauvegarde et ferme.


4. Lancer l’application

Toujours depuis le dossier app :

php -S localhost:8080

Ouvre le navigateur : http://localhost:8080


5. (Optionnel) Données de test

Pour avoir des clients et des factures tout de suite, exécute ce SQL après l’import du schéma :

mysql -u root -p bmad -e "
INSERT INTO clients (nom) VALUES ('Client A'), ('Client B');
INSERT INTO factures (client_id, n_facture, n_vente, date_facture, montant_ht) VALUES (1, 'FA-001', 'V1', '2026-01-15', 1000), (1, 'FA-002', 'V2', '2026-02-01', 500);
INSERT INTO paiements (facture_id, montant, date_paiement) VALUES (1, 500, '2026-02-01');
"

Avec XAMPP :

C:\xampp\mysql\bin\mysql.exe -u root -p bmad -e "INSERT INTO clients (nom) VALUES ('Client A'), ('Client B'); INSERT INTO factures (client_id, n_facture, n_vente, date_facture, montant_ht) VALUES (1, 'FA-001', 'V1', '2026-01-15', 1000), (1, 'FA-002', 'V2', '2026-02-01', 500); INSERT INTO paiements (facture_id, montant, date_paiement) VALUES (1, 500, '2026-02-01');"

Récap ordre des commandes

  1. Créer la base : mysql -u root -p -e "CREATE DATABASE ..."
  2. Importer le schéma : mysql -u root -p bmad < app/sql/schema.sql
  3. Copier et éditer app/.env
  4. Lancer : cd app puis php -S localhost:8080
  5. (Optionnel) Insérer les données de test