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

<?php

/**
 * mb_convert_case 関数の基本的な使用方法を示すサンプルコード。
 * 文字列の文字種（大文字、小文字、タイトルケースなど）を変換します。
 *
 * @param string $text 変換する文字列。
 * @param string $encoding 使用する文字エンコーディング。デフォルトは現在の内部エンコーディング。
 * @return void
 */
function demonstrateMbConvertCase(string $text, string $encoding = 'UTF-8'): void
{
    echo "元の文字列 ({$encoding}): " . $text . PHP_EOL;

    // MB_CASE_UPPER: 全て大文字に変換
    echo "全て大文字 (MB_CASE_UPPER): " . mb_convert_case($text, MB_CASE_UPPER, $encoding) . PHP_EOL;

    // MB_CASE_LOWER: 全て小文字に変換
    echo "全て小文字 (MB_CASE_LOWER): " . mb_convert_case($text, MB_CASE_LOWER, $encoding) . PHP_EOL;

    // MB_CASE_TITLE: 各単語の先頭を大文字に変換 (タイトルケース)
    echo "タイトルケース (MB_CASE_TITLE): " . mb_convert_case($text, MB_CASE_TITLE, $encoding) . PHP_EOL;

    // PHP 7.3 以降で利用可能な MB_CASE_FOLD: 大文字を小文字に折りたたむ（ロケールに依存しない小文字化）
    // echo "ケースフォールド (MB_CASE_FOLD): " . mb_convert_case($text, MB_CASE_FOLD, $encoding) . PHP_EOL;
}

// 実行例
$englishString = 'hello world! This Is A Test String.';
$japaneseString = 'こんにちは世界！phpのテストです。';

echo "--- 英語文字列の変換 ---" . PHP_EOL;
demonstrateMbConvertCase($englishString);
echo PHP_EOL;

echo "--- 日本語文字列の変換 ---" . PHP_EOL;
// 日本語のようなマルチバイト文字の場合、大文字/小文字の区別がないため、
// mb_convert_case の UPPER/LOWER/TITLE は視覚的な変化を示さないことがあります。
// しかし、内部的にはUnicodeの規則に基づき処理されます。
demonstrateMbConvertCase($japaneseString);

PHP 8.4のmb_convert_case関数は、マルチバイト文字を含む文字列の文字種（大文字、小文字、タイトルケースなど）を変換するために使用されます。

この関数は、第1引数に変換したいstring型の文字列を受け取ります。第2引数のint型の$modeには、MB_CASE_UPPERで全て大文字に、MB_CASE_LOWERで全て小文字に、MB_CASE_TITLEで各単語の先頭を大文字にするなど、変換の形式を指定する定数を渡します。第3引数の?string $encodingはオプションで、使用する文字エンコーディングを指定します。この引数を省略した場合、PHPの内部エンコーディングが適用されます。関数は変換された新しいstring型の文字列を戻り値として返します。

サンプルコードでは、demonstrateMbConvertCase関数を通して、英語と日本語の文字列に対してmb_convert_caseがどのように適用されるかを示しています。たとえば、英語の'hello world!'が'HELLO WORLD!'や'Hello World!'に変換される様子が確認できます。日本語のようなマルチバイト文字の場合、大文字・小文字の区別がないことが多いため、MB_CASE_UPPERやMB_CASE_LOWERを使用しても視覚的な変化がないことがありますが、内部的にはUnicodeの規則に基づいた処理が行われます。この関数は、ユーザー入力の整形や表示形式の統一など、さまざまな場面で活用できます。

<?php

// mbstring 拡張がロードされていることを確認
// 日本語文字列処理には必須です。
if (!extension_loaded('mbstring')) {
    echo "エラー: mbstring 拡張がロードされていません。php.ini の設定を確認してください。" . PHP_EOL;
    exit(1);
}

// 内部エンコーディングをUTF-8に設定（推奨）
// mb_convert_kana は、デフォルトで mb_internal_encoding() で設定されたエンコーディングを使用します。
mb_internal_encoding('UTF-8');

