PHP-MySQL : lire et afficher des données

Rappels et situation

Nous avons vu un moyen de créer une base de données [DB] MySQL avec phpMyAdmin, DB que nous avons nommée "Infobrol" sur le serveur mysql5test.
Nous avons vu ensuite comment créer une table avec phpMyAdmin, table que nous avons nommée "dictionnaire".
Enfin, nous avons vu comment ajouter des données dans notre table.

Voici pour rappel la structure de notre table :

Accueil

Infobrol

dictionnaire

Base de données Infobrol - Table dictionnaire sur le serveur mysql5test

Structure

Afficher

SQL

Sélectionner

Insérer

Exporter

Opérations

Vider

Supprimer

Champ

Type

Attributs

Null

Défaut

Extra

Action

nom

varchar(64)

Non

lettre

char(1)

Non

def

text

Non

cat

varchar(32)

Non

Pour la sélection :

La base de données se nomme Infobrol.
La table qui contient les données que nous allons afficher se nomme dictionnaire.
Cette table contient les champs suivants :
- nom : contient le mot défini.
- lettre : contient la première lettre du mot défini.
  Ce champ sert principalement à accélérer les recherches pour le glossaire³.
- def : contient la définition du mot.
- cat :contient la catégorie à laquelle appartient le mot.

Ces parties conçernent la partie "administration" de la gestion des données, par un outil intégré ou extérieur à notre site. Nous allons voir maintenant comment utiliser les informations de la base de données dans nos pages Web.

Contents Haut

Structure des tables

Comme nous allons devoir manipuler des données, nous devons prendre un moment pour comprendre comment elles sont structurées dans la DB. Nous pouvons nous représenter notre structure de données comme des tableaux (les tables de la DB), qui comportent des lignes (les “records” (en français, « enregistrements »), ou encore “row”⁵) et des colonnes (les « champs »⁶)

Un enregistrement est donc une ligne de notre tableau, composée de toutes les données qui constituent une entité.

Les colonnes (les « champs »⁶) groupent toutes les données de même type et dont la signification est identique.

Contents Haut

Notre première requête

Comment aller chercher dans la DB les données que nous avons sauvé dans notre table dictionnaire ?

Comme nous l'avons vu dans les pages précédentes, PHP n'est pas un langage d'interrogation de données. Nous allons donc utiliser SQL [“Structured Query Language”⁷].

SELECT * FROM `dictionnaire`;

Majuscules et minuscules

Nous pouvons utiliser des majuscules ou des minuscules pour les commandes SQL, cela n'a pas d'importance⁹. J'ai pris l'habitude de noter les mots réservés de SQL en majuscule et les noms des tables et des champs en minuscule.

