【PHP8.x】UPLOAD_ERR_FORM_SIZE定数の使い方

Copy
1<?php
2
3/**
4 * アップロードされたファイルの情報を処理し、発生したエラーを出力します。
5 * システムエンジニアを目指す初心者が、ファイルアップロード時のエラーハンドリング、
6 * 特にサイズ関連のエラーを理解するのに役立つように設計されています。
7 *
8 * @param array $fileInfo $_FILES スーパーグローバルから取得した特定のファイルに関する情報配列。
9 *                        例: $_FILES['uploadedFile']
10 * @return void
11 */
12function handleFileUpload(array $fileInfo): void
13{
14    // ファイル情報が不正な場合は処理を中断
15    if (!isset($fileInfo['error'])) {
16        echo "エラー: ファイル情報が正しくありません。<br>";
17        return;
18    }
19
20    $fileError = $fileInfo['error'];
21    $fileName = $fileInfo['name'] ?? '不明なファイル'; // PHP 7.0+ null coalescing operator
22
23    // アップロードエラーコードに応じてメッセージを表示
24    switch ($fileError) {
25        case UPLOAD_ERR_OK:
26            // エラーがない場合、ファイルは一時ディレクトリにアップロードされています。
27            // ここで move_uploaded_file() を使ってファイルを永続的な場所に移動します。
28            echo "ファイル '{$fileName}' は正常にアップロードされました。<br>";
29            // 例: move_uploaded_file($fileInfo['tmp_name'], '/path/to/your/uploads/' . $fileName);
30            break;
31
32        case UPLOAD_ERR_INI_SIZE:
33            // php.ini の 'upload_max_filesize' ディレクティブを超過した場合に発生します。
34            echo "エラー: ファイル '{$fileName}' は php.ini で設定された最大サイズ (upload_max_filesize) を超過しています。<br>";
35            break;
36
37        case UPLOAD_ERR_FORM_SIZE:
38            // HTMLフォーム内の hiddenフィールド <input type="hidden" name="MAX_FILE_SIZE" value="..."> で
39            // 指定されたサイズをファイルが超過した場合に発生します。
40            // ブラウザ側でのチェックですが、サーバー側でもこのエラーとして検出できます。
41            echo "エラー: ファイル '{$fileName}' は HTML フォームで設定された最大サイズ (MAX_FILE_SIZE) を超過しています。<br>";
42            break;
43
44        case UPLOAD_ERR_PARTIAL:
45            echo "エラー: ファイル '{$fileName}' は一部のみアップロードされました。<br>";
46            break;
47
48        case UPLOAD_ERR_NO_FILE:
49            echo "エラー: ファイルが選択されませんでした。<br>";
50            break;
51
52        case UPLOAD_ERR_NO_TMP_DIR:
53            echo "エラー: 一時アップロードフォルダが見つかりません。<br>";
54            break;
55
56        case UPLOAD_ERR_CANT_WRITE:
57            echo "エラー: ディスクへの書き込みに失敗しました。<br>";
58            break;
59
60        case UPLOAD_ERR_EXTENSION:
61            echo "エラー: PHP拡張機能がファイルのアップロードを停止しました。<br>";
62            break;
63
64        default:
65            echo "エラー: 不明なアップロードエラーが発生しました (コード: {$fileError})。<br>";
66            break;
67    }
68}
69
70// HTTPメソッドがPOSTであり、かつ 'uploadedFile' という名前のファイル入力が存在する場合に処理を実行
71if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['uploadedFile'])) {
72    handleFileUpload($_FILES['uploadedFile']);
73} elseif ($_SERVER['REQUEST_METHOD'] === 'POST') {
74    // フォームがPOSTされたが、ファイル入力 'uploadedFile' が存在しない場合 (例: ファイル入力がないフォームを送信)
75    echo "エラー: アップロードされたファイルが検出されませんでした。<br>";
76}
77
78?>
79<!DOCTYPE html>
80<html lang="ja">
81<head>
82    <meta charset="UTF-8">
83    <meta name="viewport" content="width=device-width, initial-scale=1.0">
84    <title>PHP ファイルアップロードエラーデモ</title>
85</head>
86<body>
87    <h1>PHP ファイルアップロードエラーデモ</h1>
88    <p>
89        このデモは、PHPのファイルアップロード処理における様々なエラー、<br>
90        特にファイルサイズに関するエラー (<code>UPLOAD_ERR_FORM_SIZE</code> および <code>UPLOAD_ERR_INI_SIZE</code>) <br>
91        の挙動を確認するために使用できます。
92    </p>
93
94    <form action="" method="post" enctype="multipart/form-data">
95        <!-- MAX_FILE_SIZE はバイト単位で指定します。この値を超えると UPLOAD_ERR_FORM_SIZE エラーが発生します。 -->
96        <!-- 注意: これはブラウザ側でのチェックであり、サーバー側での追加の検証が常に推奨されます。 -->
97        <input type="hidden" name="MAX_FILE_SIZE" value="1024"> <!-- 例: 1KB (1024バイト) -->
98
99        <label for="uploadedFile">アップロードするファイルを選択してください (1KB以下を推奨):</label><br>
100        <input type="file" name="uploadedFile" id="uploadedFile"><br><br>
101        <button type="submit">アップロード</button>
102    </form>
103    <hr>
104    <p>
105        <strong>テストのヒント:</strong><br>
106        <ul>
107            <li><strong>正常なアップロード:</strong> 1KBより小さいファイルをアップロード。</li>
108            <li><strong><code>UPLOAD_ERR_FORM_SIZE</code> の発生:</strong> 1KBより大きいファイルをアップロード。<br>
109                (ただし、php.iniの<code>upload_max_filesize</code>よりは小さいファイル)</li>
110            <li><strong><code>UPLOAD_ERR_INI_SIZE</code> の発生:</strong> php.iniの<code>upload_max_filesize</code>より大きいファイルをアップロード。<br>
111                (このエラーを発生させるには、通常、数MB以上のファイルを試す必要があります)</li>
112        </ul>
113    </p>
114</body>
115</html>

