Sync médias staging → production WordPress : fini le FTP manuel et les plugins à 149 $ (guide agence 2026)

Vendredi 17 h. Votre client valide la mise en ligne sur staging : nouvelles fiches produit, bannières campagne été, PDF presse dans la médiathèque. Vous poussez la base de données en production avec WP Migrate — rapide, propre. Vous ouvrez la home en prod. Images cassées. Des dizaines de rectangles gris. Le client appelle. Vous ouvrez FileZilla, vous comparez wp-content/uploads/2026/07 à la main, vous ratez trois variantes WebP, vous facturez deux heures de « sync médias » que personne n'avait budgétées.

Si cette scène vous est familière, vous n'êtes pas un mauvais développeur. Vous êtes un développeur d'agence qui travaille avec des outils conçus pour des migrations ponctuelles, pas pour un delta récurrent entre staging et production.

Les plugins WP Migrate DB Pro + Media Files (~149–199 $/an) ou les alternatives Media Sync payantes font le job — mais facturent une licence par agence, parfois un stockage cloud intermédiaire facturé au Go, et ne sont pas toujours le bon outil quand les environnements sont déjà appairés et que vous voulez juste rattraper les fichiers manquants. rsync en SSH est parfait quand vous avez les clés sur les deux serveurs ; sur un mutualisé OVH, Ionos ou o2switch classique, c'est souvent impossible.

Media Sync Staging→Prod by Volade (MSSP) connecte staging et production directement : manifeste REST signé par clé partagée, comparaison hash MD5, pull des fichiers manquants uniquement, 4 presets agence, dry-run et export JSON gratuit — zéro frais de stockage cloud, sans compte obligatoire.

Pour qui est ce guide ?

Scénarios clients réels (et ce qui casse)

Scénario A — Handoff agence, vendredi soir

L'agence livre un site WooCommerce. Le client a ajouté 80 photos produit sur staging pendant la recette. La BDD est migrée. En prod : fiches OK, images 404. Cause : wp-content/uploads jamais synchronisé. Solution MSSP : preset Agency handoff (full missing) après dry-run validé.

Scénario B — Catalogue saisonnier

Boutique mode : chaque collection = 150 visuels. L'équipe marketing travaille sur staging deux semaines. Mise en prod hebdomadaire. FTP intégral = 45 min + risque d'écrasement. MSSP preset Recent uploads (30 days) = delta ciblé.

Scénario C — Mutualisé sans SSH

Hébergement partagé, pas de rsync, pas de clé SSH pour le freelance. WP Migrate Media = licence + parfois relais cloud. MSSP : plugin sur les deux sites, clé REST, pull depuis l'admin production.

Scénario D — Combiner avec WP Migrate

Migration complète initiale : WP Migrate pour DB + option médias si besoin. Ensuite, chaque sprint : MSSP pour le delta uploads sans repasser par un export ZIP de 12 Go.

Pourquoi le FTP manuel échoue (à chaque fois)

Le FTP échoue parce qu'il compare des arborescences, pas des contenus. Un fichier présent aux deux endroits avec un hash différent (régénération miniatures, conversion WebP) ne sera pas détecté comme « à synchroniser » si vous ne comparez que les noms. MSSP compare les hash MD5 via manifeste REST.

Architecture MSSP — comment ça marche

1. Staging (source) : scanne wp-content/uploads, construit un manifeste (chemin relatif + taille + hash MD5 + date).
2. Production (destination) : interroge GET /wp-json/mssp/v1/manifest avec header X-MSSP-Key.
3. Comparaison locale : pour chaque entrée staging, prod vérifie si le fichier existe avec le même hash.
4. Pull : télécharge uniquement les manquants via GET /wp-json/mssp/v1/file?path=..., écrit au bon chemin year/month.

Endpoints REST :

Cinq phases de déploiement (avec sous-étapes)

Bloquez 30 à 45 minutes pour le premier appairage. Les runs suivants : 5–15 min selon le volume.

Phase 1 — Prérequis et sauvegarde (10 min)

1. Vérifiez HTTPS actif sur staging et production.
2. Confirmez structure wp-content/uploads identique (même préfixe table si multisite).
3. Sauvegarde production : fichiers + BDD (UpdraftPlus, hébergeur, ou snapshot).
4. Installez le plugin sur les deux environnements (même version ZIP).

