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]が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を指定すると、代わりに一致ごとに1つの配列が得られ、ループしやすくなります。

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

入力を検証する：アンカー、電話番号、郵便番号

検証では、パターンが文字列全体に一致する必要があるので、^で始めて$で終えます。罠が1つあります。$は末尾の改行の直前にも一致するので、'/^\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を付けるとパターンは文字に対して働き、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は対象の文字列の検証も行います。文字列が正しいUTF-8でなければ、preg_match()は一致する代わりにfalseを返します。

preg_quoteでユーザーの入力をエスケープする

.、+、?、(、/のような文字は、パターンの中で特別な意味を持ちます。検索語のようにパターンの一部が変数から来る場合は、2つ目の引数に区切り文字を指定して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()を使います。