PHP Session Upload Progress とは?

公開:
💡 PHPが受信中のファイルの進み具合をセッションに記録し、別の要求から読めるようにする機能
📌 このページのポイント
ファイル送信と、進捗の参照は別 ブラウザ PHP ファイルを受信 アップロード 有効設定 + 指定名のPOST変数が必要 セッション 受信進捗のメモ 進捗表示 受信中… 別の要求で読む 進捗を返す 要求を先に全部ためる構成では、途中を追えない 進捗バーは模式例。表示UIはアプリ側で用意
青はファイル本体の転送、緑は進捗の記録と参照です。別の要求を受けたPHP側の処理がセッションを読み、ブラウザへ状態を返します。
ひよこ ひよこ
大きなファイルを送るとき、サーバーがどこまで受け取ったか知れる?
ペンギン先生 ペンギン先生
PHPには受信の進捗をセッションへ書く機能があるよ。対応する設定とPOST変数を用意すると、アプリが別リクエストで読み取って進捗表示に使えるんだ。
ひよこ ひよこ
設定を無効にすると、ファイルも送れなくなる?
ペンギン先生 ペンギン先生
session.upload_progress.enabledが切り替えるのはこの進捗機能だよ。ファイル送信そのものを止める設定ではない。ただし、この情報に頼るアプリの進捗表示は使えなくなるね。
ひよこ ひよこ
有効なのに、終わるまで進捗が出ないよ。
ペンギン先生 ペンギン先生
Webサーバーが要求を全部ためてからPHPへ渡す、リクエストバッファリングを確認しよう。その構成だとPHPに届く時点で受信が終わっているので、途中の進捗を追えないんだ。
ひよこ ひよこ
アップロード処理のスクリプトでセッション名を変えればいい?
ペンギン先生 ペンギン先生
進捗はスクリプト実行前に記録されるから、そこでセッション名を変えても記録先は変わらないよ。進捗を読む側と、受信前に適用されるセッション設定を合わせる必要があるんだ。
もっと詳しく知りたい人へ

2026年10月の無効化推奨は、どの条件の話?

2026年10月27日確認のPHP公式告知では、session.serialize_handlerがphp_binaryまたはphp_serializeの構成で、アプリがsession_start()前にini_set()でphpへ切り替え、進捗機能も有効な組み合わせがCVE-2026-115560の条件です。次の通常修正版まで進捗機能の無効化を推奨しています。実行時にハンドラを変更しないアプリは有効のままにできると明記されています。この設定だけで他の脆弱性への更新まで不要になるわけではありません。

ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「PHP Session Upload Progress」って出てきたら「受信の進み具合をセッションに書くPHPの機能」と思えばだいたいOK!

参考資料

← 用語集にもどる