Cette requête charge tous les champs (utilisation de l'étoile après le mot SELECT) de toutes les lignes de la table dictionnaire.

Nous avons ici entouré le nom de la table par des accents aigus diacritiques¹⁰ comme le résultat de la requête généré par phpMyAdmin, mais ce n'est absolument pas nécessaire, et nous ne les emploierons plus par la suite.

SQL: ne charger que certaines colonnes

Si nous ne désirons pas charger toutes les colonnes (les champs), nous pouvons remplacer l'étoile par les champs à charger.

SELECT mot, def FROM dictionnaire;

Dans le langage des opérateurs relationnels, nous parlons de projection.

SQL: ne charger que certaines lignes

Si nous ne désirons pas charger toutes les lignes, nous pouvons procéder de deux manières :

spécifier le nombre de lignes¹¹ avec la clause LIMIT.
spécifier certaines restrictions avec la clause WHERE.

Nous allons donc adapter notre requête pour ne charger que les champs mot et def, et limiter les résultats à la lettre "a".

SELECT * FROM dictionnaire WHERE lettre='a';

Dans le langage des opérateurs relationnels, nous parlons de sélection.

Contents Haut

Exécuter la requête

Nous pouvons à présent demander à PHP d'envoyer notre commande SQL vers la DB MySQL grâce à la fonction PHP mysql_query.

Ensuite, nous avons le choix entre deux manières pour récupérer les données pour chaque ligne :

Sous la forme d'un tableau dont les indices¹² sont les noms des champs.
Sous la forme d'un objet, pour lequel chaque champ correspond à un attribut publique.

Enregistrement dans un tableau avec mysql_fetch_array

<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
		<title>Dictionnaire: lettre a</title>
	</head>
	<body>
	<h1>Mots qui débutent par la lettre "a"</h1>
	<?php   
    // Informations de connexion
    include_once('scripts/variables.php');
    $db_connection = mysql_connect(DB_SERVER, DB_LOGIN, DB_PASSWORD);
    if(empty($db_connection)){
    	echo '<p>Attention : impossible de se connecter à la DB.</p>';
    }else{
    	mysql_select_db('Infobrol');
 
    	// creation de la requete
    	$query='SELECT nom, def FROM dictionnaire WHERE lettre=\'a\';';
    	// execution de la requete
    	$result = mysql_query($query);
 
    	//fermeture de la connexion
    	mysql_close($db_connection);
 
    	// lecture des enregistrements
    	while ($fields = mysql_fetch_array($result)){
    	   // Les donnees d'un enregistrement sont dans le tableau $fields
    	   echo '<dl><dt>'.$fields['nom'].'</dt><dd>'.$fields['def'].'</dl>';
    	}
    	// liberer les ressources
    	mysql_free_result($result);
    }
	?>
	</body>
</html>

Vous pouvez cliquer ici pour afficher les exemples de codes PHP avec mysqli.

Vous pouvez cliquer ici pour afficher les exemples de codes PHP sans les balises d'une page HTML (seulement les différences).

Contents Haut

Enregistrement dans un objet avec mysql_fetch_object

<html>
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
		<title>Dictionnaire: lettre a</title>
	</head>
	<body>
	<h1>Mots qui débutent par la lettre "a"</h1>
	<?php   
    // Informations de connexion
    include_once('scripts/variables.php');
    $db_connection = mysql_connect(DB_SERVER, DB_LOGIN, DB_PASSWORD);
    if(empty($db_connection)){
    	echo '<p>Attention : impossible de se connecter à la DB.</p>';
    }else{
    	mysql_select_db('Infobrol');
 
    	// creation de la requete
    	$query='SELECT nom, def FROM dictionnaire WHERE lettre=\'a\';';
    	// execution de la requete
    	$result = mysql_query($query);
 
    	//fermeture de la connexion
    	mysql_close($db_connection);
 
    	// lecture des enregistrements
    	while ($obj = mysql_fetch_object($result)){
    	   // Les donnees d'un enregistrement sont dans l'objet $obj
    	   echo '<dl><dt>'.$obj->nom.'</dt><dd>'.$obj->def.'</dl>';
    	}
    	// liberer les ressources
    	mysql_free_result($result);
    }
	?>
	</body>
</html>

Vous pouvez cliquer ici pour afficher les exemples de codes PHP sans les balises d'une page HTML (seulement les différences).

Contents Haut

Exemple

Code php (Sélection et affichage des données) (74 lignes)

<?php   
 
// Affichage du formulaire
echo '<form name="dicoSearch" method="post">';
echo '<fieldset>';
echo '<legend>Critères de recherche</legend>';
echo '<input type="text" name="dicoLetter" />';
echo '<input type="submit" name="Submit" value="Envoyer" />';
echo '<br /><label for="dicoLetter">Veuillez entrer une lettre et cliquer sur le bouton Envoyer</label>';
echo '</fieldset>';
echo '</form>';
echo '<br /><br />';
 
// Si une valeur a été postée
if(isset($_POST['dicoLetter'])){
 
    $dicoLetter=$_POST['dicoLetter'];
 
    // On n'accepte qu'une seule lettre, entre a et Z
    if(preg_match('#^[a-z]{1}$#i', $dicoLetter)!==1){
        echo '<b>'.$dicoLetter.'</b> n\'est pas un argument valide...';
    }else{
 
        // Fichier qui contient les données nécessaires
        include('scripts/variables.php');
 
        // Fichier dans lequel on se connecte sur la DB
        include ('scripts/dbconnect.php');
 
        // Requête à exécuter
        $query = 'SELECT mot, def FROM dictionnaire WHERE lettre = \''.$dicoLetter.'\';';
        // Résultat de la requête
        $result = mysql_query($query);
 
        // Nombre de lignes trouvées
        $cnt=mysql_num_rows($result);
 
        // Fichier dans lequel on ferme la connexion
        include ('scripts/dbclose.php');
 
        // Si nous avons des résultats
        if($cnt>0){
 
            // Début de l'affichage des résultats
            echo '<div align="center">';
            echo '<table width="90%" border="0" cellpadding="2" cellspacing="1" class="table">';
            echo '<thead><tr><th>N&deg;</th><th>Mot défini</th><th>Définition</th></tr></thead>';
            echo '<tbody>';
 
            // Déclaration d'un compteur
            $k=0;
 
            // Affichage des lignes
            while($obj=mysql_fetch_object($result)){
 
                // Une ligne sur 2 est d'un style différent
                echo '<tr class="'.(($k%2==0)?'td':'td2').'">';
 
                echo '<td>'.++$k.'</td><td>'.$obj->mot.'</td><td>'.$obj->def.'</td>';
                echo '</tr>';
            }
 
            // Fin du tableau
            echo '</tbody>';
            echo '</table>';
 
        }else{
 
            // Message si une valeur a été postée mais que la requête n'a produit aucun résultat
            echo 'Aucun enregistrement ne correspond à <b>'.$dicoLetter.'</b>';
        }
    }
}
?>

Retourner au début du code

Contents Haut

Trier les résultats

Nous pouvons trier les éléments de la base de données grâce à l'instruction ORDER BY, suivie du nom du champ sur lequel porte le tri.
Cette instruction peut être suivie des options ASC ou DESC qui permettent un tri ascendant ou descendant.

La page de résultats est similaire à la précédente (nous ne présentons que les enregistrements dont le champ "lettre" est égal à la lettre demandée), mais nous permet de sélectionner le type de tri effectué sur le champ "mot", et nous présente la requête à la manière de PhpMyAdmin.

Contents Haut

Sécurité

Injection de code SQL

Ces exemples sont simples afin de les comprendre plus facilement. Mais il faut toujours sécuriser les données que l'utilisateur nous fournit.

En effet, si nous utilisons les données du formulaire sans les vérifier, une personne malveillante peut injecter du code avec les données, et par exemple vider complétement la base de données, ou récupérer des données confidentielles, etc.

English translation

You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.

If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.

Thank you in advance.

Document created the 21/11/2003, last modified the 19/04/2020
Source of the printed document:https://www.gaudry.be/en/php-mysql-select-rf-0101201808.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

Notes

↑^{a,b,c,d,e,f… 1 more links…} DataBase : corresponds to « base de données » en français
↑^{a,b,c,d,e,f… 1 more links…} DB : “DataBase” (en français, « base de données »)
↑ Champ "lettre" : Ceci va à l'encontre de la normalisation de la base de données, mais nous évite d'utiliser une requête qui comporte "LIKE", et "UCASE". Ce choix est tout à fait discutable, mais nous ne devons pas nous tracasser de ces notions pour l'instant.
↑ records : corresponds to « enregistrements » en français
↑ row : corresponds to « ligne » en français
↑^a,b champs : corresponds to “fields” en anglais
↑^a,b Structured Query Language : corresponds to « langage structuré d'interrogation » en français
↑ SQL : “Structured Query Language” (en français, « langage structuré d'interrogation »)
↑ Majuscules et minuscules : Si le serveur MySQL est sur une machine Unix ou Linux, nous devons faire attention à bien respecter les majuscules et minuscules pour les noms des tables et pour les noms des champs. Nous pouvons être plus négligents sous Windows qui ne fait pas la différence.
↑ Accents : Nous pouvons utiliser comme délimiteurs de chaînes de caractères différents guillemets et accents. Exemples :
guillemets « »
accent aigu ´
accent grave `
minutes ′
guillemet simple à gauche ‘
guillemet simple à droite ’
guillemet bas simple ‚
guillemets doubles à gauche “
guillemets doubles à droite ”
doubles guillemets bas à droite „
↑ LIMIT(0, 30) : La commande LIMIT n'est pas une commande standard en SQL, et ne fonctionne donc pas avec tous les systèmes de gestion de bases de données. MySQL reconnaît cependant cette commande LIMIT, ce qui est pratique pour faire de la pagination avec une DB.
↑ Indice d'un tableau : L'indice est l'adresse d'une cellule (une case) d'un tableau.

Contents Haut