Comment insérer des données dans une base de données MySQL avec PHP

Pour les débutants en développement de sites web, il est très utile de savoir comment utiliser les scripts PHP pour se connecter à MySQL. Cela vous permet de modifier, d’afficher ou de gérer les tables de la base de données MySQL. Dans cet article, nous allons vous présenter les méthodes les plus simples pour y parvenir. C’est parti !

Pré-requis : accès et création de la base de données et de la table

Avant de commencer ce guide d’insertion de données MySQL via PHP, vous devez avoir accès à votre panneau de contrôle d’hébergement. Cette étape est nécessaire si vous ne disposez pas d’une base de données MySQL. Important ! Notez les informations d’identification de la base de données MySQL que vous venez de créer.

Création d’une table MySQL : Tout d’abord, nous devons créer une table pour vos données. Si vous en avez déjà créé un, passez à la section suivante. Nous allons créer une table nommée Etudiants pour notre base de données u000000001_nom. Lors de la création de la table, il est recommandé d’avoir une colonne ID. Elle est utilisée pour énumérer les entrées de la table et est requise lors de la configuration des relations de la table. Nous avons également marqué “A_I“, qui signifie “Auto Increment”. Cliquez sur Enregistrer et votre table sera créée.

Un nom pour votre table : Ce nom correspond généralement à l’entité (l’objet) à laquelle la table est associée dans le code / à la donnée qu’elle stockera, écrit en snake_case et au pluriel. Des attributs et leurs caractéristiques : nom, type, taille, valeur par défaut… etc.

Deux façons pour un script PHP de se connecter à MySQL

Vous pouvez utiliser deux méthodes pour INSÉRER des données dans votre base de données MySQL. Il existe deux méthodes pour se connecter à une base de données MySQL en PHP : MySQLi et PDO. MySQLi est l’acronyme de MySQL Improved. Il s’agit d’une extension exclusive de MySQL qui ajoute de nouvelles fonctionnalités à l’interface d’une base de données MySQL. MySQLi est à la fois procédural et orienté objet, le premier étant l’attribut hérité de l’ancienne version de MySQL.

Lire aussi: récupérer l'identifiant du dernier enregistrement MySQL

PDO est l’acronyme de PHP Data Object. PDO est un module, cela signifie que son code source n’est pas intégré au langage PHP lui-même, mais bien dans une bibliothèque de code annexe. Le DSN définit le type de base de données, le nom de la base de données et toute autre information relative à la base de données si nécessaire.

Quelle que soit la méthode utilisée, vous aurez besoin des informations correctes pour vous connecter à la base de données MySQL que vous avez créée. Vous avez également besoin du nom de serveur ou du nom d’hôte correct pour la configuration. Hostinger utilise “localhost” comme nom d’hôte de son serveur MySQL. En général, c’est le nom que vous voudrez utiliser si vous téléchargez votre script PHP sur le même serveur que la base de données.

Informations de connexion nécessaires

  • $servername (ou $host)
  • $database (nom de la base)
  • $username
  • $password

Important ! L’une des fonctionnalités les plus importantes qu’ils supportent tous deux est celle des instructions préparées, qui accélère le temps nécessaire à MySQL pour exécuter plusieurs fois la même requête. Elles sont également utilisées pour prévenir les attaques par injection SQL lorsque des modifications sont apportées à la base de données ou que des données fournies par l’utilisateur sont insérées dans une requête ou une instruction de la base de données.

Méthode MySQLi : connexion et insertion

La principale méthode utilisée dans ce script est mysqli_connect(). Il s’agit d’une fonction interne de PHP qui permet d’établir une nouvelle connexion avec un serveur MySQL. Au début de notre code, nous voyons quelques déclarations de variables et des valeurs assignées à ces variables. En général, nous avons besoin de quatre d’entre elles pour établir une connexion correcte à la base de données : $servername, $database, $username, et $password.

La première partie du code (lignes 3 - 18) est destinée à la connexion à la base de données. Si la connexion n’aboutit pas, la fonction die() est exécutée. Cela tue notre script et nous donne un message d’erreur de connexion que nous avons défini. Par défaut, le message d’erreur de connexion de MySQL dira Connection failed suivi d’un message d’erreur exact décrivant le problème. En revanche, si la connexion MySQL est réussie, le code affichera Connected successfully (Connecté avec succès).

Lire aussi: Modifier Activité Kbis Auto-Entrepreneur

