# Migrer un site Web de cPanel vers KapsuleHost

Source: https://support.kapsulehost.com/fr-fr/sites-migrate-cpanel

Migrer la plupart des sites depuis cPanel ne nécessite de toucher à aucun fichier : KapsuleHost propose une migration guidée qui copie vos fichiers et votre base de données à votre place pendant que l'ancien site reste en ligne. Ce guide présente les trois parcours de migration, comment choisir entre eux, et la méthode manuelle pour les cas où vous préférez le faire vous-même.

La migration est gratuite sur chaque formule. Il n'y a ni frais de mise en place, ni frais par site.

## Avant de commencer

> **Note:** Conservez votre ancien hébergement actif jusqu'à ce que le nouveau site soit vérifié et que votre domaine ait été pointé vers lui. Résilier trop tôt est la seule erreur de ce processus qui ne peut pas être rattrapée, car la source de la copie disparaît avec elle. Prévoyez une semaine de chevauchement.

Préparez les éléments suivants :

- Le domaine sur lequel le site tourne actuellement.
- L'accès à l'administration WordPress du site, ou vos identifiants cPanel ou FTP.
- Vos identifiants de connexion au registraire de votre domaine, pour l'étape finale.
- Une formule d'hébergement KapsuleHost avec un emplacement de site disponible.

## Choisir un parcours de migration

Ouvrez **Migrations** dans le menu latéral gauche de KPanel, accédez à une migration de site web, et saisissez l'adresse actuelle de votre site. KapsuleHost vérifie le site, identifie la plateforme, et propose trois parcours.

![Options de parcours de migration dans KPanel](https://support.kapsulehost.com/help/screenshots/sites-migrate-cpanel.89d2d04b.webp)

| Parcours | Comment ça marche | Idéal pour |
|---|---|---|
| **Extension de migration KapsuleHost** | Installez une extension gratuite sur le site source et collez un jeton à usage unique. Aucun identifiant d'hébergement ne sort de vos mains. | Les sites WordPress et WooCommerce. L'option la plus rapide, celle que la plupart des gens devraient choisir. |
| **Identifiants d'hébergement** | Donnez-nous un accès temporaire FTP, SFTP ou cPanel ainsi que les informations de base de données. Nous récupérons tout directement. | N'importe quelle plateforme, y compris les sites qui ne sont pas sous WordPress. |
| **Notre équipe s'en charge** | Parlez-nous du site et un ingénieur de migration s'en occupe manuellement. | Les configurations complexes, plusieurs sites à la fois, ou si vous préférez simplement ne pas vous en occuper. |

Les trois options sont gratuites, et vous pouvez passer de l'une à l'autre à tout moment de l'assistant.

### Le parcours par extension

1. Choisissez **Extension de migration KapsuleHost**.
2. Téléchargez `kapsule-migrator.zip` depuis l'écran.
3. Sur votre site actuel, allez dans **Extensions**, puis **Ajouter**, puis **Téléverser une extension**. Téléversez le fichier zip et activez-le.
4. Ouvrez **KapsuleHost Migrate** dans le menu d'administration de WordPress.
5. Copiez le jeton depuis KPanel, collez-le dans l'extension et cliquez sur **Lancer la migration**.

KPanel détecte automatiquement la connexion et vous dirige vers un écran de progression en direct. Les fichiers, la base de données et les fichiers téléversés sont copiés pour vous. Le jeton expire au bout de 48 heures ; générez-en un nouveau depuis le même écran si nécessaire.

### Le parcours par identifiants

Choisissez **Identifiants d'hébergement** et renseignez deux sections : les détails FTP, SFTP ou SSH (nom d'hôte, nom d'utilisateur, mot de passe) et les détails de la base de données (hôte, nom, nom d'utilisateur, mot de passe). Un champ de notes permet d'ajouter toute information utile, comme l'adresse de votre cPanel.