/**
 * mb_convert_kana 関数を使用して、日本語文字列の様々な文字種・文字幅変換の例を示します。
 *
 * @param string $inputString 変換対象の日本語文字列
 * @return void
 */
function showKanaConversions(string $inputString): void
{
    echo "--- 元の文字列: " . $inputString . " ---" . PHP_EOL;

    // 全角カタカナを全角ひらがなに変換 ('H'モード)
    // 例: 「ハローワールド」 → 「はろーわーるど」
    $hiragana = mb_convert_kana($inputString, 'H', 'UTF-8');
    echo "全角カタカナ → 全角ひらがな: " . $hiragana . PHP_EOL;

    // 全角ひらがなを半角カタカナに変換 ('k'モード)
    // 例: 「てすとプログラム」 → 「ﾃｽﾄﾌﾟﾛｸﾞﾗﾑ」
    $halfwidthKatakana = mb_convert_kana($inputString, 'k', 'UTF-8');
    echo "全角ひらがな → 半角カタカナ: " . $halfwidthKatakana . PHP_EOL;

    // 全角英数字と全角スペースを半角に変換 ('as'モード)
    // 例: 「ＰＨＰ　８．４」 → 「PHP 8.4」
    $halfwidthAlphanum = mb_convert_kana($inputString, 'as', 'UTF-8');
    echo "全角英数字・スペース → 半角: " . $halfwidthAlphanum . PHP_EOL;

    // 半角カタカナを全角カタカナに変換 ('K'モード)
    // 例として、半角カタカナの文字列を直接渡します。
    // 「ﾃｽﾄﾌﾟﾛｸﾞﾗﾑ」 → 「テストプログラム」
    $fullwidthKatakana = mb_convert_kana("ﾃｽﾄﾌﾟﾛｸﾞﾗﾑ", 'K', 'UTF-8');
    echo "半角カタカナ → 全角カタカナ: " . $fullwidthKatakana . PHP_EOL;

    // 半角英数字と半角スペースを全角に変換 ('AS'モード)
    // 例として、半角英数字の文字列を直接渡します。
    // 「PHP 8.4 is great!」 → 「ＰＨＰ　８．４　ｉｓ　ｇｒｅａｔ！」
    $fullwidthAlphanum = mb_convert_kana("PHP 8.4 is great!", 'AS', 'UTF-8');
    echo "半角英数字・スペース → 全角: " . $fullwidthAlphanum . PHP_EOL;

    echo PHP_EOL;
}

// さまざまな変換パターンを試すためのサンプル実行
showKanaConversions("ハローワールド！PHP");
showKanaConversions("てすとプログラムです123");
showKanaConversions("ＰＨＰ　８．４　サンプル");
showKanaConversions("これはテストです。");

PHPのmb_convert_kana関数は、日本語のひらがな、カタカナ、全角英数字、半角英数字といった文字種や文字幅を相互に変換するために使用される重要な関数です。この関数を正確に利用するためには、まずPHPのmbstring拡張がシステムにロードされていることを確認することが不可欠です。mbstring拡張は、日本語のようなマルチバイト文字を適切に処理するために必要だからです。また、mb_internal_encoding関数を使って内部エンコーディングをUTF-8などの適切な値に設定しておくと、文字化けを防ぎ、一貫した処理が期待できます。

mb_convert_kana関数は、三つの引数を取ります。最初のstring $stringは変換したい対象の文字列、次のstring $modeは変換のルールを指定する一文字または複数の文字（例えば「H」で全角カタカナを全角ひらがなへ、「k」で全角ひらがなを半角カタカナへ、など）を指定します。最後の?string $encodingは文字列のエンコーディングを指定するオプションの引数で、省略した場合はmb_internal_encodingで設定された内部エンコーディングが使われます。この関数は、変換が適用された新しい文字列を戻り値として返します。

サンプルコードでは、showKanaConversions関数を通じて、さまざまな変換モードの具体的な挙動が示されています。例えば、全角カタカナを全角ひらがなへ変換したり、全角の英数字やスペースを半角へ変換したり、あるいはその逆の変換を行ったりする例を確認できます。これにより、日本語の文字列データを多様な形式に整形する際の柔軟な対応が可能となります。