L’instruction INSERT INTO permet d’ajouter des données dans la table de la base de données spécifiée. Les données seront ajoutées dans l’ordre spécifié. Ici, nous spécifions nos valeurs à insérer dans les colonnes spécifiées précédemment. De cette façon, chaque colonne représente une valeur spécifique. Les requêtes SQL doivent être placées entre les guillemets.

La dernière partie du code est mysqli_close, qui fermera simplement la connexion à la base de données manuellement. Si elle n’est pas spécifiée, la connexion MySQL se fermera d’elle-même à la fin du script.

Points à respecter avec MySQLi

  • Vérifiez que les variables remontent bien depuis $_POST : ce sont tes variables post qui ne sont pas récupérées si l’enregistrement ne se fait pas.
  • Évitez d’insérer des valeurs non échappées directement dans la requête pour prévenir les injections SQL.
  • Utilisez les instructions préparées si possible (MySQLi supporte mysqli_prepare et mysqli_stmt_bind_param).

Méthode PDO : connexion, préparation et insertion

Une connexion PDO à une base de données nécessite la création d’un nouvel objet PDO avec un nom de source de données (DSN), un nom d’utilisateur et un mot de passe. Comme dans l’exemple précédent, nous avons d’abord besoin d’une connexion à la base de données, ce qui se fait en créant un nouvel objet. Ce sont les variables et les valeurs que nous avons déclarées dans le fichier dbconfig.php, référencées une fois par la ligne require_once dans le fichier databaseconnect.php.

Dans cette dernière, vous trouverez le code “try…catch…”. Cela signifie que le script essaiera de se connecter à MySQL en utilisant le code fourni, mais qu’en cas de problème, le code de la section catch sera exécuté. Vous pouvez utiliser le bloc catch pour afficher des messages d’erreur de connexion ou exécuter un autre code si le bloc try échoue. Si la connexion est réussie, le message “Connected to $dbname at $host successfully” sera affiché.

PDO vous permet de préparer le code SQL avant qu’il ne soit exécuté. La requête SQL est évaluée et corrigée avant d’être exécutée. Pour prévenir la faille d’injection SQL, nous devrons écrire ce que l’on appelle une requête préparée. Comme le code SQL est syntaxiquement correct, le point-virgule fait de DROP DATABASE user_table une nouvelle requête SQL, et votre table utilisateur est supprimée si vous n’utilisez pas de requêtes préparées.

Lire aussi: INPI et Micro-Entreprise : Démarches

Sur les lignes 28, 29 et 30, nous utilisons la méthode bindParam() de l’objet de la base de données. bindParam() - Cette méthode évalue les données lorsque la méthode execute() est atteinte. bindValue() - Cette méthode évalue les données dès que la valeur bindValue() est atteinte.

Avantages de PDO

  • Supporte plusieurs SGBD avec la même interface.
  • Instructions préparées faciles à utiliser.
  • La connexion est automatiquement fermée lorsque l’objet PDO est détruit.
  • Mode exception utile pour afficher des erreurs lors du développement.

Exemple pratique : insérer des données depuis un formulaire

