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

<?php

declare(strict_types=1);

/**
 * mb_http_input() の使用例を示します。
 *
 * この関数はHTTPリクエストの入力文字エンコーディングを取得します。
 * Webサーバー環境で実行されることを想定した関数です。
 *
 * @see https://www.php.net/manual/ja/function.mb-http-input.php
 */
function showHttpInputEncodingExample(): void
{
    /*
     * 重要: mb_http_input() は PHP 8.0.0 で非推奨 (deprecated) になりました。
     * この関数が依存していた php.ini ディレクティブ `mbstring.http_input` は削除されており、
     * 現代のPHP環境では意図通りに動作しない可能性があります。
     * このサンプルは、関数の歴史的な使い方を理解するために提供されています。
     */

    // 引数を指定しない場合、設定されている入力エンコーディングを取得します。
    // コマンドラインで実行した場合や、設定がない場合は false を返すことがあります。
    echo '現在の入力エンコーディング:' . PHP_EOL;
    $currentInputEncoding = mb_http_input();
    var_dump($currentInputEncoding);
    echo PHP_EOL;

    // 引数に 'I' (全て) を指定すると、
    // GET, POST, COOKIE 等の入力タイプごとのエンコーディングを配列で取得します。
    echo '全ての入力タイプのエンコーディング:' . PHP_EOL;
    $allInputEncodings = mb_http_input('I');
    var_dump($allInputEncodings);
    echo PHP_EOL;

    // 現代のPHPでは、$_GET や $_POST などのスーパーグローバル変数を直接扱い、
    // 必要に応じて mb_convert_encoding() などで文字エンコーディングを
    // 明示的に変換する方法が一般的です。
}

// 関数を実行して結果を表示します。
showHttpInputEncodingExample();

mb_http_input()は、Webサーバーが受け取ったHTTPリクエストの入力文字エンコーディングを取得するための関数です。しかし、この関数はPHP 8.0.0で非推奨となりました。関連する設定がPHPから削除されたため、現代の環境では意図通りに動作しない可能性がある点に注意が必要です。この説明は、関数の歴史的な役割を理解するためのものとしてご覧ください。

引数を指定せずにこの関数を呼び出すと、設定されている入力エンコーディング名を文字列として返します。設定がない場合や、Webサーバー以外の環境で実行した場合はfalseを返すことがあります。引数に特定の文字（例: 'I'）を渡すと、GET、POST、COOKIEといった入力ソースごとのエンコーディングを配列形式で取得できます。

戻り値は、取得したエンコーディング名の文字列、エンコーディング名の配列、または取得に失敗した場合のfalseのいずれかです。

現代のPHP開発では、この関数に頼るのではなく、$_GETや$_POSTなどのスーパーグローバル変数を直接扱い、mb_convert_encoding()関数などを用いて明示的に文字エンコーディングを変換する方法が一般的です。