【PHP8.x】preg_match_all関数の使い方

Copy
1<?php
2
3/**
4 * 複数行の文字列から、指定された正規表現パターンにマッチする全てのログIDを抽出します。
5 *
6 * この関数は、複数行モード（`m`修飾子）を使用して、各行の先頭からパターンを検索します。
7 * 具体的には「Log ID: [XXXX-YYY]」のような形式のログIDを抽出することを目的としています。
8 *
9 * @param string $subject 検索対象となる複数行の文字列。
10 * @return array 抽出されたログIDの配列。マッチが見つからない場合は空の配列を返します。
11 */
12function extractMultilineLogIds(string $subject): array
13{
14    // 正規表現パターンを定義します。
15    // /^Log ID: \[(?<logId>[A-Z]{3,}-[0-9]{3,})\]/m
16    // - ^                 : 各行の先頭にマッチします（末尾の /m 修飾子により）。
17    // - Log ID: \         : リテラルの文字列 "Log ID: " にマッチします。スペースとコロンを含みます。
18    // - \[                : リテラルの "[" 文字にマッチします（特殊文字なのでエスケープが必要です）。
19    // - (?<logId>...)     : 'logId' という名前付きキャプチャグループを定義します。
20    // - [A-Z]{3,}-[0-9]{3,}: ログIDの具体的なパターンです。
21    //                       大文字アルファベット3文字以上（例: "ALPHA"）
22    //                       ハイフン（例: "-"）
23    //                       数字3桁以上（例: "101"）
24    // - \]                : リテラルの "]" 文字にマッチします（特殊文字なのでエスケープが必要です）。
25    // - /m                : マルチラインモード修飾子です。
26    //                       これにより、^と$が文字列全体の先頭/末尾だけでなく、各行の先頭/末尾にもマッチするようになります。
27    $pattern = '/^Log ID: \[(?<logId>[A-Z]{3,}-[0-9]{3,})\]/m';
28
29    $matches = []; // マッチした結果を格納するための配列を初期化します。
30
31    // preg_match_all 関数を使用して、検索対象文字列からパターンに一致する全ての箇所を検索します。
32    // - $pattern: 使用する正規表現パターン。
33    // - $subject: 検索対象の文字列。
34    // - $matches: マッチした結果が格納される配列（参照渡し）。
35    // - PREG_SET_ORDER: このフラグは、$matches配列の構造を決定します。
36    //                   各マッチごとに要素の配列として結果を格納します。
37    //                   例: [ ['全体マッチ1', 'logId' => '値1'], ['全体マッチ2', 'logId' => '値2'] ]
38    // preg_match_all は、マッチした回数を返します。マッチしなかった場合は 0、エラーの場合は false を返します。
39    $matchCount = preg_match_all($pattern, $subject, $matches, PREG_SET_ORDER);
40
41    $extractedLogIds = []; // 抽出されたログIDを格納する配列を初期化します。
42
43    // マッチが成功し、かつ1つ以上のマッチが見つかった場合
44    if ($matchCount !== false && $matchCount > 0) {
45        foreach ($matches as $match) {
46            // 名前付きキャプチャグループ 'logId' の値が存在すれば、それを結果配列に追加します。
47            if (isset($match['logId'])) {
48                $extractedLogIds[] = $match['logId'];
49            }
50        }
51    }
52
53    return $extractedLogIds;
54}
55
56// テスト用の複数行文字列を定義します。
57$multiLineText = <<<EOT
58This is the first line of the document.
59Log ID: [ALPHA-101] - Critical system event.
60Another line with some general information.
61Log ID: [BETA-202] - User login successful.
62A line with an invalid ID format: [XYZ-abc].
63Log ID: [GAMMA-303] - Data processing complete.
64This line does not contain a log ID.
65Log ID: [DELTA-404] - Backup initiated.
66End of the document.
67EOT;
68
69// 定義した関数を呼び出し、結果を取得します。
70$foundLogIds = extractMultilineLogIds($multiLineText);
71
72// 抽出されたログIDを出力します。
73if (!empty($foundLogIds)) {
74    echo "Found Log IDs:\n";
75    foreach ($foundLogIds as $id) {
76        echo "- " . $id . "\n";
77    }
78} else {
79    echo "No Log IDs found in the text.\n";
80}
81
82?>

PHPのpreg_match_all関数は、指定された正規表現パターンに一致する文字列中の全ての箇所を検索し、その結果を取得するために使用されます。このサンプルコードでは、複数行の文字列から「Log ID: [XXXX-YYY]」のような特定の形式のログIDを全て抽出する方法を示しています。

preg_match_all関数は、最初の引数に検索に使用する正規表現パターン$pattern、二番目の引数に検索対象の文字列$subject、三番目の引数にマッチ結果を格納する配列&$matchesを受け取ります。正規表現パターンの末尾にある/m修飾子により、^が文字列全体の先頭だけでなく各行の先頭にもマッチする「マルチラインモード」で検索が行われます。これにより、複数行の中から各行のログIDを効率的に見つけることが可能です。また、PREG_SET_ORDERフラグは、$matches配列を各マッチごとに要素の配列として構成し、名前付きキャプチャグループ?<logId>を使って抽出されたIDにアクセスしやすくします。

