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

<?php

/**
 * 文字列が指定した正規表現パターンに全体として一致するかどうかを判定します。
 * この関数は mb_ereg_match() の使用例を示します。
 *
 * @param string $pattern 正規表現パターン (マルチバイト文字対応)
 * @param string $targetString チェック対象の文字列
 * @return void
 */
function checkFullStringMatch(string $pattern, string $targetString): void
{
    // マルチバイト文字の正規表現を正しく扱うために、内部エンコーディングをUTF-8に設定します。
    // この設定は mb_ereg_match を含む mb_ereg_* 関数群に影響します。
    mb_regex_encoding('UTF-8');

    echo "--- チェック開始 ---" . PHP_EOL;
    echo "対象文字列: '{$targetString}'" . PHP_EOL;
    echo "パターン: '{$pattern}'" . PHP_EOL;

    // mb_ereg_match() は、文字列全体がパターンにマッチする場合に true を返します。
    // 部分的な一致ではなく、文字列の先頭から末尾までが完全にパターンと一致する必要があります。
    if (mb_ereg_match($pattern, $targetString)) {
        echo "結果: マッチしました。" . PHP_EOL;
    } else {
        echo "結果: マッチしませんでした。" . PHP_EOL;
    }
    echo PHP_EOL;
}

// --- サンプルコードの実行 ---

// パターン「すべてひらがなである」を定義します。
// ^ は文字列の先頭、[ぁ-ん]+ はひらがな1文字以上、 $ は文字列の末尾を意味します。
$hiraganaPattern = '^[ぁ-ん]+$';

// マッチする例
checkFullStringMatch($hiraganaPattern, 'こんにちは');

// マッチしない例 (カタカナが含まれているため)
checkFullStringMatch($hiraganaPattern, 'こんにちはセカイ');


// パターン「有効な郵便番号形式（ハイフンあり）である」を定義します。
// \d{3} は数字3桁、- はハイフン、\d{4} は数字4桁を意味します。
$zipCodePattern = '^\d{3}-\d{4}$';

// マッチする例
checkFullStringMatch($zipCodePattern, '100-0001');

// マッチしない例 (ハイフンがないため)
checkFullStringMatch($zipCodePattern, '1000001');

// マッチしない例 (全角数字が含まれているため)
checkFullStringMatch($zipCodePattern, '１００-０００１');

?>

PHPの mb_ereg_match 関数は、指定した文字列が正規表現パターンに「全体として」一致するかどうかを判定するために使用します。文字列の一部分が一致するだけでは不十分で、文字列の先頭から末尾までが完全にパターンと合致する必要があります。

この関数の第1引数には正規表現パターンを、第2引数には検査対象の文字列を指定します。戻り値は、文字列全体がパターンに一致した場合には true を、一致しなかった場合は false を返します。日本語のようなマルチバイト文字を正しく扱うために、事前に mb_regex_encoding() 関数で文字エンコーディング（例: 'UTF-8'）を設定することが重要です。

サンプルコードでは、この関数を使って2種類の検証を行っています。1つ目は、文字列が「すべてひらがな」であるかの判定です。'こんにちは' はパターンに完全一致するため true となりますが、カタカナを含む 'こんにちはセカイ' は一致しません。2つ目は、「郵便番号の形式」に合致するかの判定です。'100-0001' は形式通りであるため一致しますが、ハイフンがなかったり全角数字が使われていたりすると一致しないことが示されています。このように、特定のフォーマットを厳密にチェックする際に役立ちます。

<?php

declare(strict_types=1);

/**
 * テキスト内の特定の単語を検索し、HTMLの<strong>タグで強調（置換）します。
 *
 * このサンプルは、マルチバイト文字列に対応した正規表現置換関数 `mb_ereg_replace` を使用します。
 * 大文字・小文字を区別せずにキーワードを検索し、マッチした部分を置換します。
 *
 * @param string $text 対象のテキスト。
 * @param string $keyword 強調表示したいキーワード。
 * @return string キーワードが強調表示されたテキスト。
 */
function highlightWords(string $text, string $keyword): string
{
    // 検索パターンとしてキーワードをそのまま使用します。
    $pattern = $keyword;

    // 置換後の文字列を定義します。
    // '\\0' は正規表現にマッチした文字列全体を指す「後方参照」です。
    // これにより、'PHP'や'php'など、マッチした元の表記を維持したままタグで囲むことができます。
    $replacement = '<strong>\\0</strong>';

    // 検索オプションを指定します。'i'は大文字と小文字を区別しないことを意味します。
    $options = 'i';

    // mb_ereg_replace を使用して、テキスト内のキーワードを置換します。
    // エラーが発生した場合、falseまたはnullが返ることがあるため、
    // 確実に文字列を返すようにキャストします。
    $result = mb_ereg_replace($pattern, $replacement, $text, $options);

    return (string)$result;
}

// --- 実行例 ---

// 置換対象の日本語テキスト
$originalText = 'PHPはWeb開発で人気のある言語です。多くのエンジニアがphpを学んでいます。';

// 強調したいキーワード
$targetKeyword = 'PHP';

// 関数を呼び出してキーワードを強調
$highlightedText = highlightWords($originalText, $targetKeyword);

// 結果をHTMLとして出力
header('Content-Type: text/html; charset=utf-8');
echo '<p>' . htmlspecialchars($originalText, ENT_QUOTES, 'UTF-8') . '</p>';
echo '<p>↓</p>';
// 下の行では、<strong>タグがHTMLとして解釈されるようにhtmlspecialcharsは使用しません。
echo '<p>' . $highlightedText . '</p>';

// --- 期待されるブラウザでの表示 ---
//
// PHPはWeb開発で人気のある言語です。多くのエンジニアがphpを学んでいます。
//
// ↓
//
// <strong>PHP</strong>はWeb開発で人気のある言語です。多くのエンジニアが<strong>php</strong>を学んでいます。

このサンプルコードは、マルチバイト文字（日本語など）に対応した正規表現置換を行うmb_ereg_replace関数の使用例です。指定したテキストの中から、特定のキーワードを検索し、HTMLの<strong>タグで囲んで強調表示（太字に）する処理を実装しています。

この関数は主に4つの引数を取ります。第1引数$patternには検索する文字列のパターンを正規表現で指定します。第2引数$replacementには、パターンに一致した部分を置き換えるための文字列を指定します。ここで使われている\\0は「一致した文字列全体」を指す特殊な記法（後方参照）で、これにより'PHP'や'php'といった元の表記を維持したままタグ付けが可能です。第3引数$textは、処理対象となる元の文字列です。第4引数$optionsでは検索の挙動を制御でき、サンプルでは'i'を指定することで大文字・小文字を区別しない検索を実現しています。

関数の戻り値は、置換処理が行われた後の文字列です。ただし、エラーが発生した場合などにはfalseやnullが返る可能性があるため、サンプルでは(string)キャストを行い、常に文字列として結果を扱えるようにしています。