Migrer une boutique V1 → V2

Lien isolé Accueil docs Formation
Technique & dev

Guide opérationnel pour migrer une boutique existante vers V2.

Comment migrer une boutique de la Version 1 vers la Version 2

Ce document résume comment migrer une boutique selon votre situation.

Important : Si vous avez vu un message de « migration réussie » mais qu’aucune donnée n’apparaît dans l’application v2, c’est souvent parce que la migration intégrée (Migrer vers v2.0 / shop:migrate) ne copie pas les données depuis une base v1 : elle met à jour une boutique déjà présente en v2. Pour faire apparaître une boutique qui n’existe que en v1, il faut utiliser l’import (commande shop:import-from-v1) décrit au Cas B.


Deux situations possibles

Cas A : La boutique est déjà dans l’application Version 2

La boutique apparaît dans Boutiques (menu de la v2), avec une version 1.0 (ou sans version). Vous voulez la passer en version 2.0 (mise à jour des données, normalisation, etc.).

→ Utiliser la migration intégrée (interface ou commande).

Cas B : La boutique existe seulement dans l’application Version 1

La boutique est dans l’ancienne application (Version 1), avec ses propres tables ou base. Vous voulez la copier dans la Version 2.

→ Importer d’abord les données (voir section « Migration depuis l’app V1 »), puis éventuellement lancer la migration vers v2.0 (Cas A).


Cas A : Migration depuis l’interface (boutique déjà en v2)

  1. Connectez-vous en super admin (ou en admin ayant créé la boutique).
  2. Allez dans Boutiques et ouvrez la fiche de la boutique à migrer.
  3. Si la boutique est en version 1.0, le bouton « Migrer vers v2.0 » s’affiche.
  4. Cliquez sur « Migrer vers v2.0 ».
  5. Sur la page de migration :
    • Consultez les vérifications (version, statut, données).
    • Cliquez sur « Lancer la migration ».
  6. Une sauvegarde est créée dans storage/app/migrations_backup/. La boutique passe en version 2.0.

En cas d’erreur, un message s’affiche et les modifications sont annulées (transaction).


Cas A : Migration en ligne de commande

À la racine du projet (Version 2) :

php artisan shop:migrate {id_boutique}

Exemple pour la boutique dont l’ID est 3 :

php artisan shop:migrate 3

Options utiles :

  • Forcer la migration même si des vérifications échouent :
    php artisan shop:migrate 3 --force
  • La migration crée une sauvegarde dans storage/app/migrations_backup/.

Cas B : La boutique est encore dans l’application Version 1

Si la boutique n’est pas dans la liste des boutiques de la v2, il faut d’abord importer les données de la v1 vers la v2.

Méthode recommandée : commande d’import (même base ou base v1 dédiée)

L’application v2 dispose d’une connexion mysql_v1 et d’une commande d’import qui copient une boutique de la base v1 vers la base v2.

  1. Configurer la connexion v1
    Dans .env, la connexion v1 utilise par défaut les mêmes paramètres que la connexion principale, mais sans préfixe (tables v1 = shops, users, …).
    Si votre v1 est dans une autre base, définir :

    • DB_V1_HOST, DB_V1_PORT, DB_V1_DATABASE, DB_V1_USERNAME, DB_V1_PASSWORD
  2. Préfixe v2
    Si vos tables v2 sont préfixées (ex. v2_shops), définir DB_PREFIX=v2_ dans .env.

  3. Récupérer les ID des boutiques v1 (si vous ne les connaissez pas) :

    • Depuis l’interface admin v2 : Boutiques → Importer depuis la v1. La page affiche la liste de toutes les boutiques de la base v1 (ID, nom, email, téléphone). Vous pouvez cliquer sur Importer vers v2 à côté d’une boutique pour l’importer, ou noter l’ID et le saisir dans le formulaire.
    • En ligne de commande : php artisan shop:list-v1 affiche toutes les boutiques v1 avec leur ID. Exemple de sortie : tableau avec colonnes ID (v1), Nom, Email, Téléphone, Slug. Utilisez l’ID pour l’import (étape suivante).
  4. Lancer l’import :

    • Depuis l’interface admin v2 : Boutiques → Importer depuis la v1 → choisir une boutique dans la liste (bouton Importer vers v2) ou saisir l’ID → Importer vers la v2. Après l’import, vous êtes redirigé vers la fiche de la boutique en v2 (ou vers le tableau de bord v2 si vous cochez « Passer directement à cette boutique »). L’interface graphique (tableaux de bord, graphiques) est alors celle de la version 2.
    • En ligne de commande (à la racine du projet v2) :
      php artisan shop:import-from-v1 {id_boutique_v1}
      
      Exemple : php artisan shop:import-from-v1 1
  5. La commande ou l’import depuis l’admin crée la boutique en v2 (avec utilisateurs, catégories, produits associés). Après upgrade, reconduire l’interface vers la v2 : utilisez la fiche boutique ou le tableau de bord de l’app v2 (la boutique importée est déjà en version 2.0).

  6. Si besoin, vous pouvez lancer la migration complémentaire comme au Cas A (bouton « Migrer vers v2.0 » ou php artisan shop:migrate {id_boutique_v2}).

Utiliser une sauvegarde des données de la v1 dans la v2

Si vous n’avez plus accès à la base v1 mais possédez une sauvegarde (export SQL ou JSON) :

  • Sauvegarde SQL : recréer une base (ou un schéma) dédiée, y importer le dump SQL, puis configurer mysql_v1 vers cette base et lancer php artisan shop:import-from-v1 {id} comme ci‑dessus.
  • Sauvegarde JSON : il n’existe pas encore de commande d’import depuis un fichier JSON ; vous pouvez soit recréer une base v1 à partir de ces données et utiliser l’import ci‑dessus, soit demander l’ajout d’une commande du type shop:import-from-json {fichier} (voir GUIDE_MIGRATION_V1_VERS_V2.md).

Autre approche (manuel)

  • Voir le guide détaillé : docs/GUIDE_MIGRATION_V1_VERS_V2.md (connexions, ordre des tables, mapping d’IDs, exemples de code).

Résumé rapide

Situation Action
Boutique déjà dans la v2, en version 1.0 Menu Boutiques → fiche de la boutique → Migrer vers v2.0 (ou php artisan shop:migrate {id}).
Boutique seulement dans l’app v1 Configurer la connexion v1 (.env), lancer php artisan shop:import-from-v1 {id_v1}, puis éventuellement Migrer vers v2.0 (Cas A).

Sécurité et sauvegardes

  • Une sauvegarde (JSON) est créée avant chaque migration dans storage/app/migrations_backup/.
  • Il est recommandé d’avoir aussi une sauvegarde de la base avant toute migration.
  • La migration s’effectue dans une transaction : en cas d’erreur, les modifications sont annulées.

Appeler le stockage d’une boutique par son identifiant

Pour accéder aux informations de stockage (fichiers, chemins) d’une boutique identifiée par son ID (intégrations, API, scripts) :

  • URL : GET /shops/{id}/storage-info (authentification requise).
  • Réponse JSON : shop_id, identifier, storage.path_relative, storage.path_absolute, storage.url_base, storage.exists, database.connection, database.table_prefix.

Exemple : /shops/5/storage-info retourne les infos de stockage de la boutique d’ID 5.