🔄 Guide de Migration des Boutiques : Version 1 → Version 2
Ce guide explique comment migrer les données d'une boutique de la Version 1 vers la Version 2, en tenant compte du préfixe des tables.
⚠️ Comprendre le Préfixe
Structure des Tables
Version 1 (sans préfixe) :
usersproductssalesshopscategories- etc.
Version 2 (avec préfixe v2_) :
v2_usersv2_productsv2_salesv2_shopsv2_categories- etc.
Impact sur la Migration
✅ Avantage : Les deux versions peuvent coexister sans conflit
⚠️ Défi : La migration doit lire depuis les tables v1 et écrire dans les tables v2
🎯 Stratégie de Migration
Option 1 : Migration Automatique (RECOMMANDÉ)
Créer un service de migration qui :
- Se connecte aux deux bases de données (ou utilise deux connexions)
- Lit les données depuis les tables v1 (sans préfixe)
- Transforme/adapter les données si nécessaire
- Insère les données dans les tables v2 (avec préfixe
v2_)
Option 2 : Migration Manuelle via SQL
Utiliser des requêtes SQL directes pour copier les données.
🔧 Solution : Service de Migration Adapté
Connexions de Base de Données
Dans config/database.php, ajoutez une connexion pour la v1 :
'connections' => [
'mysql' => [
// Connexion par défaut (Version 2 avec préfixe v2_)
'prefix' => env('DB_PREFIX', ''),
// ...
],
'mysql_v1' => [
// Connexion pour lire depuis la Version 1 (sans préfixe)
'driver' => 'mysql',
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE'), // Même base
'username' => env('DB_USERNAME'),
'password' => env('DB_PASSWORD'),
'prefix' => '', // Pas de préfixe pour v1
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
],
],
Service de Migration Adapté
Le service de migration doit :
- Lire depuis la connexion v1 (sans préfixe)
- Écrire dans la connexion v2 (avec préfixe
v2_)
Exemple de structure :
// Lire depuis v1
$v1Shop = DB::connection('mysql_v1')->table('shops')->find($shopId);
// Écrire dans v2
DB::connection('mysql')->table('v2_shops')->insert([
'name' => $v1Shop->name,
// ... autres champs
]);
📋 Processus de Migration d'une Boutique
Étape 1 : Préparer la Migration
- Vérifier que la boutique existe dans la v1
- Vérifier que la boutique n'existe pas déjà dans la v2
- Créer une sauvegarde de sécurité
Étape 2 : Migrer les Données Principales
Ordre recommandé (respecter les dépendances) :
- Shop (boutique elle-même)
- Users (utilisateurs de la boutique)
- Categories (catégories)
- Products (produits - dépend de categories)
- Suppliers (fournisseurs)
- Purchases (achats - dépend de suppliers, products)
- Sales (ventes - dépend de products, users)
- Stock Movements (mouvements de stock)
- Cash Sessions (sessions de caisse)
- Settings (paramètres)
Étape 3 : Vérifier l'Intégrité
- Vérifier que toutes les données sont migrées
- Vérifier les relations (foreign keys)
- Vérifier les totaux (stock, ventes, etc.)
🛠️ Implémentation Pratique
Exemple : Migration d'une Boutique
public function migrateShopFromV1ToV2($v1ShopId)
{
DB::beginTransaction();
try {
// 1. Lire la boutique depuis v1
$v1Shop = DB::connection('mysql_v1')
->table('shops')
->where('id', $v1ShopId)
->first();
if (!$v1Shop) {
throw new \Exception("Boutique non trouvée dans la v1");
}
// 2. Vérifier qu'elle n'existe pas déjà dans v2
$existingV2Shop = DB::connection('mysql')
->table('v2_shops')
->where('name', $v1Shop->name)
->first();
if ($existingV2Shop) {
throw new \Exception("Boutique déjà migrée dans la v2");
}
// 3. Créer la boutique dans v2
$v2ShopId = DB::connection('mysql')
->table('v2_shops')
->insertGetId([
'name' => $v1Shop->name,
'description' => $v1Shop->description,
'logo' => $v1Shop->logo,
// ... autres champs
'app_version' => '2.0',
'migrated_at' => now(),
'migration_notes' => "Migré depuis v1 (ID: {$v1ShopId})",
]);
// 4. Migrer les utilisateurs de cette boutique
$v1Users = DB::connection('mysql_v1')
->table('users')
->where('shop_id', $v1ShopId)
->get();
foreach ($v1Users as $v1User) {
DB::connection('mysql')
->table('v2_users')
->insert([
'name' => $v1User->name,
'email' => $v1User->email,
'password' => $v1User->password, // Garder le même hash
'shop_id' => $v2ShopId,
// ... autres champs
]);
}
// 5. Migrer les catégories
// ... (même principe)
// 6. Migrer les produits
// ... (même principe)
// 7. Migrer les ventes, achats, etc.
// ... (même principe)
DB::commit();
return [
'success' => true,
'v1_shop_id' => $v1ShopId,
'v2_shop_id' => $v2ShopId,
'migrated_data' => [
'users' => count($v1Users),
// ... autres compteurs
],
];
} catch (\Exception $e) {
DB::rollBack();
throw $e;
}
}
⚠️ Points d'Attention
1. Gestion des IDs
Les IDs peuvent être différents entre v1 et v2. Il faut :
- Soit conserver les IDs originaux (si possible)
- Soit mapper les IDs (créer une table de correspondance)
2. Relations (Foreign Keys)
Les relations doivent être adaptées :
product.category_iddans v1 →v2_product.v2_category_iddans v2- Utiliser un mapping des IDs si nécessaire
3. Données Uniques
Vérifier les contraintes d'unicité :
- Emails d'utilisateurs
- Codes de produits
- Références de ventes/achats
4. Données Calculées
Certaines données peuvent être recalculées :
- Totaux de stock
- Statistiques
- Soldes de caisse
✅ Vérifications Post-Migration
Checklist
- Boutique créée dans v2 avec toutes les informations
- Tous les utilisateurs migrés
- Toutes les catégories migrées
- Tous les produits migrés avec leurs relations
- Toutes les ventes migrées
- Tous les achats migrés
- Stock synchronisé
- Relations (foreign keys) correctes
- Données uniques respectées
- Totaux et statistiques cohérents
Requêtes de Vérification
-- Vérifier le nombre d'éléments migrés
SELECT
(SELECT COUNT(*) FROM shops WHERE id = ?) as v1_count,
(SELECT COUNT(*) FROM v2_shops WHERE id = ?) as v2_count;
-- Vérifier les relations
SELECT COUNT(*)
FROM v2_products p
LEFT JOIN v2_categories c ON p.category_id = c.id
WHERE c.id IS NULL; -- Devrait être 0
🚀 Commandes Artisan
Créer une Commande de Migration
php artisan make:command MigrateShopFromV1ToV2
Usage :
php artisan shop:migrate-from-v1 {v1_shop_id} {--dry-run}
📝 Notes Importantes
- Les deux versions coexistent : La migration ne supprime pas les données de la v1
- Migration réversible : Gardez toujours une sauvegarde avant migration
- Migration progressive : Migrez boutique par boutique, pas tout d'un coup
- Tests : Testez d'abord sur une boutique de test
🔒 Sécurité
- ✅ Toujours créer une sauvegarde avant migration
- ✅ Utiliser des transactions pour garantir l'intégrité
- ✅ Vérifier les données après migration
- ✅ Ne pas supprimer les données v1 immédiatement
Conclusion : Le préfixe des tables ne pose PAS de problème pour la migration. Au contraire, il permet de migrer progressivement tout en gardant les deux versions fonctionnelles.