> **Note:** Les identifiants sont chiffrés avant d'être stockés et ne sont lisibles que par le système de migration automatisé, pas par le personnel. Ils sont définitivement supprimés dans les 24 heures suivant la fin de la migration, et ne sont jamais utilisés à d'autres fins que la copie de votre site.

### Le parcours par équipe

Parlez-nous du site et du calendrier que vous préférez. Un ingénieur de migration vous répond sous quatre heures ouvrées avec un plan, et rien n'est mis en ligne sans votre approbation.

## Que se passe-t-il ensuite

Quel que soit le parcours choisi, la structure reste la même :

1. La copie s'exécute en arrière-plan. Votre site existant reste en ligne et inchangé pendant toute la durée du processus.
2. Votre nouveau site devient consultable à une adresse temporaire.
3. Vous le vérifiez et vous l'approuvez.
4. Ce n'est qu'à ce moment que le DNS change.

Votre site d'origine reste inchangé chez votre ancien hébergeur, et vous disposez d'une fenêtre de retour en arrière de 7 jours : pendant sept jours après la mise en ligne de votre site, un clic sur la page de migration (**Revenir chez votre hébergeur précédent**) ramène votre domaine vers lui, ou affiche les enregistrements exacts à restaurer si votre DNS est géré chez votre propre registraire. Consultez [Changer d'avis après la mise en ligne](https://support.kapsulehost.com/fr-fr/migrations-overview). Conservez votre ancien hébergement pendant au moins ces sept jours.

## Vérifier avant de basculer

C'est l'étape à prendre au sérieux, car une fois le DNS déplacé, chaque visiteur verra exactement ce que vous avez approuvé.

Chargez l'adresse temporaire et vérifiez :

- La page d'accueil et deux ou trois pages profondes.
- Les images, y compris celles d'un diaporama ou d'une galerie.
- Tout formulaire de contact ou de réservation, soumis pour de vrai.
- La connexion à l'administration, et une modification enregistrée.
- Sur une boutique : une commande test complète jusqu'à la page de confirmation.

Si certaines URL pointent encore vers l'ancien domaine, effectuez une recherche et un remplacement : [Effectuer une recherche et un remplacement](https://support.kapsulehost.com/fr-fr/wordpress-search-replace).

## Pointer votre domaine

Lorsque la vérification est concluante, déplacez le domaine. Vous pouvez soit changer vos serveurs de noms vers ceux de KapsuleHost, ce qui est l'option la plus simple et intègre la gestion DNS dans KPanel, soit conserver votre fournisseur DNS actuel et repointer les enregistrements du site.

Les instructions complètes se trouvent dans [Changer vos serveurs de noms](https://support.kapsulehost.com/fr-fr/nameservers) et [Connecter un domaine personnalisé à votre site web](https://support.kapsulehost.com/fr-fr/custom-domain-for-website).

Les changements DNS mettent entre quelques minutes et quelques heures pour atteindre tout le monde. Pendant cette fenêtre, certains visiteurs arriveront encore sur l'ancien hébergeur, ce qui est précisément la raison pour laquelle vous le gardez actif.

> **Tip:** Pointez votre domaine un matin de semaine calme, pas un vendredi soir. Si un ajustement est nécessaire, vous voulez être éveillé et vous voulez pouvoir nous joindre.

## Migrer manuellement

Si vous préférez le faire vous-même, ou si le site n'est pas sur une plateforme prise en charge, la méthode manuelle fonctionne toujours.

### 1. Créer le site

**Sites web**, puis **Ajouter un site web**, puis **Nouveau site web**. Choisissez le type de site qui correspond à ce que vous migrez. Le site est provisionné sur une adresse temporaire que vous pouvez tester immédiatement. Voir [Créer votre premier site web](https://support.kapsulehost.com/fr-fr/creating-your-first-website).

### 2. Exporter depuis cPanel

Téléchargez les fichiers du site, soit via le Gestionnaire de fichiers de cPanel, soit par FTP. Pour WordPress, il s'agit de tout ce qui se trouve sous `public_html`, y compris `wp-config.php`. L'assistant de sauvegarde de cPanel produit l'ensemble sous forme d'un seul téléchargement si vous le préférez.

Exportez ensuite la base de données : ouvrez phpMyAdmin dans cPanel, sélectionnez la base de données, puis utilisez **Exporter**, puis **Rapide**, puis **Exécuter**.

### 3. Téléverser les fichiers

1. Dans KPanel, ouvrez votre nouveau site, puis **Paramètres**, puis **SFTP**.
2. Sous **Comptes SFTP**, saisissez un nom d'utilisateur et cliquez sur **Créer**.
3. Copiez l'hôte, le port, le nom d'utilisateur et le mot de passe affichés. Le mot de passe n'est affiché qu'une seule fois et ne peut pas être récupéré par la suite.
4. Connectez-vous avec n'importe quel client SFTP et téléversez vos fichiers dans le répertoire du site.

Les détails complets sur le compte SFTP et l'accès SSH natif se trouvent dans [Se connecter via SFTP](https://support.kapsulehost.com/fr-fr/sftp-access).

### 4. Importer la base de données

1. Ouvrez le site, puis **Base de données**.
2. Cliquez sur **Ouvrir phpMyAdmin**. Vous êtes connecté automatiquement, sans mot de passe séparé.
3. Sélectionnez votre base de données, cliquez sur **Importer**, choisissez le fichier `.sql`, et cliquez sur **Exécuter**.

Voir [Accéder à votre base de données avec phpMyAdmin](https://support.kapsulehost.com/fr-fr/sites-phpmyadmin) pour les limites d'importation et la manière de gérer un fichier d'export volumineux.

### 5. Mettre à jour wp-config.php

L'onglet Base de données répertorie les nouveaux détails de connexion. Copiez-les dans `wp-config.php` en utilisant **Paramètres**, puis **Gestionnaire de fichiers** :

```php
define( 'DB_NAME', 'your-new-database-name' );
define( 'DB_USER', 'your-new-database-user' );
define( 'DB_PASSWORD', 'your-new-password' );
define( 'DB_HOST', '127.0.0.1' );
```

> **Warning:** Ne reportez pas les règles `.htaccess` de l'ancien hébergeur. KapsuleHost n'utilise pas Apache, ces règles ne s'exécuteront donc pas et pourraient vous faire croire à tort qu'une redirection est en place alors que ce n'est pas le cas. Recréez-les plutôt dans KPanel : [Comprendre le fichier .htaccess sur KapsuleHost](https://support.kapsulehost.com/fr-fr/wordpress-htaccess).

### 6. Tester, puis repointer

Chargez l'adresse temporaire, parcourez la liste de vérification ci-dessus, puis pointez votre domaine.

## Dépannage

**Le site se charge mais n'a aucun style.** D'anciennes URL absolues subsistent dans la base de données. Effectuez une recherche et un remplacement de l'ancienne adresse vers la nouvelle.

**« Erreur lors de l'établissement d'une connexion à la base de données ».** Les identifiants dans `wp-config.php` ne correspondent pas à ceux de l'onglet Base de données. Vérifiez que `DB_HOST` est `127.0.0.1`.

**L'importation de la base de données échoue en cours de route.** Le fichier d'export dépasse la limite de téléversement de phpMyAdmin. Compressez-le en `.sql.gz`, divisez-le en fichiers plus petits, ou ouvrez un ticket et nous l'importerons pour vous.

**Certaines pages renvoient une erreur 404 après le déplacement.** Videz les règles de réécriture : **WordPress**, puis **Actions rapides**, puis **Vider les redirections**. Voir [Résoudre les problèmes de permaliens WordPress](https://support.kapsulehost.com/fr-fr/wordpress-permalink-issues).

**Le cadenas est manquant ou affiche un avertissement.** Du contenu mixte provenant d'URL en HTTP subsiste dans la base de données : [Résoudre les avertissements de contenu mixte](https://support.kapsulehost.com/fr-fr/ssl-mixed-content).