Phase 2 — Appairage staging / prod (15 min)

1. Sur staging : réglages → rôle Staging (source) → copiez la clé de sync locale.
2. Sur production : rôle Production (destination) → URL staging + collez la clé distante.
3. Cliquez Test connection → doit répondre ok: true sur mssp/v1/ping.
4. Vérification manuelle (optionnel) :

curl -H "X-MSSP-Key: VOTRE_CLE" https://staging.client.com/wp-json/mssp/v1/ping

1. Documentez URL + emplacement clé dans le runbook client (hors Git).

Phase 3 — Dry-run compare (5–10 min)

1. Preset Dry-run compare only ou :

wp mssp pull --dry-run
# équivalent preset :
wp mssp pull --preset=dry_compare

1. Notez : nombre de fichiers manquants, taille totale estimée, dossiers concernés (2026/07, etc.).
2. Partagez le rapport au client / chef de projet — validation écrite avant pull.
3. Si le chiffre semble aberrant (ex. 15 000 fichiers), vérifiez que l'URL staging pointe bien vers le bon environnement.

Phase 4 — Premier pull (10–30 min)

1. Preset Agency handoff (full missing) — import par lots (batch 25 par défaut).
2. Surveillez le journal local admin : chaque run enregistre succès/échecs.
3. Vérifiez pages front : home, 3 fiches produit, une page avec PDF.
4. Si miniatures floues : régénérez via plugin dédié après le pull (MSSP ne régénère pas automatiquement toutes les tailles).

Variantes preset :

wp mssp pull --preset=woo_catalog
wp mssp pull --preset=recent_30

Phase 5 — Export, handoff et runbook (5 min)

1. Export JSON depuis l'admin — manifeste, réglages (clés masquées), journal.
2. Joignez au livrable client ou versionnez en Git interne agence.
3. Planifiez runs récurrents (hebdo ou avant chaque release) avec preset recent_30.
4. Archivez le journal de sync dans le dossier projet.

wp mssp export > mssp-backup-$(date +%Y%m%d).json

Comparatif détaillé vs WP Migrate, FTP, rsync

Comparatif rapide décision

WP-CLI pour agences — commandes complètes

# Test connexion staging depuis prod
wp mssp ping

# Comparer sans télécharger
wp mssp compare

# Dry-run explicite
wp mssp pull --dry-run

# Presets
wp mssp pull --preset=agency_handoff
wp mssp pull --preset=woo_catalog
wp mssp pull --preset=recent_30

# Export configuration + journal
wp mssp export > mssp-backup.json

Usages CI/CD agence :

• Hook post-déploiement BDD : wp mssp pull --preset=recent_30 si connexion staging autorisée depuis prod.
• Script de validation : wp mssp compare retourne la liste des manquants pour alerte Slack.

Dépannage — erreurs fréquentes

Invalid sync key (401)

