PHP preg_match(): reguläre Ausdrücke mit Beispielen

preg_match($pattern, $subject, $matches) prüft, ob ein String zu einem regulären Ausdruck passt. Es liefert 1 bei einem Treffer und sonst 0 und füllt $matches mit dem Gefundenen: preg_match('/\d+/', 'Order 4521 shipped', $m) liefert 1 und setzt $m[0] auf "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

Das Muster ist ein String mit Begrenzern darum, meist /.../, gefolgt von Modifikatoren wie i. Schreib Muster in einfache Anführungszeichen: In doppelten erweitert PHP zuerst $name und Escapes wie \x41 oder \101, sodass die Regex-Engine ein anderes Muster bekommen kann als das, was du getippt hast.

Capture Groups

Klammern in einem Muster fangen den Teil des Strings ein, den sie treffen. $m[0] ist der ganze Treffer, $m[1] die erste Gruppe, $m[2] die zweite, gezählt nach öffnender Klammer von links.

<?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);

Benannte Gruppen

(?<name>...) gibt einer Gruppe einen Namen. Der Wert wird unter dem Namen und unter seiner Nummer gespeichert, sodass Code, der das Ergebnis liest, nicht kaputtgeht, wenn jemand weiter vorne im Muster eine Gruppe hinzufügt.

<?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));

Jeden Treffer mit preg_match_all finden

preg_match_all() sucht nach dem ersten Treffer weiter und liefert die Anzahl der Treffer. Standardmäßig enthält $m[0] alle vollständigen Treffer und $m[1] alle Werte der ersten Gruppe. Mit PREG_SET_ORDER bekommst du stattdessen ein Array pro Treffer, über das sich leichter iterieren lässt.

<?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]);

Eingaben prüfen: Anker, Telefonnummern, Postleitzahlen

Zur Validierung muss das Muster den ganzen String treffen, also beginnt es mit ^ und endet mit $. Eine Falle: $ passt auch vor einem abschließenden Zeilenumbruch, also akzeptiert '/^\d+$/' den String "123\n". Füge den Modifikator D hinzu oder verwende \z, das nur ganz am Ende passt.

<?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";
}

Bei E-Mail-Adressen lehnt ein regulärer Ausdruck entweder gültige Adressen ab oder akzeptiert ungültige. Verwende stattdessen filter_var($email, FILTER_VALIDATE_EMAIL) (siehe filter_var()).

Der Modifikator u für UTF-8 und japanischen Text

Ohne den Modifikator u arbeitet ein Muster auf Bytes. Ein japanisches Zeichen hat in UTF-8 drei Bytes, also trifft . ein Drittel eines Zeichens, und Längen stimmen nicht. Mit u arbeitet das Muster auf Zeichen, und du kannst Unicode-Eigenschaftsklassen verwenden.

<?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 validiert außerdem den String: Ist er kein gültiges UTF-8, liefert preg_match() false, statt zu treffen.

Nutzereingaben mit preg_quote escapen

Zeichen wie ., +, ?, ( und / haben in einem Muster eine besondere Bedeutung. Wenn ein Teil des Musters aus einer Variable kommt, etwa ein Suchbegriff, schick ihn durch preg_quote() mit dem Begrenzer als zweitem Argument, sonst trifft 1+1 auf 11, und ein nicht escaptes / macht das Muster kaputt.

<?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";

Ein ungültiges Muster wirft keine Exception. PHP gibt eine Warnung aus, und preg_match() liefert false:

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

Prüfe also auf === false (oder preg_last_error_msg()), wenn das Muster zur Laufzeit gebaut wird. Für eine einfache Prüfung auf einen Teilstring ganz ohne Muster ist str_contains() schneller und klarer. Um den getroffenen Text zu ändern, verwendest du preg_replace().