関数の戻り値は、マッチした回数を示すint型、またはエラーが発生した場合はfalseです。サンプルコードでは、戻り値を確認してマッチが成功したか判断し、$matches配列からlogIdとしてキャプチャされた値を抽出し、結果として配列で返しています。このようにpreg_match_allを使用することで、複雑なテキストデータから必要な情報を効率的に収集することができます。

Copy
1<?php
2
3/**
4 * preg_match_all関数の基本的な使い方を示すサンプルコードです。
5 * 文字列内から、指定された正規表現パターンに合致するすべての出現を検索し、その結果を表示します。
6 */
7
8// 検索対象となる文字列を定義します。
9$subject = "商品Aは150円、商品Bは280.50円、商品Cは300円です。合計5個。";
10
11// 検索する正規表現パターンを定義します。
12// このパターンは、整数または小数点を含む数値を検索します。
13// \d+        : 1回以上の数字にマッチします。
14// (\.\d+)?   : ピリオドとそれに続く1回以上の数字にマッチします。
15//              全体が ? (オプション) なので、整数のみの場合にもマッチします。
16//              この括弧 `()` は「キャプチャグループ」と呼ばれ、マッチした部分を別途取得できます。
17$pattern = '/\d+(\.\d+)?/';
18
19// preg_match_all の結果を格納する配列を初期化します。
20// この配列には、見つかったすべてのマッチが構造化された形式で格納されます。
21$matches = [];
22
23// preg_match_all 関数を実行します。
24// 引数:
25//   $pattern:  検索パターン (正規表現)
26//   $subject:  検索対象の文字列
27//   $matches:  結果を格納するための配列 (参照渡し)。関数によって内容が更新されます。
28// 戻り値:
29//   見つかった完全なマッチの数、またはエラーの場合は false。
30$numMatches = preg_match_all($pattern, $subject, $matches);
31
32// 実行結果を評価し、コンソールに出力します。
33if ($numMatches === false) {
34    echo "エラーが発生しました。正規表現のパターンを確認してください。\n";
35} elseif ($numMatches > 0) {
36    echo "文字列内から " . $numMatches . " 個の数値が見つかりました。\n\n";
37    echo "元の文字列: \"" . $subject . "\"\n";
38    echo "使用した正規表現パターン: \"" . $pattern . "\"\n\n";
39
40    // $matches 配列の構造について (デフォルトのPREG_PATTERN_ORDERの場合):
41    // $matches[0] には、正規表現パターン全体に合致したすべての文字列が、見つかった順に格納されます。
42    echo "--- パターン全体にマッチした結果 ---\n";
43    foreach ($matches[0] as $index => $fullMatch) {
44        echo "マッチ " . ($index + 1) . ": " . $fullMatch . "\n";
45    }
46
47    // $matches[1] (もし存在すれば) には、最初のキャプチャグループ `()` にマッチしたすべての文字列が格納されます。
48    // マッチしなかった場合、その要素は空文字列になります。
49    if (isset($matches[1]) && !empty(array_filter($matches[1]))) {
50        echo "\n--- キャプチャグループ1 (小数部) にマッチした結果 ---\n";
51        foreach ($matches[1] as $index => $capturedGroup) {
52            // キャプチャグループがマッチしなかった場合は空文字列なので、その場合は表示をスキップします。
53            if ($capturedGroup !== '') {
54                echo "マッチ " . ($index + 1) . " の小数部: " . $capturedGroup . "\n";
55            }
56        }
57    }
58
59} else {
60    echo "文字列内にパターンに合致する数値は見つかりませんでした。\n";
61}
62
63?>

PHPの preg_match_all 関数は、指定した文字列の中から、正規表現パターンに一致する部分をすべて探し出すための関数です。

このサンプルコードでは、まず検索対象となる文字列 $subject と、数値（整数または小数）を探すための正規表現パターン $pattern を定義しています。

preg_match_all 関数を実行すると、第1引数の $pattern を使って第2引数の $subject を検索します。見つかったすべての一致は、第3引数で渡された $matches 配列に格納されます。この引数は参照渡し（&が先頭についている）のため、関数内で $matches の内容が直接更新されます。関数の戻り値は、見つかった一致の総数（この例では4）で、変数 $numMatches に代入されます。

結果が格納される $matches 配列は多次元配列になります。$matches[0] には、パターン全体に一致した文字列（'150', '280.50', '300', '5'）がすべて格納されます。また、パターン内に括弧 () で囲まれた部分（キャプチャグループ）がある場合、それに一致した部分が $matches[1] 以降に格納されます。この例では、小数部分である '.50' が $matches[1] の対応する要素に格納されています。