PHP — Les bases

Guide 02 / 4

Les essentiels de PHP

Un aide-mémoire expliqué : à quoi sert chaque élément, comment l’écrire et quand l’utiliser.

Résultat attendu :

Choisir et utiliser les éléments essentiels pour réaliser cette étape du blog.

Lecture
0%

01 · Écrire les traitements essentiels

Reprendre les notions de programmation avec la syntaxe PHP.

Balises PHP, echo et interpolation

Le serveur exécute le code entre <?php et ?>. echo écrit dans la réponse ; <?= … ?> est son raccourci dans un modèle HTML.

<?php $titre = "Soupe"; ?>
<h1><?= htmlspecialchars($titre, ENT_QUOTES, "UTF-8") ?></h1>
À retenir :

Dans un fichier exclusivement PHP, omettre ?> évite les espaces de sortie accidentels.

Concaténation et comparaison stricte

Le point assemble des chaînes. === compare le type et la valeur ; !== sert notamment à distinguer false d’une position 0.

echo "Durée : " . 20 . " minutes";
var_dump(0 !== false); // true

if, foreach et syntaxe de modèle

if choisit une branche. foreach parcourt les recettes. Dans le HTML, : et endforeach rendent les blocs plus faciles à repérer.

<?php foreach ($recettes as $recette): ?>
  <h2><?= h($recette["titre"]) ?></h2>
<?php endforeach; ?>
À retenir :

Cet extrait suppose la fonction h définie dans includes/functions.php.

require, return et __DIR__

require charge un fichier nécessaire et arrête le script s’il manque. __DIR__ donne le répertoire du fichier courant. Un fichier de données peut renvoyer un tableau avec return.

$recettes = require __DIR__ . '/../includes/recettes.php';
À retenir :

Depuis public/index.php, ../ remonte vers mini-blog/. Aucun chemin de fichier ne doit provenir directement de la saisie utilisateur.

array_filter et use

array_filter garde les éléments pour lesquels la fonction renvoie true. use rend une variable extérieure disponible dans une fonction anonyme.

$recettes = array_filter($recettes, function (array $recette) use ($q): bool {
    return mb_stripos($recette['titre'], $q, 0, 'UTF-8') !== false;
});
À retenir :

mb_stripos peut renvoyer 0 si le mot est au début : comparer à false strictement.

02 · Vérifier les entrées et afficher les sorties

Les contrôles HTML aident l’utilisateur ; le serveur applique les règles.

??, is_string et trim

?? fournit une valeur par défaut si une clé manque ou vaut null. is_string rejette les formes inattendues comme titre[]. trim retire les espaces aux extrémités.

$valeur = $_POST['titre'] ?? '';
$titre = is_string($valeur) ? trim($valeur) : '';
À retenir :

La fonction texte des exemples complets regroupe ces opérations.

filter_var et entier borné

FILTER_VALIDATE_INT vérifie qu’une donnée représente un entier. Les bornes traduisent la règle métier ; false indique l’échec.

$duree = filter_var('20', FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 1, 'max_range' => 1440],
]);
if ($duree === false) { echo 'Durée invalide'; }

mb_strlen pour la longueur du titre

mb_strlen compte les caractères d’une chaîne UTF-8 plutôt que les octets. L’atelier accepte entre 3 et 120 caractères.

if (mb_strlen($titre, 'UTF-8') < 3 || mb_strlen($titre, 'UTF-8') > 120) {
    $erreurs[] = 'Le titre doit contenir entre 3 et 120 caractères.';
}
À retenir :

L’extension mbstring est requise. Un accent peut occuper plusieurs octets sans être plusieurs caractères.

htmlspecialchars et fonction h

La fonction h centralise l’échappement pour les contextes texte HTML et attribut HTML entre guillemets. On conserve le texte brut dans les données.

function h(string $valeur): string
{
    return htmlspecialchars($valeur, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
À retenir :

Cette fonction n’est pas un échappement universel pour JavaScript, CSS ou une URL arbitraire.

explode et listes HTML

explode sépare une chaîne selon un délimiteur. Les ingrédients et étapes utilisent une ligne par élément pour garder un modèle simple et compatible avec le futur SQL.

<?php foreach (explode("\n", $recette["ingredients"]) as $ligne): ?>
  <li><?= h($ligne) ?></li>
<?php endforeach; ?>

Commandes de travail local

Exécuter depuis mini-blog/. -l vérifie la syntaxe d’un fichier ; -S lance un serveur de développement ; -t limite sa racine publique.

php -v
php -m
php -l public/index.php
php -S 127.0.0.1:8000 -t public
À retenir :

Ouvrir http://127.0.0.1:8000/index.php. Le serveur intégré sert au développement local.