RELEASE.md 2.2 KB

Procédure de release et déploiement

1. Préparer une nouvelle version (Git Bash)

Avant de committer

  • Vérifier que config.local.php n’est pas inclus (ignoré par git)
  • Tester en local : php -S 127.0.0.1:8000 -t public
  • Vérifier que les exports OVH (ovh-*-export.csv) ne sont pas trackés

Commit et tag

# 1. Ajouter les fichiers (hors .gitignore)
git add .
git status   # Vérifier avant commit

# 2. Commit
git commit -m "Release v1.1.0 — description des changements"

# 3. Créer le tag (ou utiliser le script)
git tag -a v1.1.0 -m "Release v1.1.0"

# 4. Pousser
git push origin master
git push origin v1.1.0

Alternative : script release

./scripts/release.sh 1.1.0
# Puis : git push origin master && git push origin v1.1.0

2. Déploiement serveur (FileZilla / FTP)

Prérequis

  • Compte FTP OVH (host, user, password)
  • config.local.php déjà présent sur le serveur (ne pas l’écraser)

Checklist déploiement

Étape Action
1 composer install --no-dev --ignore-platform-req=ext-mbstring (si dépendances modifiées)
2 Envoyer config/ → racine FTP (sans écraser config.local.php)
3 Envoyer src/ → racine
4 Envoyer templates/ → racine
5 Envoyer vendor/ → racine
6 Envoyer contenu de public/ → www/

Structure sur OVH

Racine FTP/
├── config/
│   ├── config.php
│   └── config.local.php   ← Ne pas écraser
├── src/
├── templates/
├── vendor/
├── storage/               ← Créé auto par l'app (outbox, logs, etc.)
└── www/
    ├── index.php
    ├── api/
    └── assets/

Après déploiement

  • Tester l’URL de production
  • Vérifier un parcours complet : landing → pack → quiz → résultats → PDF
  • Vérifier que storage/ est accessible en écriture (chmod 755 ou 775)

3. Numérotation des versions

  • MAJOR (1.x.x) : changement majeur, rupture de compatibilité
  • MINOR (x.1.x) : nouvelles fonctionnalités, packs, endpoints
  • PATCH (x.x.1) : corrections, ajustements, doc

Exemple : v1.0.0 → v1.1.0 pour ajout des packs v2 et endpoints analytics/excel.