PHP preg_match(): expresiones regulares con ejemplos

preg_match($pattern, $subject, $matches) comprueba si una cadena coincide con una expresión regular. Devuelve 1 si hay coincidencia y 0 si no, y rellena $matches con lo que encontró: preg_match('/\d+/', 'Order 4521 shipped', $m) devuelve 1 y pone $m[0] a "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

El patrón es una cadena con delimitadores alrededor, normalmente /.../, seguida de modificadores como i. Escribe los patrones entre comillas simples: dentro de comillas dobles PHP expande primero $name y secuencias de escape como \x41 o \101, así que el motor de expresiones regulares puede recibir un patrón distinto del que escribiste.

Grupos de captura

Los paréntesis de un patrón capturan la parte de la cadena con la que coinciden. $m[0] es la coincidencia completa, $m[1] el primer grupo y $m[2] el segundo, contados por el paréntesis de apertura desde la izquierda.

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

Grupos con nombre

(?<name>...) le da un nombre a un grupo. El valor se guarda bajo el nombre y bajo su número, así que el código que lee el resultado no se rompe cuando alguien añade un grupo antes en el patrón.

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

Encontrar todas las coincidencias con preg_match_all

preg_match_all() sigue buscando tras la primera coincidencia y devuelve el número de coincidencias. Por defecto, $m[0] contiene todas las coincidencias completas y $m[1] todos los valores del primer grupo. Con PREG_SET_ORDER obtienes en su lugar un array por coincidencia, más fácil de recorrer.

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

Validar entradas: anclajes, teléfonos, códigos postales

Para validar, el patrón debe coincidir con la cadena completa, así que empiézalo con ^ y termínalo con $. Una trampa: $ también coincide antes de un salto de línea final, así que '/^\d+$/' acepta "123\n". Añade el modificador D, o usa \z, que solo coincide justo al final.

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

Con las direcciones de email, una expresión regular o rechaza direcciones válidas o acepta inválidas. Usa en su lugar filter_var($email, FILTER_VALIDATE_EMAIL) (consulta filter_var()).

El modificador u para UTF-8 y texto japonés

Sin el modificador u, un patrón trabaja con bytes. Un carácter japonés ocupa tres bytes en UTF-8, así que . coincide con un tercio de carácter y las longitudes salen mal. Con u, el patrón trabaja con caracteres y puedes usar clases de propiedades 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 también valida la cadena: si no es UTF-8 válido, preg_match() devuelve false en lugar de buscar coincidencias.

Escapar la entrada del usuario con preg_quote

Caracteres como ., +, ?, ( y / tienen significados especiales en un patrón. Si parte del patrón viene de una variable, como un término de búsqueda, pásala por preg_quote() con el delimitador como segundo argumento, o 1+1 coincidirá con 11 y una / sin escapar romperá el patrón.

<?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 patrón no válido no lanza una excepción. PHP imprime un warning y preg_match() devuelve false:

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

Así que comprueba === false (o preg_last_error_msg()) cuando el patrón se construye en tiempo de ejecución. Para comprobar una subcadena simple sin ningún patrón, str_contains() es más rápido y más claro. Para cambiar el texto encontrado, usa preg_replace().