PHP 8におけるUPLOAD_ERR_FORM_SIZEは、ファイルアップロード処理で発生する可能性のあるエラーを示すPHP内部の定数の一つです。これは引数を持たず、エラーコードを表す整数値（int型）を返します。この定数は、Webブラウザを通じてファイルがアップロードされる際に、HTMLフォーム内に設定された隠しフィールド<input type="hidden" name="MAX_FILE_SIZE" value="...">で指定された最大ファイルサイズを、アップロードされたファイルが超過した場合に発生するエラーを示します。

この定数は、サーバーサイドでの追加のバリデーションとして機能します。ユーザーが意図的に大きなファイルを送信しようとしたり、クライアント側のチェックを回避したりした場合でも、サーバー側でこのエラーを検出できます。提供されたサンプルコードでは、handleFileUpload関数内でswitch文を用いて、アップロードされたファイルのerrorコードがUPLOAD_ERR_FORM_SIZEと一致するかどうかを判定しています。一致した場合、「ファイルは HTML フォームで設定された最大サイズ (MAX_FILE_SIZE) を超過しています」というエラーメッセージを出力します。これは、php.iniで設定されるupload_max_filesizeを超過した場合に発生するUPLOAD_ERR_INI_SIZEとは異なる、フォームレベルでのサイズ制限エラーであることを理解する上で重要です。システムエンジニアを目指す初心者の方にとって、ファイルアップロード時の堅牢なエラーハンドリングを実装するために、これらの異なるエラーコードを正確に理解し、適切に処理することが求められます。

