PHP preg_match(): biểu thức chính quy kèm ví dụ

preg_match($pattern, $subject, $matches) kiểm tra một chuỗi có khớp với biểu thức chính quy (regular expression) hay không. Hàm trả về 1 khi khớp và 0 khi không, đồng thời điền những gì tìm được vào $matches: preg_match('/\d+/', 'Order 4521 shipped', $m) trả về 1 và gán $m[0] bằng "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

Mẫu là một chuỗi có ký tự phân cách bao quanh, thường là /.../, theo sau là các modifier như i. Hãy viết mẫu trong dấu nháy đơn: trong dấu nháy kép, PHP sẽ thay $name và các chuỗi escape như \x41 hay \101 trước, nên engine regex có thể nhận một mẫu khác với mẫu bạn đã gõ.

Nhóm bắt

Dấu ngoặc tròn trong mẫu bắt lấy phần chuỗi mà chúng khớp. $m[0] là toàn bộ phần khớp, $m[1] là nhóm thứ nhất, $m[2] là nhóm thứ hai, đếm theo dấu ngoặc mở từ trái sang.

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

Nhóm có tên

(?<name>...) đặt tên cho một nhóm. Giá trị được lưu dưới cả tên lẫn số thứ tự của nhóm, nên code đọc kết quả sẽ không hỏng khi ai đó thêm một nhóm ở phía trước trong mẫu.

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

Tìm mọi lần khớp với preg_match_all

preg_match_all() tiếp tục tìm sau lần khớp đầu tiên và trả về số lần khớp. Mặc định $m[0] chứa mọi phần khớp đầy đủ và $m[1] chứa mọi giá trị của nhóm thứ nhất. Với PREG_SET_ORDER, bạn nhận một mảng cho mỗi lần khớp, dễ duyệt bằng vòng lặp hơn.

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

Kiểm tra dữ liệu nhập: neo, số điện thoại, mã bưu chính

Để kiểm tra dữ liệu, mẫu phải khớp với toàn bộ chuỗi, nên hãy bắt đầu bằng ^ và kết thúc bằng $. Có một cái bẫy: $ còn khớp ngay trước dấu xuống dòng cuối cùng, nên '/^\d+$/' chấp nhận "123\n". Thêm modifier D, hoặc dùng \z, chỉ khớp ở đúng điểm cuối chuỗi.

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

Với địa chỉ email, một regex hoặc sẽ từ chối địa chỉ hợp lệ, hoặc sẽ chấp nhận địa chỉ không hợp lệ. Hãy dùng filter_var($email, FILTER_VALIDATE_EMAIL) thay thế (xem filter_var()).

Modifier u cho UTF-8 và tiếng Nhật

Không có modifier u, mẫu làm việc trên từng byte. Một ký tự tiếng Nhật chiếm ba byte trong UTF-8 (chữ có dấu tiếng Việt cũng chiếm nhiều byte), nên . chỉ khớp một phần ba ký tự và độ dài tính ra bị sai. Có u, mẫu làm việc trên ký tự và bạn dùng được các lớp thuộc tính 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 còn kiểm tra chuỗi đầu vào: nếu chuỗi không phải UTF-8 hợp lệ, preg_match() trả về false thay vì so khớp.

Escape dữ liệu người dùng bằng preg_quote

Các ký tự như ., +, ?, ( và / có nghĩa đặc biệt trong mẫu. Nếu một phần của mẫu đến từ biến, chẳng hạn từ khóa tìm kiếm, hãy cho nó đi qua preg_quote() với ký tự phân cách làm đối số thứ hai, nếu không 1+1 sẽ khớp với 11 và một dấu / chưa escape sẽ làm hỏng mẫu.

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

Một mẫu không hợp lệ không ném ngoại lệ. PHP in ra cảnh báo và preg_match() trả về false:

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

Vì vậy hãy kiểm tra === false (hoặc preg_last_error_msg()) khi mẫu được tạo lúc chạy. Để kiểm tra một chuỗi con đơn giản, không cần mẫu nào, str_contains() nhanh và rõ ràng hơn. Để thay đổi đoạn văn bản đã khớp, hãy dùng preg_replace().