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

<?php

declare(strict_types=1);

/**
 * mb_language() 関数のエラーハンドリングを実演します。
 *
 * この関数は、有効な言語と無効な言語を設定しようとした場合の
 * mb_language() の戻り値の違いを示します。
 * サポートされていない無効な言語名を引数に指定すると、
 * この関数は false を返し、これがエラーに相当します。
 */
function demonstrateMbLanguageErrorHandling(): void
{
    // --- 実行前の状態を確認 ---
    // 引数なしで呼び出すと、現在の言語設定を取得できます。
    $initialLanguage = mb_language();
    echo "実行前の言語設定: {$initialLanguage}\n\n";

    // --- 成功ケース: 有効な言語を設定 ---
    echo "1. 有効な言語 'Japanese' を設定します。\n";
    $validLanguage = 'Japanese';
    
    // mb_language() で言語を設定します。成功すると true が返ります。
    $isSuccess = mb_language($validLanguage);

    if ($isSuccess) {
        echo "   -> 成功: 戻り値は true でした。\n";
        // 設定が反映されたか確認します。
        echo "   現在の言語設定: " . mb_language() . "\n\n";
    } else {
        // 通常、有効な言語ではこのブロックは実行されません。
        echo "   -> 予期せぬ失敗: 戻り値は false でした。\n\n";
    }

    // --- エラーケース: 無効な言語を設定 ---
    echo "2. 無効な言語 'invalid-language' を設定します。\n";
    $invalidLanguage = 'invalid-language';
    
    // 無効な言語を指定すると、mb_language() は false を返します。
    $isSuccess = mb_language($invalidLanguage);

    if ($isSuccess === false) {
        echo "   -> エラー: 戻り値は false でした。言語設定に失敗しました。\n";
        // エラーが発生した場合、言語設定は変更されないことを確認します。
        echo "   現在の言語設定は変更されていません: " . mb_language() . "\n";
    } else {
        // このブロックは実行されません。
        echo "   -> 予期せぬ成功: 戻り値は true でした。\n";
    }
}

// デモ関数を実行します。
demonstrateMbLanguageErrorHandling();

このPHPコードは、mb_language関数を使用してマルチバイト文字列処理の言語を設定、または取得する方法を示しています。特に、言語設定に失敗した場合のエラーハンドリングに焦点を当てています。

mb_language関数は、引数の有無によって動作が変わります。引数を指定せずに呼び出すと、現在設定されている言語名を文字列として返します。一方、引数に'Japanese'のような有効な言語名を文字列として渡すと、その言語への設定を試み、成功した場合はtrueを返します。

このサンプルの重要な点は、サポートされていない無効な言語名（例: 'invalid-language'）を引数に指定した場合の動作です。このとき、言語設定は行われず、関数は戻り値としてfalseを返します。このように、戻り値がfalseであるかを確認することで、言語設定が失敗したというエラーを検知し、その後の処理を制御することが可能です。コードでは、設定失敗後も元の言語設定が維持されていることを確認しています。