PHP 정규식 preg_match(): 사용법과 예제

preg_match($pattern, $subject, $matches)는 문자열이 정규 표현식과 일치하는지 확인합니다. 일치하면 1, 아니면 0을 반환하고, 찾은 것으로 $matches를 채웁니다: preg_match('/\d+/', 'Order 4521 shipped', $m)은 1을 반환하고 $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

패턴은 구분자(보통 /.../)로 감싼 문자열이며, 그 뒤에 i 같은 수식어가 옵니다. 패턴은 작은따옴표로 쓰세요. 큰따옴표 안에서는 PHP가 먼저 $name과 \x41이나 \101 같은 이스케이프를 확장하므로, 정규식 엔진이 입력한 것과 다른 패턴을 받을 수 있습니다.

캡처 그룹

패턴의 괄호는 그것이 일치하는 문자열 부분을 캡처합니다. $m[0]은 전체 일치, $m[1]은 첫 번째 그룹, $m[2]는 두 번째 그룹이며, 왼쪽부터 여는 괄호 순서로 셉니다.

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

이름 있는 그룹

(?<name>...)은 그룹에 이름을 붙입니다. 값은 이름과 번호 아래에 모두 저장되므로, 누군가 패턴 앞쪽에 그룹을 추가해도 결과를 읽는 코드가 깨지지 않습니다.

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

preg_match_all로 모든 일치 찾기

preg_match_all()은 첫 번째 일치 후에도 계속 검색하고 일치 개수를 반환합니다. 기본적으로 $m[0]에는 모든 전체 일치가, $m[1]에는 첫 번째 그룹의 모든 값이 들어갑니다. PREG_SET_ORDER를 쓰면 일치마다 배열 하나를 받으므로 반복하기가 더 쉽습니다.

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

입력 검증: 앵커, 전화번호, 우편번호

검증에서는 패턴이 문자열 전체와 일치해야 하므로 ^로 시작하고 $로 끝내세요. 함정이 하나 있습니다. $는 마지막 줄바꿈 앞에서도 일치하므로 '/^\d+$/'는 "123\n"을 받아들입니다. D 수식어를 추가하거나, 맨 끝에서만 일치하는 \z를 쓰세요.

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

이메일 주소에 정규식을 쓰면 유효한 주소를 거부하거나 잘못된 주소를 받아들이게 됩니다. 대신 filter_var($email, FILTER_VALIDATE_EMAIL)를 쓰세요(filter_var() 참고).

UTF-8과 일본어 텍스트를 위한 u 수식어

u 수식어가 없으면 패턴은 바이트 단위로 동작합니다. 일본어 문자(한글도)는 UTF-8에서 3바이트이므로 .이 문자의 3분의 1과 일치하고 길이가 틀리게 나옵니다. u를 쓰면 패턴이 문자 단위로 동작하고 유니코드 속성 클래스를 쓸 수 있습니다.

<?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는 대상 문자열도 검증합니다. 문자열이 올바른 UTF-8이 아니면 preg_match()는 일치 대신 false를 반환합니다.

preg_quote로 사용자 입력 이스케이프하기

., +, ?, (, / 같은 문자는 패턴에서 특별한 의미를 가집니다. 검색어처럼 패턴의 일부가 변수에서 온다면 구분자를 두 번째 인수로 주어 preg_quote()에 통과시키세요. 그렇지 않으면 1+1이 11과 일치하고, 이스케이프하지 않은 /는 패턴을 깨뜨립니다.

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

잘못된 패턴은 예외를 던지지 않습니다. PHP가 경고를 출력하고 preg_match()는 false를 반환합니다.

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

그러므로 패턴을 실행 시점에 만든다면 === false(또는 preg_last_error_msg())로 확인하세요. 패턴 없이 단순한 부분 문자열 확인이라면 str_contains()가 더 빠르고 명확합니다. 일치한 텍스트를 바꾸려면 preg_replace()를 쓰세요.