Généralement, on récupèrera des variables de $_POST (issues d'un formulaire) pour insérer une entrée dans la base de données. Les variables telles que $nom et $possesseur doivent avoir été définies précédemment. Pour insérer des données dans une base de données MySQL avec PHP, vous devez d’abord créer une connexion à la base de données, puis préparer et exécuter une requête SQL pour insérer les données.

En cas de problème avec la récupération de variables POST, vérifiez la partie HTML : alors ce sont tes variables post qui ne sont pas récupérées. N'y arrivant pas, j'ai créé une table test avec juste trois champs : id, nom, prénom, pour faire des essais plus courts et sans modifier mes autres tables, j'ai fait deux formulaires, un pour insérer les données et un autre pour afficher les données sous forme de tableau.

Dépannage des erreurs courantes

Pour vérifier si la connexion est réussie, accédez à votre domaine comme suit : yourdomain/databaseconnect.php. Si vous donnez un autre nom au fichier PHP, veillez à le modifier en conséquence. Vous verrez “Connected successfully” ou des variantes de ce message si tout fonctionne sans problème. Si la connexion n’a pas abouti, vous verrez quelque chose de différent. Les messages d’erreur sont légèrement différents pour MySQLi et PDO.

Erreur de mot de passe incorrect

Cette erreur se produit si l’on modifie le mot de passe ou tout autre identifiant dans le code PHP (mais pas dans la base de données). Si vous voyez un message “Accès refusé” ou “Impossible de se connecter à la base de données” accompagné de “(en utilisant le mot de passe : YES)” à la fin, la première chose à faire est de vérifier les détails de la base de données. Il peut s’agir d’une erreur de frappe ou d’une partie manquante.

Impossible de se connecter au serveur MySQL

Si vous obtenez “Can’t connect to MySQL server on ‘server’ (110)” dans MySQLi, cela signifie que le script n’a pas reçu de réponse d’un serveur. Cela se produit lorsque nous définissons “server” au lieu de “localhost” comme $servername, et que ce nom n’est pas reconnu. Le message d’erreur dans PDO ressemblera à “Connection failed : SQLSTATE[Hy000] [2002]” suivi d’autres détails indiquant que l’hôte MySQL n’a pas été trouvé.

Erreurs SQL et types

Un type de valeur étant attribué à un autre type de colonne provoquera une erreur. Par exemple, si nous essayons d’attribuer un nombre 47 dans une colonne Nom, nous obtiendrons une erreur car il est censé s’agir d’une valeur de type texte. Toutes ces erreurs peuvent être facilement corrigées en suivant les directives relatives aux messages d’erreur ou en consultant le journal des erreurs.

Il est toujours important de se rappeler une règle d’or pour dépanner une erreur : vérifier le journal des erreurs de votre site. Le journal se trouve dans le même dossier que celui où le script s’exécute. Par exemple, si nous exécutons un script dans public_html, nous trouverons le error_log dans le même dossier.

Importer des données externes : CSV et SQL via PhpMyAdmin

Le format CSV est universel. Il peut être interprété par n'importe quel gestionnaire de base de données. Pour importer ces données, encore faut-il que la base existe. L'enjeu consiste à préserver leur intégrité durant la phase d'importation. Le séparateur de liste est le point-virgule. C'est lui qui délimite les informations de champs. Les doubles côtes sont bien utilisées pour les encadrer en revanche.

Comme vous le constatez, le processus d'importation CSV peut créer des champs typés en varchar et parfois mal dimensionnés, et aucune clé primaire n'est créée automatiquement. C'est pourquoi, nous proposons de créer une table en cohérence avec les informations à recevoir. Un champ auto-incrémenté remplit parfaitement son rôle au fur et à mesure de l'insertion de nouvelles données.

La taille du fichier externe ne peut pas excéder un certain poids lors d'une importation via PhpMyAdmin (par exemple 2 Mo par défaut). Dans le cas de sites professionnels en production, les importations dans les bases de données ne sont pas rares et il faudra utiliser d'autres méthodes (import par script côté serveur, découpage, compression, import via SSH).

Bonnes pratiques et conseils

  • Utilisez des requêtes préparées (PDO ou MySQLi) pour éviter les injections SQL.
  • Activez le mode exception en PDO lors du développement : il permet d’afficher les problèmes spécifiques.
  • Ne laissez pas d’informations sensibles en clair dans un script accessible en production.
  • Vérifiez l’encodage (UTF-8) lors d’import CSV pour préserver les accents et caractères latins.
  • Définissez toujours une clé primaire (souvent AUTO_INCREMENT) pour l’unicité des enregistrements.
  • Lors de l’importation, si les champs sont mal dimensionnés, recréez une table avec des tailles adaptées avant d’importer les données.

Résumé des étapes pour insérer des données

  1. Créer ou vérifier la base de données et la table (avec un ID auto-incrémenté).
  2. Créer une connexion à la base de données (MySQLi ou PDO).
  3. Préparer la requête INSERT (utiliser des requêtes préparées).
  4. Lier les paramètres et exécuter la requête.
  5. Vérifier le résultat et consulter le journal des erreurs en cas d’échec.

Comment Insérer des données dans une base de données (PHP / SQL).

Méthode Avantages Inconvénients
MySQLi Spécifique à MySQL, API procédurale et objet Moins portable vers d'autres SGBD
PDO Portable, gestion des exceptions, requêtes préparées Requiert l'extension PDO activée

Dans ce tutoriel, vous avez appris à INSÉRER des données dans une table MySQL via PHP en utilisant MySQLi et PDO. Vous avez également appris à résoudre les erreurs de connexion les plus courantes.

balises:

Articles populaires: