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

<?php

/**
 * session_start() 関数を安全に呼び出し、発生する可能性のあるエラーを捕捉するサンプル関数。
 *
 * この関数は、PHP のセッション開始時 (session_start()) に発生する可能性のある
 * 警告 (E_WARNING) をカスタムエラーハンドラで捕捉し、その詳細を返します。
 * 特に「Headers already sent」のような、HTTPヘッダーが既に送信された後に
 * セッションを開始しようとした場合に発生する警告に対処するために利用できます。
 *
 * PHP 8.4 の推奨コーディングスタイルに従い、単一の関数として提供されます。
 *
 * @param array $options session_start() に渡すオプションの配列。デフォルトは空配列。
 *                       例: ['cookie_lifetime' => 3600]
 * @return array 以下のキーを持つ連想配列を返します:
 *               - 'success': bool セッションが正常に開始された場合は true、そうでなければ false。
 *               - 'message': string エラーが発生した場合はその詳細な説明、成功時は空文字列。
 */
function safelyStartSessionWithErrorHandling(array $options = []): array
{
    $error_message = '';
    $session_started_successfully = false;

    // カスタムエラーハンドラを設定
    // クロージャを使用し、&$error_message で外部の変数にアクセスできるようにする。
    set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline) use (&$error_message): bool {
        // session_start() に関連する警告 (E_WARNING) のみを捕捉
        // 例: "session_start(): Session cannot be started after headers have already been sent"
        if (($errno & E_WARNING) && strpos($errstr, 'session_start():') !== false) {
            $error_message = $errstr; // 発生した警告メッセージをそのまま保存
            // PHP の標準エラーハンドラに処理を渡さない (これにより警告が画面に表示されなくなる)
            return true;
        }
        // それ以外のエラーはPHPの標準エラーハンドラに処理を渡す
        return false;
    });

    try {
        // 既にセッションが開始されていないかを確認
        // PHP_SESSION_NONE はセッションが開始されていないことを示す定数。
        if (session_status() === PHP_SESSION_NONE) {
            // session_start() を呼び出し
            // 戻り値は bool だが、エラーが発生した場合は通常警告が発行されるため、
            // エラーハンドラでの捕捉が主となる。
            if (session_start($options)) {
                $session_started_successfully = true;
            } else {
                // session_start() が false を返し、かつエラーハンドラが何も捕捉しなかった場合のフォールバック。
                // このケースは非常に稀。
                $error_message = $error_message ?: "不明な理由によりセッション開始に失敗しました。";
            }
        } else {
            // 既にセッションが開始されている場合は成功と見なす。
            // session_start() を再度呼び出しても通常はエラーにならないが、
            // この関数はセッション開始処理をラップしているため、既に開始済みなら成功と扱う。
            $session_started_successfully = true;
            // 必要であれば、既にセッションが開始されている旨のメッセージをここに設定することも可能。
            // $error_message = "セッションは既に開始されています。";
        }
    } finally {
        // カスタムエラーハンドラを元の状態に戻す
        restore_error_handler();
    }

    return [
        'success' => $session_started_successfully,
        'message' => $error_message,
    ];
}

PHPのsession_start()関数は、ウェブサイト訪問者の情報を一時的にサーバーに保存する「セッション」を開始するために利用します。しかし、この関数を呼び出すタイミングによっては、例えばPHPが既にHTTPヘッダーをブラウザに送信した後だと、「Headers already sent」のような警告（E_WARNING）が発生し、セッションが正常に開始できない場合があります。

提示されたsafelyStartSessionWithErrorHandling関数は、このようなsession_start()呼び出し時に発生する可能性のあるエラーを安全に捕捉し、処理することを目的にしています。この関数は、一時的にカスタムのエラーハンドラを設定することで、session_start()に関連する警告をPHPの標準エラー表示に頼らずに内部で処理し、呼び出し元にその結果を返します。

引数$optionsには、セッションの挙動を制御するための様々な設定を配列形式で渡すことができます。例えば、セッションクッキーの有効期限を設定する際などに利用します。関数は、セッションがまだ開始されていないかを確認してからsession_start()を呼び出し、その成否や発生したエラーメッセージを整理して戻り値として提供します。

戻り値は連想配列となっており、'success'キーにはセッションが正常に開始された場合はtrue、そうでなければfalseが格納されます。また、'message'キーには、エラーが発生した場合にその詳細な説明が格納されます。これにより、開発者はセッション開始の成否や、発生した問題の原因をプログラムから簡単に判断し、適切な処理を行うことが可能になります。

<?php

// session_start() を複数回呼び出した際の挙動を示すサンプルコード

