PHP preg_match() : expressions régulières avec exemples

preg_match($pattern, $subject, $matches) vérifie si une chaîne correspond à une expression régulière. Elle renvoie 1 en cas de correspondance et 0 sinon, et remplit $matches avec ce qu'elle a trouvé : preg_match('/\d+/', 'Order 4521 shipped', $m) renvoie 1 et met $m[0] à "4521".

<?php
$text = 'Order 4521 shipped on 2026-03-14';

if (preg_match('/\d+/', $text, $m)) {
    echo "First number: {$m[0]}\n";
}

var_dump(preg_match('/shipped/', $text));   // found
var_dump(preg_match('/cancelled/', $text)); // not found
var_dump(preg_match('/SHIPPED/i', $text));  // i = case-insensitive

Le motif est une chaîne entourée de délimiteurs, en général /.../, suivie de modificateurs comme i. Écrivez les motifs entre guillemets simples : entre guillemets doubles, PHP développe d'abord $name et des échappements comme \x41 ou \101, si bien que le moteur de regex peut recevoir un motif différent de celui que vous avez tapé.

Groupes de capture

Les parenthèses dans un motif capturent la partie de la chaîne qu'elles trouvent. $m[0] est la correspondance complète, $m[1] le premier groupe, $m[2] le second, comptés par parenthèse ouvrante depuis la gauche.

<?php
$text = 'Shipped on 2026-03-14 at 09:30';

if (preg_match('/(\d{4})-(\d{2})-(\d{2})/', $text, $m)) {
    print_r($m);
    [, $year, $month, $day] = $m;
    echo "Day $day, month $month, year $year\n";
}

// (?: ) groups without capturing
preg_match('/(?:at|on) (\d{2}:\d{2})/', $text, $t);
print_r($t);

Groupes nommés

(?<name>...) donne un nom à un groupe. La valeur est rangée sous le nom et sous son numéro, donc le code qui lit le résultat ne casse pas quand quelqu'un ajoute un groupe plus tôt dans le motif.

<?php
$log = '[2026-03-14 09:30:12] ERROR: Disk almost full';

$pattern = '/^\[(?<date>[\d-]+) (?<time>[\d:]+)\] (?<level>\w+): (?<message>.+)$/';

if (preg_match($pattern, $log, $m)) {
    echo $m['level'], "\n";
    echo $m['message'], "\n";
    echo $m['date'], ' ', $m['time'], "\n";
}

// Keep only the named keys
print_r(array_filter($m, 'is_string', ARRAY_FILTER_USE_KEY));

Trouver toutes les correspondances avec preg_match_all

preg_match_all() continue à chercher après la première correspondance et renvoie le nombre de correspondances. Par défaut, $m[0] contient toutes les correspondances complètes et $m[1] toutes les valeurs du premier groupe. Avec PREG_SET_ORDER, vous obtenez plutôt un tableau par correspondance, plus facile à parcourir.

<?php
$text = 'Contact ana@example.com or bo@test.org, not support@';

$count = preg_match_all('/(\w+)@(\w+\.\w+)/', $text, $m);
echo "Found $count addresses\n";
print_r($m[0]);   // full matches
print_r($m[2]);   // domains

preg_match_all('/(\w+)@(\w+\.\w+)/', $text, $sets, PREG_SET_ORDER);
foreach ($sets as $s) {
    echo "user {$s[1]} at {$s[2]}\n";
}

// Every number in a string
preg_match_all('/\d+/', 'a1 b22 c333', $nums);
print_r($nums[0]);

Valider une saisie : ancres, numéros de téléphone, codes postaux

Pour une validation, le motif doit correspondre à toute la chaîne, commencez-le donc par ^ et terminez-le par $. Un piège : $ correspond aussi avant un saut de ligne final, donc '/^\d+$/' accepte "123\n". Ajoutez le modificateur D, ou utilisez \z, qui ne correspond qu'à la toute fin.

<?php
$tests = ['123', '12a', "123\n", ''];

foreach ($tests as $t) {
    printf("%-8s plain:%d  with D:%d\n",
        json_encode($t),
        preg_match('/^\d+$/', $t),
        preg_match('/^\d+$/D', $t)
    );
}

// Japanese postal code: 123-4567
var_dump(preg_match('/^\d{3}-\d{4}$/D', '150-0002'));

// US phone: (555) 123-4567 or 555-123-4567 or 5551234567
$phone = '/^(\(\d{3}\) ?|\d{3}-?)\d{3}-?\d{4}$/D';
foreach (['(555) 123-4567', '555-123-4567', '5551234567', '55-1234'] as $p) {
    echo $p, ' => ', preg_match($phone, $p), "\n";
}

Pour les adresses email, une regex rejette des adresses valides ou en accepte d'invalides. Utilisez plutôt filter_var($email, FILTER_VALIDATE_EMAIL) (voir filter_var()).

Le modificateur u pour l'UTF-8 et le texte japonais

Sans le modificateur u, un motif travaille sur des octets. Un caractère japonais fait trois octets en UTF-8, donc . correspond à un tiers de caractère et les longueurs sont fausses. Avec u, le motif travaille sur des caractères et vous pouvez utiliser des classes de propriétés Unicode.

<?php
$word = '日本語';

var_dump(preg_match('/^.{3}$/', $word));   // bytes: 9, no match
var_dump(preg_match('/^.{3}$/u', $word));  // characters: 3, match

$text = 'PHPで正規表現を使う';
preg_match_all('/\p{Han}+/u', $text, $kanji);
preg_match_all('/\p{Katakana}+/u', 'コーヒーとカフェラテ', $kata);
print_r($kanji[0]);
print_r($kata[0]);

// Only hiragana (and the long vowel mark)?
var_dump(preg_match('/^[\p{Hiragana}ー]+$/uD', 'ひらがな'));

u valide aussi la chaîne : si elle n'est pas en UTF-8 valide, preg_match() renvoie false au lieu de chercher une correspondance.

Échapper une saisie utilisateur avec preg_quote

Des caractères comme ., +, ?, ( et / ont un sens particulier dans un motif. Si une partie du motif vient d'une variable, comme un terme de recherche, passez-la dans preg_quote() avec le délimiteur en second argument, sinon 1+1 correspondra à 11 et un / non échappé cassera le motif.

<?php
$search = '1+1';
$text = 'Is 11 the answer? No, 1+1 is 2.';

// Wrong: + means "one or more"
preg_match('/' . $search . '/', $text, $bad);
echo "Unescaped matched: {$bad[0]}\n";

// Right
$pattern = '/' . preg_quote($search, '/') . '/';
echo "Pattern: $pattern\n";
preg_match($pattern, $text, $good);
echo "Escaped matched: {$good[0]}\n";

Un motif invalide ne lève pas d'exception. PHP affiche un warning et preg_match() renvoie false :

Warning: preg_match(): No ending delimiter '/' found in /path/to/index.php on line 3

Vérifiez donc === false (ou preg_last_error_msg()) quand le motif est construit à l'exécution. Pour une simple recherche de sous-chaîne sans motif, str_contains() est plus rapide et plus claire. Pour modifier le texte trouvé, utilisez preg_replace().