• Clé copiée avec espace en fin de ligne.
• Clé régénérée sur staging sans mise à jour prod.
• Header X-MSSP-Key bloqué par WAF — whitelistez /wp-json/mssp/*.

Media Sync is disabled (403)

• Plugin désactivé sur staging ou sync désactivé dans réglages.
• Réactivez sur staging (source doit exposer REST).

File not found (404) sur certains pulls

• Fichier supprimé sur staging entre manifeste et pull — relancez compare.
• Chemin avec .. rejeté (sécurité) — vérifiez nom fichier source.

Timeout PHP sur gros volumes

• Réduisez le batch (réglages admin).
• Lancez preset recent_30 en plusieurs passes.
• Augmentez max_execution_time temporairement sur prod.

Images toujours cassées après pull réussi

• URLs absolues en BDD pointent vers staging — cherchez-replace URL (WP Migrate ou Better Search Replace).
• Fichier présent mais hash différent — MSSP ne remplace pas les existants ; supprimez le fichier prod obsolète ou renommez sur staging.

REST bloqué par sécurité

• Wordfence / iThemes bloque REST anonyme — autorisez route mssp/v1 avec clé.
• Cloudflare « Bot Fight » — règle allow pour IP prod → staging.

Workflow WooCommerce — catalogue produit sans tout uploads/

Sur une boutique avec 3 000 produits et 12 Go d'uploads historiques, un pull full missing est souvent overkill si seules les vignettes catalogue ont changé ce sprint.

Étapes recommandées

1. Dry-run global pour voir l'ampleur (dry_compare).
2. Si > 80 % des manquants sont des images produit → preset woo_catalog.
3. Vérifiez 10 fiches produit au hasard (image principale + galerie).
4. Si des PDF notices ou assets marketing manquent encore → complétez avec recent_30 ou agency_handoff ciblé.

Cas limite : WebP + fallback JPEG

Si staging génère des WebP que prod n'a pas, le manifeste les liste comme manquants même si un JPEG existe sous un autre nom. Après pull, vérifiez <picture> / srcset du thème — parfois un regenerate thumbnails suffit.

Sécurité et conformité — checklist rapide

Quand NE PAS utiliser MSSP

• Migration initiale de 50 Go+ sans environnement prod existant → WP Migrate ou rsync initial.
• Remplacement de fichiers modifiés (même nom, contenu différent) → MSSP cible les manquants, pas les remplacements ; supprimez manuellement ou utilisez rsync --checksum.
• Médias sur S3 uniquement (sans copie locale) → WP Offload Media avec bucket partagé.
• Pas de HTTPS sur staging → configurez SSL avant appairage (clé transite sur REST).

---

---

FAQ

Qu'est-ce que ce sujet ?

slug: wordpress-media-sync-staging-prod-2026

Quels sont les prérequis pour se lancer ?

Avant de commencer, assurez-vous d'avoir les bases : un site ou projet bien défini, des objectifs clairs, et les ressources nécessaires (temps, budget, compétences). Le reste s'acquiert en chemin.

Combien de temps faut-il pour voir des résultats ?

Les premiers résultats peuvent apparaître en 2 à 4 semaines pour les actions rapides. Pour les efforts plus profonds, comptez 3 à 6 mois. La régularité est le facteur clé.

Quelles erreurs éviter absolument ?

Les erreurs les plus fréquentes : se précipiter sans diagnostic, vouloir tout faire d'un coup, négliger la formation, et sous-estimer le temps nécessaire. La pire : copier les autres sans comprendre pourquoi.

Faut-il des compétences techniques ?

Pas forcément. Beaucoup d'aspects sont accessibles sans technique. Pour les points plus complexes, des outils simplifient la tâche ou vous pouvez vous faire accompagner.

Est-ce adapté aux débutants ?

Oui, si vous suivez une approche progressive. Commencez par les fondamentaux, maîtrisez-les, puis approfondissez. L'essentiel est de commencer simple.

Quel budget prévoir ?

Certains aspects sont gratuits (bonnes pratiques, optimisations de base). D'autres nécessitent un investissement (outils, formation). Budgétisez selon vos objectifs et mesurez le retour.

Par où commencer après avoir lu cet article ?

Action Installer MSSP sur staging + prod d'un site pilote Appairage + dry-run, partager rapport au chef de projet Premier pull agency_handoff, vérifier 10 URLs front Documenter runbook + export JSON dans dossier client Ajouter wp mssp pull --preset=recent_30 à la checklist go-live Checklist téléchargeable :

Plan d'action cette semaine

Checklist téléchargeable : checklist sync médias staging → prod

Conclusion — reprenez le contrôle du vendredi soir

Les images cassées en prod ne sont pas une fatalité WordPress. Ce sont presque toujours un process manquant : personne n'a synchronisé uploads/ après la migration BDD. Le FTP manuel et les licences à 149 $ ne sont pas les seules options — et sur mutualisé sans SSH, rsync n'est tout simplement pas là.

MSSP vous donne un workflow d'agence : dry-run partageable, pull ciblé, presets WooCommerce, journal local, export JSON, WP-CLI. Zéro cloud intermédiaire. Gardez WP Migrate pour la DB ; laissez MSSP gérer le delta médias entre chaque sprint.

Prochaine étape : téléchargez Media Sync Staging→Prod by Volade v1.1.0, appairez staging et production, et lancez un dry-run avant votre prochain go-live client.