Aller au contenu
Atlas Hoster
Bases de données MySQL

Connecter son site PHP à MySQL : hôte, nom de base et identifiants

Mis à jour le 18 novembre 2026Vérifié sur cPanel 138 le 11 novembre 2026

Pour qu'un site PHP lise et écrive dans sa base MySQL, il lui faut quatre informations : l'hôte, le nom de la base, le nom de l'utilisateur et son mot de passe. Cet article explique où les trouver dans cPanel et comment les écrire dans votre code.

Avant de commencer

  • Vous avez déjà une base et un utilisateur lié à cette base. Sinon, créez-les d'abord avec l'article « Créer une base de données MySQL et son utilisateur dans cPanel ».
  • Vous avez la main sur les fichiers du site (gestionnaire de fichiers de cPanel ou FTP).
  • Sur un hébergement cPanel, le nom d'une base et celui d'un utilisateur commencent en général par un préfixe suivi d'un tiret bas (_), qui vient du nom de votre compte. Ce préfixe fait partie du nom : il faut le recopier.

Les étapes

  1. Ouvrez la liste de vos bases. Dans cPanel, dans la section « Bases de données », ouvrez Manage My Databases (ce libellé reste en anglais dans l'interface française). Sur les anciennes versions de cPanel, l'écran s'appelle « MySQL Databases ».
  2. Relevez le nom complet de la base. Dans le tableau Bases de données actuelles, la colonne « Base de données » donne le nom exact, préfixe compris (par exemple compte_maboutique). La colonne « Utilisateurs avec privilèges » donne le nom exact de l'utilisateur autorisé à s'en servir (par exemple compte_boutique).
  3. Retenez l'hôte : localhost. Dans le cas courant, la base est sur le même serveur que le site : l'hôte est alors localhost. Une exception, d'après la documentation cPanel : si l'écran affiche une section « Remote Database Host », c'est que la base est sur un serveur distinct. Utilisez alors l'adresse indiquée dans cette section.
  4. Retrouvez le mot de passe. cPanel ne l'affiche jamais. Si vous l'avez perdu, descendez au tableau « Utilisateurs actuels », cliquez sur Changer le mot de passe en face de l'utilisateur, saisissez-en un nouveau, puis mettez-le à jour dans le fichier de configuration de votre site.
  5. Écrivez la connexion dans votre code. Avec PDO, voici un exemple complet. Remplacez les quatre valeurs par les vôtres.
<?php
// config.php : placez ce fichier hors du dossier public si possible
$hote        = 'localhost';
$base        = 'compte_maboutique';
$utilisateur = 'compte_boutique';
$motdepasse  = 'votre-mot-de-passe';

try {
    $pdo = new PDO(
        "mysql:host=$hote;dbname=$base;charset=utf8mb4",
        $utilisateur,
        $motdepasse,
        [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
    );
} catch (PDOException $e) {
    error_log($e->getMessage());
    exit('Connexion à la base impossible.');
}

Si vous utilisez un CMS, ne touchez pas au code : modifiez les quatre valeurs dans son fichier de configuration (pour WordPress, wp-config.php, à la racine du site). 6. Testez. Ouvrez une page du site qui lit la base. Si elle s'affiche normalement, la connexion fonctionne.

<!-- ILLUSTRATION À VENIR (plan A.7) : exemple de fichier de configuration annoté ; schéma site ↔ MySQL (localhost). Rien de créé ici. -->

Résultat attendu

Le site lit et écrit dans la base sans message d'erreur. Aucun mot de passe n'apparaît dans une page publique.

En cas de problème

  • « Access denied for user… » (erreur 1044 ou 1045). L'utilisateur ou le mot de passe est faux, ou l'utilisateur n'a pas été ajouté à la base. Vérifiez la colonne « Utilisateurs avec privilèges » ; sinon, dans Manage My Databases, section « Ajouter un utilisateur à la base de données », choisissez l'utilisateur et la base, cliquez sur Ajouter, cochez ALL PRIVILEGES puis validez.
  • « Unknown database… » (erreur 1049). Le nom de la base est faux, le plus souvent parce que le préfixe est oublié. Recopiez le nom depuis le tableau.
  • Page blanche ou erreur 500. Ne montrez pas les erreurs PHP aux visiteurs : la documentation PHP demande de mettre display_errors à 0 en production, car un message peut contenir les identifiants. Lisez plutôt le journal d'erreurs du site (écran « Erreurs » de cPanel).
  • Le site marche sur votre ordinateur mais pas en ligne. Sur votre poste, la base a sûrement un autre nom, un autre utilisateur et un autre mot de passe. Reprenez les quatre valeurs de cPanel.

Questions fréquentes

Quel est l'hôte de ma base MySQL sur cPanel ? C'est localhost, sauf si l'écran Manage My Databases affiche une section « Remote Database Host » : dans ce cas, utilisez l'adresse qui y figure.

Faut-il le préfixe dans le nom de la base ? Oui. Le préfixe fait partie du nom, pour la base comme pour l'utilisateur. Recopiez les noms tels qu'ils s'affichent.

Puis-je voir mon mot de passe MySQL dans cPanel ? Non, cPanel ne le montre pas. Vous pouvez en définir un nouveau avec « Changer le mot de passe » et le reporter dans votre site.

PDO ou mysqli ? Les deux se connectent à la même base avec les mêmes quatre valeurs. Les exemples de la documentation PHP existent pour l'une et pour l'autre.

Pour aller plus loin

Votre site a besoin d'une base, de PHP et d'un espace cPanel pour tourner : découvrez notre hébergement web.

Bases de données MySQLTous les guides