Copy
1<?php
2
3/**
4 * ファイルアップロードのエラーコードを処理し、人間が読めるメッセージを返します。
5 *
6 * この関数は、PHPの$_FILESスーパーグローバル変数に含まれる`error`キーの値を想定しています。
7 * 特に、`UPLOAD_ERR_OK` (アップロード成功) と `UPLOAD_ERR_FORM_SIZE` (HTMLフォームで指定されたサイズ超過)
8 * の定数を含め、一般的なファイルアップロードエラーをカバーします。
9 *
10 * @param int $errorCode アップロードエラーコード（例: `$_FILES['file_input_name']['error']` の値）
11 * @return string エラーメッセージまたは成功メッセージ
12 */
13function handleFileUploadError(int $errorCode): string
14{
15    // ファイルが正常にアップロードされたか確認します。
16    // UPLOAD_ERR_OK はアップロードが成功したことを示す定数です。
17    if ($errorCode === UPLOAD_ERR_OK) {
18        return "ファイルは正常にアップロードされました。";
19    }
20
21    // 各エラーコードに対応するメッセージを生成します。
22    switch ($errorCode) {
23        case UPLOAD_ERR_INI_SIZE:
24            // php.ini の upload_max_filesize ディレクティブを超過した場合のエラー
25            return "アップロードされたファイルは、php.ini で設定された最大サイズを超過しています。";
26        case UPLOAD_ERR_FORM_SIZE:
27            // HTMLフォームで指定された MAX_FILE_SIZE (隠しフィールド) を超過した場合のエラー
28            // これはユーザーがアップロードしようとしたファイルのサイズが大きすぎることを示します。
29            return "アップロードされたファイルは、HTMLフォームで指定された最大サイズを超過しています。";
30        case UPLOAD_ERR_PARTIAL:
31            // ファイルの一部のみがアップロードされた場合のエラー
32            return "ファイルは一部のみしかアップロードされませんでした。";
33        case UPLOAD_ERR_NO_FILE:
34            // ファイルが選択されなかった場合のエラー
35            return "ファイルはアップロードされませんでした (ファイルが選択されていない可能性があります)。";
36        case UPLOAD_ERR_NO_TMP_DIR:
37            // 一時フォルダが見つからない場合のエラー
38            return "一時フォルダが見つかりません。";
39        case UPLOAD_ERR_CANT_WRITE:
40            // ディスクへの書き込みに失敗した場合のエラー
41            return "ファイルの保存に失敗しました。";
42        case UPLOAD_ERR_EXTENSION:
43            // PHPの拡張機能によってファイルのアップロードが停止された場合のエラー
44            return "PHPの拡張機能によりファイルのアップロードが停止されました。";
45        default:
46            // その他の不明なエラー
47            return "不明なアップロードエラーが発生しました (エラーコード: " . $errorCode . ")。";
48    }
49}
50
51// --- サンプル使用例 ---
52
53// シナリオ1: 正常なファイルアップロードをシミュレート
54$simulatedError1 = UPLOAD_ERR_OK;
55echo "シナリオ1 (正常アップロード): " . handleFileUploadError($simulatedError1) . PHP_EOL;
56
57// シナリオ2: HTMLフォームで指定された最大サイズを超過したケースをシミュレート
58// これはHTMLフォーム内の <input type="hidden" name="MAX_FILE_SIZE" value="[バイト数]">
59// で設定された値を超過した場合に発生します。
60$simulatedError2 = UPLOAD_ERR_FORM_SIZE;
61echo "シナリオ2 (フォームサイズ超過): " . handleFileUploadError($simulatedError2) . PHP_EOL;
62
63// シナリオ3: ファイルが選択されなかったケースをシミュレート
64$simulatedError3 = UPLOAD_ERR_NO_FILE;
65echo "シナリオ3 (ファイル未選択): " . handleFileUploadError($simulatedError3) . PHP_EOL;
66
67// シナリオ4: php.ini の設定を超過したケースをシミュレート
68$simulatedError4 = UPLOAD_ERR_INI_SIZE;
69echo "シナリオ4 (INIサイズ超過): " . handleFileUploadError($simulatedError4) . PHP_EOL;
70
71?>

このサンプルコードは、PHPでファイルをアップロードする際に発生するさまざまなエラーコードを解釈し、人間が読める分かりやすいメッセージに変換するhandleFileUploadError関数を提供します。ファイルアップロードの結果は、通常、$_FILESスーパーグローバル配列のerrorキーで確認できる整数値です。

handleFileUploadError関数は、$errorCodeという整数型の引数を受け取ります。この引数には、例えば$_FILES['ファイル入力名']['error']から取得されるエラーコードが渡されます。関数は受け取ったコードを基に、エラー内容に応じた文字列型のメッセージを戻り値として返します。

特に、UPLOAD_ERR_OKはファイルが正常にアップロードされたことを示します。今回注目するUPLOAD_ERR_FORM_SIZEは、HTMLフォーム内で<input type="hidden" name="MAX_FILE_SIZE" value="...">として設定された最大ファイルサイズを、アップロードしようとしたファイルが超過した場合に発生するエラーです。これは、ユーザーが非常に大きなファイルを誤って選択するのを防ぐ目的で、フォーム側で設定される制限であり、PHP側でも確認されます。その他にも、UPLOAD_ERR_INI_SIZE（PHPの設定ファイルphp.iniで定められた最大サイズ超過）やUPLOAD_ERR_NO_FILE（ファイルが選択されなかった）といった一般的なエラーも適切に処理されます。

このように、この関数を利用することで、システムエンジニアはファイルアップロードの失敗原因をユーザーに明確に伝えるロジックを容易に実装できます。