preg_match() PHP: Regular Expression dengan Contoh

preg_match($pattern, $subject, $matches) memeriksa apakah sebuah string cocok dengan regular expression. Fungsi ini mengembalikan 1 jika cocok dan 0 jika tidak, serta mengisi $matches dengan apa yang ditemukannya: preg_match('/\d+/', 'Order 4521 shipped', $m) mengembalikan 1 dan mengisi $m[0] dengan "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

Polanya berupa string dengan delimiter di sekelilingnya, biasanya /.../, diikuti modifier seperti i. Tulis pola dengan tanda kutip tunggal: di dalam tanda kutip ganda, PHP lebih dulu memperluas $name dan escape seperti \x41 atau \101, sehingga engine regex bisa menerima pola yang berbeda dari yang kamu ketik.

Capture group

Tanda kurung di dalam pola menangkap bagian string yang dicocokkannya. $m[0] adalah seluruh kecocokan, $m[1] grup pertama, $m[2] grup kedua, dihitung berdasarkan tanda kurung buka dari kiri.

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

Named group

(?<name>...) memberi nama pada sebuah grup. Nilainya disimpan di bawah nama itu dan di bawah nomornya, jadi kode yang membaca hasilnya tidak rusak saat seseorang menambahkan grup lain di bagian awal pola.

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

Menemukan setiap kecocokan dengan preg_match_all

preg_match_all() terus mencari setelah kecocokan pertama dan mengembalikan jumlah kecocokannya. Secara default, $m[0] berisi semua kecocokan lengkap dan $m[1] berisi semua nilai grup pertama. Dengan PREG_SET_ORDER, kamu mendapat satu array per kecocokan, yang lebih mudah ditelusuri dengan loop.

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

Validasi input: anchor, nomor telepon, kode pos

Untuk validasi, polanya harus cocok dengan seluruh string, jadi awali dengan ^ dan akhiri dengan $. Ada satu jebakan: $ juga cocok sebelum baris baru di akhir, jadi '/^\d+$/' menerima "123\n". Tambahkan modifier D, atau pakai \z, yang hanya cocok di ujung paling akhir.

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

Untuk alamat email, regex pasti menolak alamat yang valid atau menerima alamat yang tidak valid. Pakai filter_var($email, FILTER_VALIDATE_EMAIL) sebagai gantinya (lihat filter_var()).

Modifier u untuk teks UTF-8 dan Jepang

Tanpa modifier u, sebuah pola bekerja pada byte. Satu karakter Jepang berukuran tiga byte di UTF-8, jadi . cocok dengan sepertiga karakter dan panjangnya jadi salah. Dengan u, pola bekerja pada karakter dan kamu bisa memakai kelas properti 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 juga memvalidasi subjeknya: jika string-nya bukan UTF-8 yang valid, preg_match() mengembalikan false alih-alih mencocokkan.

Escape input pengguna dengan preg_quote

Karakter seperti ., +, ?, (, dan / punya arti khusus di dalam pola. Jika sebagian pola berasal dari variabel, seperti kata kunci pencarian, lewatkan melalui preg_quote() dengan delimiter sebagai argumen kedua, kalau tidak 1+1 akan cocok dengan 11 dan / yang tidak di-escape merusak polanya.

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

Pola yang tidak valid tidak melempar exception. PHP mencetak warning dan preg_match() mengembalikan false:

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

Jadi periksa === false (atau preg_last_error_msg()) saat polanya disusun saat runtime. Untuk pemeriksaan substring biasa tanpa pola sama sekali, str_contains() lebih cepat dan lebih jelas. Untuk mengubah teks yang cocok, pakai preg_replace().