// 1. セッション開始前の状態を確認
echo "--- セッション開始前 ---\n";
echo "現在のセッション状態: ";
switch (session_status()) {
    case PHP_SESSION_DISABLED:
        echo "無効 (PHP_SESSION_DISABLED)\n";
        break;
    case PHP_SESSION_NONE:
        echo "なし (PHP_SESSION_NONE)\n"; // この状態であることが期待される
        break;
    case PHP_SESSION_ACTIVE:
        echo "アクティブ (PHP_SESSION_ACTIVE)\n";
        break;
}

// 2. 1回目の session_start() を呼び出し、セッションを開始する
// PHP 7.0以降では、セッションがアクティブでない場合、セッションを開始し true を返します。
echo "\n--- 1回目の session_start() 呼び出し ---\n";
$first_start_result = session_start();
echo "session_start() の結果 (1回目): " . ($first_start_result ? "true" : "false") . "\n";

// セッションが開始されたので、セッション変数を設定してみる
if ($first_start_result) {
    $_SESSION['message'] = 'Hello PHP Session!';
    $_SESSION['user_id'] = 123;
    echo "セッション変数 'message' と 'user_id' を設定しました。\n";
}

// 3. 1回目の呼び出し後の状態を確認
echo "\n--- 1回目の session_start() 呼び出し後 ---\n";
echo "現在のセッション状態: ";
switch (session_status()) {
    case PHP_SESSION_DISABLED:
        echo "無効 (PHP_SESSION_DISABLED)\n";
        break;
    case PHP_SESSION_NONE:
        echo "なし (PHP_SESSION_NONE)\n";
        break;
    case PHP_SESSION_ACTIVE:
        echo "アクティブ (PHP_SESSION_ACTIVE)\n"; // この状態であることが期待される
        break;
}
echo "現在のセッション変数:\n";
echo "  message: " . ($_SESSION['message'] ?? '未設定') . "\n";
echo "  user_id: " . ($_SESSION['user_id'] ?? '未設定') . "\n";


// 4. 2回目の session_start() を呼び出す
// PHP 7.0以降では、すでにセッションがアクティブな場合、この関数は何もせず true を返します。
// 警告は発生しません。
echo "\n--- 2回目の session_start() 呼び出し ---\n";
$second_start_result = session_start();
echo "session_start() の結果 (2回目): " . ($second_start_result ? "true" : "false") . "\n";

// 5. 2回目の呼び出し後の状態を確認（状態や変数は変わらないはず）
echo "\n--- 2回目の session_start() 呼び出し後 ---\n";
echo "現在のセッション状態: ";
switch (session_status()) {
    case PHP_SESSION_DISABLED:
        echo "無効 (PHP_SESSION_DISABLED)\n";
        break;
    case PHP_SESSION_NONE:
        echo "なし (PHP_SESSION_NONE)\n";
        break;
    case PHP_SESSION_ACTIVE:
        echo "アクティブ (PHP_SESSION_ACTIVE)\n"; // 状態は変わらずアクティブなまま
        break;
}
echo "セッション変数の値は保持されています:\n";
echo "  message: " . ($_SESSION['message'] ?? '未設定') . "\n";
echo "  user_id: " . ($_SESSION['user_id'] ?? '未設定') . "\n";

// まとめ: PHP 7.0以降では、session_start() を複数回呼び出しても問題はなく、
// 2回目以降の呼び出しはセッションが既にアクティブな場合、true を返し、
// 実際には何も処理を行いません。
?>

PHPのsession_start関数は、Webサイトでユーザーの状態を維持するための「セッション」を開始または再開する際に利用されます。引数$optionsにはセッションの挙動を調整する設定を配列で渡せますが、通常は省略可能です。この関数は、セッションの開始または再開に成功するとtrueを、失敗するとfalseを返します。

このサンプルコードは、session_start()を複数回呼び出した際のPHP 7.0以降の挙動を説明しています。まず、session_status()関数でセッションが開始されていない状態を確認します。次に、1回目のsession_start()を呼び出すことで、セッションが開始され、$_SESSIONという特別な変数にデータを保存できるようになります。この時、session_start()はtrueを返します。

その後、2回目のsession_start()を呼び出しますが、PHP 7.0以降のバージョンでは、すでにセッションがアクティブな場合、この関数は何も処理を実行せず、単にtrueを返します。そのため、警告やエラーが発生することはありません。セッションの状態はアクティブなままであり、以前に設定された$_SESSION変数の値もそのまま保持されます。この挙動により、開発者は同じスクリプト内でsession_start()を複数回呼び出してしまっても、安心してセッション機能を利用できます。