Objectif du TP : créer un mini CRUD PHP SQL

Dans cette formation, on va créer une mini application PHP qui permet de gérer des contacts. C’est volontairement simple, mais c’est exactement la base de beaucoup de projets : espace admin, gestion de produits, blog, formations, clients, commandes, inscriptions.

CRUD veut dire : Create ajouter, Read lire, Update modifier, Delete supprimer.

contacts/
├── config/
│   └── pdo.php
├── includes/
│   ├── functions.php
│   ├── header.php
│   └── footer.php
├── public/
│   ├── index.php
│   ├── create.php
│   ├── edit.php
│   ├── delete.php
│   └── view.php
└── database.sql

Pourquoi commencer par des contacts ?

Parce qu’un contact contient des champs simples : prénom, nom, email, téléphone, message. C’est parfait pour apprendre sans se perdre.

Créer la base SQL dans phpMyAdmin

Ouvrez phpMyAdmin, allez dans l’onglet SQL, puis collez ce code. Il crée une base et une table contacts.

CREATE DATABASE IF NOT EXISTS tp_php_sql
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;

USE tp_php_sql;

CREATE TABLE contacts (
    id INT UNSIGNED NOT NULL AUTO_INCREMENT,
    firstname VARCHAR(100) NOT NULL,
    lastname VARCHAR(100) NOT NULL,
    email VARCHAR(190) NOT NULL,
    phone VARCHAR(30) DEFAULT NULL,
    message TEXT DEFAULT NULL,
    is_active TINYINT(1) NOT NULL DEFAULT 1,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT NULL,
    PRIMARY KEY (id),
    UNIQUE KEY unique_email (email)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

Ajouter quelques données de test

INSERT INTO contacts (firstname, lastname, email, phone, message) VALUES
('Julie', 'Martin', 'julie@example.com', '0600000001', 'Premier contact de test'),
('Karim', 'Bernard', 'karim@example.com', '0600000002', 'Deuxième contact de test'),
('Meryem', 'Durand', 'meryem@example.com', NULL, 'Contact sans téléphone');

Vérifier que tout fonctionne

SELECT *
FROM contacts
ORDER BY id DESC;

Créer la connexion PDO

PDO permet à PHP de parler avec MySQL. On commence par créer un fichier de connexion réutilisable.

<?php
declare(strict_types=1);

$host = 'localhost';
$dbname = 'tp_php_sql';
$username = 'root';
$password = '';

try {
    $pdo = new PDO(
        "mysql:host=$host;dbname=$dbname;charset=utf8mb4",
        $username,
        $password,
        [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES => false,
        ]
    );
} catch (PDOException $e) {
    http_response_code(500);
    exit('Impossible de se connecter à la base de données.');
}
?>

Tester la connexion

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';

echo 'Connexion réussie à MySQL.';
?>

Si la page affiche "Connexion réussie", votre PHP communique bien avec MySQL.

Créer les fonctions utiles

Avant de créer les pages, on prépare quelques fonctions simples : échapper l’affichage, rediriger, lire une valeur de formulaire.

<?php
declare(strict_types=1);

function e(?string $value): string
{
    return htmlspecialchars((string) $value, ENT_QUOTES, 'UTF-8');
}

function redirect(string $path): never
{
    header('Location: ' . $path);
    exit;
}

function post_string(string $key): string
{
    return trim((string) ($_POST[$key] ?? ''));
}

function get_int(string $key): int
{
    return (int) ($_GET[$key] ?? 0);
}
?>

Pourquoi utiliser e() ?

Parce qu’une donnée venant d’un formulaire ou d’une base ne doit jamais être affichée directement. e() évite d’injecter du HTML ou du JavaScript dangereux dans la page.

<p><?= e($contact['firstname']) ?></p>

Créer un header et un footer simples

On évite de répéter le HTML de base dans chaque fichier.

<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title><?= e($pageTitle ?? 'TP PHP SQL') ?></title>
</head>
<body>
    <header>
        <nav>
            <a href="index.php">Liste</a>
            <a href="create.php">Ajouter</a>
        </nav>
    </header>

    <footer>
        <p>TP PHP SQL - CRUD simple</p>
    </footer>
</body>
</html>

Important

Dans ce TP, le design est volontairement minimal. Le but est de comprendre PHP + SQL. Le CSS pourra venir ensuite.

READ : afficher la liste des contacts

Première étape du CRUD : afficher les données existantes avec un SELECT.

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$pageTitle = 'Liste des contacts';

$stmt = $pdo->query("
    SELECT id, firstname, lastname, email, phone, created_at
    FROM contacts
    WHERE is_active = 1
    ORDER BY id DESC
");

$contacts = $stmt->fetchAll();

require_once __DIR__ . '/../includes/header.php';
?>

<main>
    <h1>Liste des contacts</h1>

    <p>
        <a href="create.php">Ajouter un contact</a>
    </p>

    <?php if (!$contacts): ?>
        <p>Aucun contact pour le moment.</p>
    <?php else: ?>
        <table border="1" cellpadding="8">
            <thead>
                <tr>
                    <th>ID</th>
                    <th>Nom</th>
                    <th>Email</th>
                    <th>Téléphone</th>
                    <th>Actions</th>
                </tr>
            </thead>

            <tbody>
                <?php foreach ($contacts as $contact): ?>
                    <tr>
                        <td><?= (int) $contact['id'] ?></td>
                        <td><?= e($contact['firstname'] . ' ' . $contact['lastname']) ?></td>
                        <td><?= e($contact['email']) ?></td>
                        <td><?= e($contact['phone'] ?: '-') ?></td>
                        <td>
                            <a href="view.php?id=<?= (int) $contact['id'] ?>">Voir</a>
                            <a href="edit.php?id=<?= (int) $contact['id'] ?>">Modifier</a>
                            <a href="delete.php?id=<?= (int) $contact['id'] ?>">Supprimer</a>
                        </td>
                    </tr>
                <?php endforeach; ?>
            </tbody>
        </table>
    <?php endif; ?>
</main>

<?php require_once __DIR__ . '/../includes/footer.php'; ?>

Ce que fait cette page

Elle se connecte à la base, récupère les contacts actifs, puis les affiche dans un tableau HTML.

READ : afficher une fiche détail

Maintenant, on crée une page pour voir un seul contact grâce à son id dans l’URL.

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$id = get_int('id');

$stmt = $pdo->prepare("
    SELECT id, firstname, lastname, email, phone, message, created_at, updated_at
    FROM contacts
    WHERE id = :id
      AND is_active = 1
    LIMIT 1
");

$stmt->execute([
    'id' => $id,
]);

$contact = $stmt->fetch();

if (!$contact) {
    http_response_code(404);
    exit('Contact introuvable.');
}

$pageTitle = 'Contact : ' . $contact['firstname'];

require_once __DIR__ . '/../includes/header.php';
?>

<main>
    <h1><?= e($contact['firstname'] . ' ' . $contact['lastname']) ?></h1>

    <p><strong>Email :</strong> <?= e($contact['email']) ?></p>
    <p><strong>Téléphone :</strong> <?= e($contact['phone'] ?: '-') ?></p>
    <p><strong>Message :</strong></p>
    <p><?= nl2br(e($contact['message'])) ?></p>

    <p>
        <a href="edit.php?id=<?= (int) $contact['id'] ?>">Modifier</a>
        <a href="index.php">Retour à la liste</a>
    </p>
</main>

<?php require_once __DIR__ . '/../includes/footer.php'; ?>

Pourquoi une requête préparée ?

Même si on caste l’id en entier, on utilise une requête préparée. C’est une bonne habitude à prendre.

CREATE : créer le formulaire d’ajout

On crée maintenant un formulaire HTML pour ajouter un contact. Pour l’instant, on prépare les champs et la logique de validation.

<form method="post" action="">
    <div>
        <label for="firstname">Prénom</label>
        <input type="text" id="firstname" name="firstname" required>
    </div>

    <div>
        <label for="lastname">Nom</label>
        <input type="text" id="lastname" name="lastname" required>
    </div>

    <div>
        <label for="email">Email</label>
        <input type="email" id="email" name="email" required>
    </div>

    <div>
        <label for="phone">Téléphone</label>
        <input type="tel" id="phone" name="phone">
    </div>

    <div>
        <label for="message">Message</label>
        <textarea id="message" name="message"></textarea>
    </div>

    <button type="submit">Ajouter</button>
</form>

Champs importants

L’attribut name est essentiel. C’est lui qui permet à PHP de retrouver la valeur dans $_POST.

CREATE : insérer en base avec INSERT

Maintenant, on relie le formulaire à MySQL avec un INSERT INTO.

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$pageTitle = 'Ajouter un contact';
$errors = [];

$firstname = '';
$lastname = '';
$email = '';
$phone = '';
$message = '';

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $firstname = post_string('firstname');
    $lastname = post_string('lastname');
    $email = strtolower(post_string('email'));
    $phone = post_string('phone');
    $message = post_string('message');

    if ($firstname === '') {
        $errors[] = 'Le prénom est obligatoire.';
    }

    if ($lastname === '') {
        $errors[] = 'Le nom est obligatoire.';
    }

    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        $errors[] = 'L’email est invalide.';
    }

    if (!$errors) {
        $stmt = $pdo->prepare("
            INSERT INTO contacts (
                firstname,
                lastname,
                email,
                phone,
                message,
                created_at
            ) VALUES (
                :firstname,
                :lastname,
                :email,
                :phone,
                :message,
                NOW()
            )
        ");

        try {
            $stmt->execute([
                'firstname' => $firstname,
                'lastname' => $lastname,
                'email' => $email,
                'phone' => $phone !== '' ? $phone : null,
                'message' => $message !== '' ? $message : null,
            ]);

            redirect('index.php');
        } catch (PDOException $e) {
            $errors[] = 'Impossible d’ajouter ce contact. L’email existe peut-être déjà.';
        }
    }
}

require_once __DIR__ . '/../includes/header.php';
?>

<main>
    <h1>Ajouter un contact</h1>

    <?php if ($errors): ?>
        <ul>
            <?php foreach ($errors as $error): ?>
                <li><?= e($error) ?></li>
            <?php endforeach; ?>
        </ul>
    <?php endif; ?>

    <form method="post" action="">
        <div>
            <label for="firstname">Prénom</label>
            <input type="text" id="firstname" name="firstname" value="<?= e($firstname) ?>" required>
        </div>

        <div>
            <label for="lastname">Nom</label>
            <input type="text" id="lastname" name="lastname" value="<?= e($lastname) ?>" required>
        </div>

        <div>
            <label for="email">Email</label>
            <input type="email" id="email" name="email" value="<?= e($email) ?>" required>
        </div>

        <div>
            <label for="phone">Téléphone</label>
            <input type="tel" id="phone" name="phone" value="<?= e($phone) ?>">
        </div>

        <div>
            <label for="message">Message</label>
            <textarea id="message" name="message"><?= e($message) ?></textarea>
        </div>

        <button type="submit">Ajouter le contact</button>
    </form>

    <p><a href="index.php">Retour à la liste</a></p>
</main>

<?php require_once __DIR__ . '/../includes/footer.php'; ?>

Ce qu’il faut comprendre

Le formulaire envoie les données en POST. PHP nettoie les valeurs, valide les champs, puis insère en base avec une requête préparée.

UPDATE : préremplir un formulaire de modification

Pour modifier un contact, on doit d’abord récupérer ses données existantes puis les afficher dans le formulaire.

<?php
$id = get_int('id');

$stmt = $pdo->prepare("
    SELECT id, firstname, lastname, email, phone, message
    FROM contacts
    WHERE id = :id
      AND is_active = 1
    LIMIT 1
");

$stmt->execute([
    'id' => $id,
]);

$contact = $stmt->fetch();

if (!$contact) {
    http_response_code(404);
    exit('Contact introuvable.');
}
?>

<input
    type="text"
    id="firstname"
    name="firstname"
    value="<?= e($contact['firstname']) ?>"
    required
>

<textarea id="message" name="message"><?= e($contact['message']) ?></textarea>

UPDATE : modifier en base avec UPDATE

Voici la page complète pour modifier un contact.

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$id = get_int('id');
$errors = [];

$stmt = $pdo->prepare("
    SELECT id, firstname, lastname, email, phone, message
    FROM contacts
    WHERE id = :id
      AND is_active = 1
    LIMIT 1
");

$stmt->execute([
    'id' => $id,
]);

$contact = $stmt->fetch();

if (!$contact) {
    http_response_code(404);
    exit('Contact introuvable.');
}

$firstname = (string) $contact['firstname'];
$lastname = (string) $contact['lastname'];
$email = (string) $contact['email'];
$phone = (string) ($contact['phone'] ?? '');
$message = (string) ($contact['message'] ?? '');

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $firstname = post_string('firstname');
    $lastname = post_string('lastname');
    $email = strtolower(post_string('email'));
    $phone = post_string('phone');
    $message = post_string('message');

    if ($firstname === '') {
        $errors[] = 'Le prénom est obligatoire.';
    }

    if ($lastname === '') {
        $errors[] = 'Le nom est obligatoire.';
    }

    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        $errors[] = 'L’email est invalide.';
    }

    if (!$errors) {
        $stmt = $pdo->prepare("
            UPDATE contacts
            SET firstname = :firstname,
                lastname = :lastname,
                email = :email,
                phone = :phone,
                message = :message,
                updated_at = NOW()
            WHERE id = :id
            LIMIT 1
        ");

        try {
            $stmt->execute([
                'firstname' => $firstname,
                'lastname' => $lastname,
                'email' => $email,
                'phone' => $phone !== '' ? $phone : null,
                'message' => $message !== '' ? $message : null,
                'id' => $id,
            ]);

            redirect('view.php?id=' . $id);
        } catch (PDOException $e) {
            $errors[] = 'Impossible de modifier ce contact. L’email existe peut-être déjà.';
        }
    }
}

$pageTitle = 'Modifier un contact';

require_once __DIR__ . '/../includes/header.php';
?>

<main>
    <h1>Modifier le contact</h1>

    <?php if ($errors): ?>
        <ul>
            <?php foreach ($errors as $error): ?>
                <li><?= e($error) ?></li>
            <?php endforeach; ?>
        </ul>
    <?php endif; ?>

    <form method="post" action="">
        <div>
            <label for="firstname">Prénom</label>
            <input type="text" id="firstname" name="firstname" value="<?= e($firstname) ?>" required>
        </div>

        <div>
            <label for="lastname">Nom</label>
            <input type="text" id="lastname" name="lastname" value="<?= e($lastname) ?>" required>
        </div>

        <div>
            <label for="email">Email</label>
            <input type="email" id="email" name="email" value="<?= e($email) ?>" required>
        </div>

        <div>
            <label for="phone">Téléphone</label>
            <input type="tel" id="phone" name="phone" value="<?= e($phone) ?>">
        </div>

        <div>
            <label for="message">Message</label>
            <textarea id="message" name="message"><?= e($message) ?></textarea>
        </div>

        <button type="submit">Enregistrer</button>
    </form>

    <p><a href="view.php?id=<?= $id ?>">Annuler</a></p>
</main>

<?php require_once __DIR__ . '/../includes/footer.php'; ?>

DELETE : supprimer un contact simplement

Pour supprimer, on peut utiliser DELETE, mais il faut être prudent.

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$id = get_int('id');

$stmt = $pdo->prepare("
    DELETE FROM contacts
    WHERE id = :id
    LIMIT 1
");

$stmt->execute([
    'id' => $id,
]);

redirect('index.php');
?>

Problème

Cette suppression est directe. L’utilisateur clique et la ligne disparaît. Pour un vrai projet, il vaut mieux demander confirmation.

DELETE : supprimer avec confirmation

Version plus propre : une page affiche le contact, puis demande confirmation via un formulaire POST.

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$id = get_int('id');

$stmt = $pdo->prepare("
    SELECT id, firstname, lastname, email
    FROM contacts
    WHERE id = :id
      AND is_active = 1
    LIMIT 1
");

$stmt->execute([
    'id' => $id,
]);

$contact = $stmt->fetch();

if (!$contact) {
    http_response_code(404);
    exit('Contact introuvable.');
}

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $stmt = $pdo->prepare("
        DELETE FROM contacts
        WHERE id = :id
        LIMIT 1
    ");

    $stmt->execute([
        'id' => $id,
    ]);

    redirect('index.php');
}

$pageTitle = 'Supprimer un contact';

require_once __DIR__ . '/../includes/header.php';
?>

<main>
    <h1>Supprimer ce contact ?</h1>

    <p>
        Vous allez supprimer :
        <strong><?= e($contact['firstname'] . ' ' . $contact['lastname']) ?></strong>
        (<?= e($contact['email']) ?>)
    </p>

    <form method="post" action="">
        <button type="submit">Oui, supprimer</button>
        <a href="index.php">Annuler</a>
    </form>
</main>

<?php require_once __DIR__ . '/../includes/footer.php'; ?>

DELETE : suppression logique avec is_active

Dans beaucoup de projets, on évite de supprimer vraiment. On passe simplement is_active à 0.

<?php
$stmt = $pdo->prepare("
    UPDATE contacts
    SET is_active = 0,
        updated_at = NOW()
    WHERE id = :id
    LIMIT 1
");

$stmt->execute([
    'id' => $id,
]);
?>

Avantage

La donnée reste en base. On peut l’archiver, la restaurer ou garder un historique.

SELECT *
FROM contacts
WHERE is_active = 1
ORDER BY id DESC;

UPDATE contacts
SET is_active = 1,
    updated_at = NOW()
WHERE id = 3
LIMIT 1;

Ajouter une recherche simple

On ajoute un champ de recherche pour filtrer les contacts par prénom, nom ou email.

<form method="get" action="index.php">
    <label for="q">Recherche</label>
    <input type="search" id="q" name="q" value="<?= e($_GET['q'] ?? '') ?>" placeholder="Nom, prénom ou email">
    <button type="submit">Rechercher</button>
</form>

<?php
$q = trim((string) ($_GET['q'] ?? ''));

if ($q !== '') {
    $stmt = $pdo->prepare("
        SELECT id, firstname, lastname, email, phone, created_at
        FROM contacts
        WHERE is_active = 1
          AND (
              firstname LIKE :q
              OR lastname LIKE :q
              OR email LIKE :q
          )
        ORDER BY id DESC
    ");

    $stmt->execute([
        'q' => '%' . $q . '%',
    ]);
} else {
    $stmt = $pdo->query("
        SELECT id, firstname, lastname, email, phone, created_at
        FROM contacts
        WHERE is_active = 1
        ORDER BY id DESC
    ");
}

$contacts = $stmt->fetchAll();
?>

Exercice

Ajoutez aussi la recherche sur le champ phone.

OR phone LIKE :q

Ajouter une pagination simple

Quand il y a beaucoup de contacts, on ne veut pas tout afficher d’un coup. On utilise LIMIT et OFFSET.

<?php
$page = max(1, (int) ($_GET['page'] ?? 1));
$perPage = 10;
$offset = ($page - 1) * $perPage;

$stmt = $pdo->prepare("
    SELECT id, firstname, lastname, email
    FROM contacts
    WHERE is_active = 1
    ORDER BY id DESC
    LIMIT :limit OFFSET :offset
");

$stmt->bindValue(':limit', $perPage, PDO::PARAM_INT);
$stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
$stmt->execute();

$contacts = $stmt->fetchAll();
?>

<p>
    <?php if ($page > 1): ?>
        <a href="?page=<?= $page - 1 ?>">Page précédente</a>
    <?php endif; ?>

    <a href="?page=<?= $page + 1 ?>">Page suivante</a>
</p>

Important

Pour une pagination parfaite, il faut aussi compter le nombre total de lignes. Mais cette version suffit pour comprendre le principe.

Ajouter des messages de succès avec session

Après un ajout, une modification ou une suppression, on peut afficher un message de confirmation.

<?php
session_start();
?>

<?php
$_SESSION['flash'] = 'Contact ajouté avec succès.';
redirect('index.php');
?>

<?php if (!empty($_SESSION['flash'])): ?>
    <p><?= e($_SESSION['flash']) ?></p>
    <?php unset($_SESSION['flash']); ?>
<?php endif; ?>

Exercice

Ajoutez un message après modification et après suppression.

Protéger les formulaires avec un token CSRF

Un token CSRF permet de vérifier qu’un formulaire vient bien de votre site. C’est important pour les actions sensibles : ajout, modification, suppression.

<?php
function csrf_token(): string
{
    if (empty($_SESSION['csrf'])) {
        $_SESSION['csrf'] = bin2hex(random_bytes(32));
    }

    return $_SESSION['csrf'];
}

function csrf_check(): void
{
    $token = (string) ($_POST['csrf'] ?? '');

    if (empty($_SESSION['csrf']) || !hash_equals($_SESSION['csrf'], $token)) {
        http_response_code(419);
        exit('Jeton CSRF invalide.');
    }
}
?>

<input type="hidden" name="csrf" value="<?= e(csrf_token()) ?>">

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    csrf_check();

    // traitement du formulaire
}
?>

Validation complète des champs

Avant d’insérer ou modifier, il faut vérifier proprement les données.

<?php
function validate_contact(array $data): array
{
    $errors = [];

    if (trim((string) ($data['firstname'] ?? '')) === '') {
        $errors[] = 'Le prénom est obligatoire.';
    }

    if (trim((string) ($data['lastname'] ?? '')) === '') {
        $errors[] = 'Le nom est obligatoire.';
    }

    $email = trim((string) ($data['email'] ?? ''));

    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        $errors[] = 'L’email est invalide.';
    }

    $message = trim((string) ($data['message'] ?? ''));

    if ($message !== '' && mb_strlen($message) < 10) {
        $errors[] = 'Le message doit contenir au moins 10 caractères.';
    }

    return $errors;
}
?>

<?php
$errors = validate_contact($_POST);

if (!$errors) {
    // INSERT ou UPDATE
}
?>

Pourquoi c’est mieux ?

La validation est rangée dans une fonction. On peut la réutiliser dans create.php et edit.php.

Factoriser le formulaire create/edit

Le formulaire d’ajout et de modification se ressemble beaucoup. On peut créer un fichier réutilisable.

<form method="post" action="">
    <input type="hidden" name="csrf" value="<?= e(csrf_token()) ?>">

    <div>
        <label for="firstname">Prénom</label>
        <input type="text" id="firstname" name="firstname" value="<?= e($firstname ?? '') ?>" required>
    </div>

    <div>
        <label for="lastname">Nom</label>
        <input type="text" id="lastname" name="lastname" value="<?= e($lastname ?? '') ?>" required>
    </div>

    <div>
        <label for="email">Email</label>
        <input type="email" id="email" name="email" value="<?= e($email ?? '') ?>" required>
    </div>

    <div>
        <label for="phone">Téléphone</label>
        <input type="tel" id="phone" name="phone" value="<?= e($phone ?? '') ?>">
    </div>

    <div>
        <label for="message">Message</label>
        <textarea id="message" name="message"><?= e($message ?? '') ?></textarea>
    </div>

    <button type="submit"><?= e($buttonLabel ?? 'Enregistrer') ?></button>
</form>

<?php
$buttonLabel = 'Ajouter le contact';
require_once __DIR__ . '/../includes/contact-form.php';
?>

Exercice complet : refaire le CRUD pour des produits

Maintenant que vous savez gérer des contacts, refaites la même logique pour des produits.

CREATE TABLE products (
    id INT UNSIGNED NOT NULL AUTO_INCREMENT,
    name VARCHAR(190) NOT NULL,
    slug VARCHAR(190) NOT NULL,
    price DECIMAL(10,2) NOT NULL DEFAULT 0.00,
    stock INT NOT NULL DEFAULT 0,
    is_active TINYINT(1) NOT NULL DEFAULT 1,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT NULL,
    PRIMARY KEY (id),
    UNIQUE KEY unique_slug (slug)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

Consignes

Créez les pages suivantes : products/index.php, products/create.php, products/edit.php, products/delete.php.

<?php
$stmt = $pdo->prepare("
    INSERT INTO products (name, slug, price, stock, created_at)
    VALUES (:name, :slug, :price, :stock, NOW())
");

$stmt->execute([
    'name' => $name,
    'slug' => $slug,
    'price' => $price,
    'stock' => $stock,
]);
?>

<?php
$stmt = $pdo->prepare("
    UPDATE products
    SET name = :name,
        slug = :slug,
        price = :price,
        stock = :stock,
        updated_at = NOW()
    WHERE id = :id
    LIMIT 1
");

$stmt->execute([
    'name' => $name,
    'slug' => $slug,
    'price' => $price,
    'stock' => $stock,
    'id' => $id,
]);
?>

Exercice complet : gérer des avis clients

Deuxième exercice : gérer des avis clients avec une note de 1 à 5.

CREATE TABLE reviews (
    id INT UNSIGNED NOT NULL AUTO_INCREMENT,
    author_name VARCHAR(120) NOT NULL,
    rating TINYINT UNSIGNED NOT NULL,
    content TEXT NOT NULL,
    is_active TINYINT(1) NOT NULL DEFAULT 1,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT NULL,
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

Validation attendue

<?php
$authorName = trim((string) ($_POST['author_name'] ?? ''));
$rating = (int) ($_POST['rating'] ?? 0);
$content = trim((string) ($_POST['content'] ?? ''));

$errors = [];

if ($authorName === '') {
    $errors[] = 'Le nom est obligatoire.';
}

if ($rating < 1 || $rating > 5) {
    $errors[] = 'La note doit être comprise entre 1 et 5.';
}

if (mb_strlen($content) < 10) {
    $errors[] = 'L’avis doit contenir au moins 10 caractères.';
}
?>

<label for="rating">Note</label>
<select id="rating" name="rating" required>
    <option value="">Choisir une note</option>
    <option value="1">1/5</option>
    <option value="2">2/5</option>
    <option value="3">3/5</option>
    <option value="4">4/5</option>
    <option value="5">5/5</option>
</select>

Erreurs classiques à comprendre

Voici les problèmes que vous allez forcément rencontrer au début.

Problème :
SQLSTATE[23000]: Integrity constraint violation: Duplicate entry

Cause :
Vous essayez d’insérer un email ou un slug déjà existant avec une contrainte UNIQUE.

Solution :
Afficher un message propre à l’utilisateur ou vérifier avant insertion.

Problème :
Cannot modify header information - headers already sent

Cause :
Vous avez affiché du HTML, un echo ou un espace avant header('Location: ...').

Solution :
Faire la redirection avant tout affichage, puis utiliser exit.

Problème :
Undefined variable $firstname

Cause :
Vous utilisez une variable avant de l’avoir créée.

Solution :
Initialiser la variable avant le formulaire.

Exemple :
$firstname = '';
$lastname = '';
$email = '';

Checklist avant de valider un formulaire

Avant chaque INSERT ou UPDATE, posez-vous ces questions.

1. Est-ce que le formulaire utilise method="post" ?
2. Est-ce que chaque champ possède un name ?
3. Est-ce que je récupère les données avec $_POST ?
4. Est-ce que je nettoie les données avec trim() ?
5. Est-ce que je valide les champs obligatoires ?
6. Est-ce que je valide l’email avec filter_var() ?
7. Est-ce que j’utilise une requête préparée PDO ?
8. Est-ce que j’échappe les données affichées avec htmlspecialchars() ?
9. Est-ce que je redirige après succès ?
10. Est-ce que j’affiche des erreurs compréhensibles ?

Règle simple

Une donnée utilisateur n’est jamais fiable par défaut. On la nettoie, on la valide, on l’insère avec PDO, puis on l’affiche avec e().

Projet final : mini espace admin

Pour terminer, construisez un mini espace admin qui gère plusieurs contenus.

Objectif

Créer une interface avec trois modules : contacts, produits et avis clients.

admin/
├── dashboard.php
├── contacts/
│   ├── index.php
│   ├── create.php
│   ├── edit.php
│   └── delete.php
├── products/
│   ├── index.php
│   ├── create.php
│   ├── edit.php
│   └── delete.php
└── reviews/
    ├── index.php
    ├── create.php
    ├── edit.php
    └── delete.php

Dashboard simple

<?php
declare(strict_types=1);

require_once __DIR__ . '/../config/pdo.php';
require_once __DIR__ . '/../includes/functions.php';

$totalContacts = (int) $pdo->query("SELECT COUNT(*) FROM contacts WHERE is_active = 1")->fetchColumn();
$totalProducts = (int) $pdo->query("SELECT COUNT(*) FROM products WHERE is_active = 1")->fetchColumn();
$totalReviews = (int) $pdo->query("SELECT COUNT(*) FROM reviews WHERE is_active = 1")->fetchColumn();

$pageTitle = 'Dashboard';

require_once __DIR__ . '/../includes/header.php';
?>

<main>
    <h1>Dashboard</h1>

    <ul>
        <li>Contacts actifs : <?= $totalContacts ?></li>
        <li>Produits actifs : <?= $totalProducts ?></li>
        <li>Avis actifs : <?= $totalReviews ?></li>
    </ul>

    <nav>
        <a href="contacts/index.php">Gérer les contacts</a>
        <a href="products/index.php">Gérer les produits</a>
        <a href="reviews/index.php">Gérer les avis</a>
    </nav>
</main>

<?php require_once __DIR__ . '/../includes/footer.php'; ?>

Récapitulatif du TP PHP SQL

Vous savez maintenant créer les opérations essentielles d’une application PHP reliée à MySQL.

// CREATE : ajouter
INSERT INTO contacts (firstname, lastname, email)
VALUES (:firstname, :lastname, :email);

// READ : lire
SELECT *
FROM contacts
WHERE is_active = 1;

// READ ONE : lire une fiche
SELECT *
FROM contacts
WHERE id = :id
LIMIT 1;

// UPDATE : modifier
UPDATE contacts
SET firstname = :firstname,
    lastname = :lastname,
    email = :email
WHERE id = :id
LIMIT 1;

// DELETE : supprimer définitivement
DELETE FROM contacts
WHERE id = :id
LIMIT 1;

// SOFT DELETE : désactiver
UPDATE contacts
SET is_active = 0
WHERE id = :id
LIMIT 1;

Ce que vous devez maîtriser

Les formulaires POST, les requêtes préparées, la validation, l’affichage sécurisé, les redirections, les messages de succès, la suppression avec confirmation et la séparation des fichiers.

La suite logique

Après cette formation, vous pouvez apprendre l’authentification admin, les permissions, les uploads, les relations entre tables, les transactions SQL, puis une architecture plus propre type mini MVC.