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

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * ファイルアップロードのエラーコードを解釈し、初心者にも分かりやすいメッセージを返します。
7 *
8 * この関数は、PHPのファイルアップロード時に発生するエラーコードをチェックし、
9 * それぞれのエラーに応じた説明を提供します。
10 * 特に、UPLOAD_ERR_OK（成功）と UPLOAD_ERR_INI_SIZE（php.ini設定サイズ超過）
11 * といった内部定数の使い方を学ぶのに役立ちます。
12 *
13 * @param int $errorCode `$_FILES['input_name']['error']` のようなファイルアップロードエラーコード。
14 * @return string エラーコードに対応する説明メッセージ。
15 */
16function getFileUploadErrorMessage(int $errorCode): string
17{
18    switch ($errorCode) {
19        case UPLOAD_ERR_OK:
20            // ファイルは正常にアップロードされました。
21            return "ファイルは正常にアップロードされました。";
22        case UPLOAD_ERR_INI_SIZE:
23            // アップロードされたファイルは php.ini の upload_max_filesize ディレクティブで
24            // 指定された最大サイズを超過しています。これはサーバー側の設定です。
25            return "アップロードされたファイルは、サーバー（php.ini）で許可されている最大サイズを超過しています。";
26        case UPLOAD_ERR_FORM_SIZE:
27            // アップロードされたファイルは HTML フォームで指定された MAX_FILE_SIZE を超過しています。
28            // これはクライアント側で設定されることが多いですが、サーバー側で再確認されます。
29            return "アップロードされたファイルは、フォームで指定された最大サイズを超過しています。";
30        case UPLOAD_ERR_PARTIAL:
31            // ファイルは一部のみしかアップロードされませんでした。
32            // ネットワークの問題などが原因である可能性があります。
33            return "ファイルは一部のみしかアップロードされませんでした。";
34        case UPLOAD_ERR_NO_FILE:
35            // ファイルはアップロードされませんでした。
36            // フォームでファイルが選択されなかった場合に発生します。
37            return "ファイルが選択されていないか、アップロードされませんでした。";
38        case UPLOAD_ERR_NO_TMP_DIR:
39            // 一時フォルダがありません。
40            // PHPがアップロードファイルを一時的に保存するディレクトリが見つからない場合に発生します。
41            return "一時保存用のフォルダが見つかりませんでした。";
42        case UPLOAD_ERR_CANT_WRITE:
43            // ディスクへの書き込みに失敗しました。
44            // サーバーのディスク容量不足や、書き込み権限がない場合に発生します。
45            return "ファイルの保存に失敗しました（サーバーの書き込み権限の問題など）。";
46        case UPLOAD_ERR_EXTENSION:
47            // PHP の拡張モジュールがファイルのアップロードを停止しました。
48            // サーバーにインストールされているPHP拡張機能が原因である可能性があります。
49            return "PHPの拡張機能により、ファイルのアップロードが停止されました。";
50        default:
51            // その他の不明なエラー
52            return "不明なファイルアップロードエラーが発生しました (エラーコード: {$errorCode})。";
53    }
54}
55
56// --- サンプル使用例 ---
57
58// シミュレーション1: ファイルが正常にアップロードされた場合
59// UPLOAD_ERR_OK は、ファイルアップロードが成功したことを示す定数です。
60$simulatedSuccess = UPLOAD_ERR_OK;
61echo "シナリオ1（成功）: " . getFileUploadErrorMessage($simulatedSuccess) . "\n";
62
63// シミュレーション2: アップロードされたファイルが php.ini の設定サイズを超過した場合
64// UPLOAD_ERR_INI_SIZE は、php.ini の upload_max_filesize を超えたことを示す定数です。
65$simulatedIniSizeError = UPLOAD_ERR_INI_SIZE;
66echo "シナリオ2（サイズ超過）: " . getFileUploadErrorMessage($simulatedIniSizeError) . "\n";
67
68// シミュレーション3: ファイルが選択されなかった場合
69// UPLOAD_ERR_NO_FILE は、ファイルが選択されずに送信されたことを示す定数です。
70$simulatedNoFileError = UPLOAD_ERR_NO_FILE;
71echo "シナリオ3（ファイルなし）: " . getFileUploadErrorMessage($simulatedNoFileError) . "\n";
72
73// 実際のWebアプリケーションでは、`$_FILES['input_name']['error']` の値を使用します。
74// 例:
75// if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['my_file_input'])) {
76//     $actualErrorCode = $_FILES['my_file_input']['error'];
77//     echo "実際のアップロード結果: " . getFileUploadErrorMessage($actualErrorCode) . "\n";
78// }

PHPでは、ウェブサーバーへのファイルアップロード処理中に様々な状況が発生します。このサンプルコードは、その際にPHPが内部的に使用するエラーコードを解釈し、システムエンジニアを目指す初心者の方にも分かりやすいメッセージに変換する方法を示しています。特に、ファイルアップロードが正常に完了したことを示すUPLOAD_ERR_OKと、アップロードされたファイルのサイズがPHPの設定ファイル（php.ini）で定められた最大サイズ（upload_max_filesize）を超過した場合に発生するUPLOAD_ERR_INI_SIZEという二つの重要な定数の利用方法を学習できます。

getFileUploadErrorMessage関数は、ファイルアップロード処理の結果としてPHPが生成する数値のエラーコードを引数（int $errorCode）として受け取ります。このエラーコードは、通常$_FILES['input_name']['error']のように、アップロードされたファイル情報から取得されます。関数は、受け取ったエラーコードの種類に応じて、「ファイルは正常にアップロードされました。」や「アップロードされたファイルは、サーバーで許可されている最大サイズを超過しています。」といった、具体的な状況を説明する文字列を戻り値として返します。

この関数を利用することで、開発者はファイルアップロードの成否や具体的な問題点を判断し、ユーザーに適切なフィードバックを提供できるようになります。実際のウェブアプリケーション開発においては、これらの定数を活用した適切なエラーハンドリングが、堅牢でユーザーフレンドリーなシステムを構築するために不可欠です。

Copy
1<?php
2
3/**
4 * ファイルアップロードを処理し、様々なエラーコードをハンドリングする関数。
5 *
6 * システムエンジニアを目指す初心者向けに、ファイルアップロード時の典型的なエラーと、
7 * それらをPHPの内部定数（例: UPLOAD_ERR_INI_SIZE, UPLOAD_ERR_NO_FILE）を使って
8 * どのように検出・対応するかを示します。
9 *
10 * @param array $fileData $_FILES スーパーグローバル変数から取得した、アップロードされたファイルの配列情報。
11 * @return string 処理の結果を示すメッセージ。
12 */
13function handleFileUpload(array $fileData): string
14{
15    // $_FILES 配列が正しくセットされているか、またはエラーが発生していないかを確認
16    // 特に配列としてエラーが返される場合は不正なアップロードの可能性がある
17    if (!isset($fileData['error']) || is_array($fileData['error'])) {
18        return 'ファイルアップロードで不明なエラーが発生しました。';
19    }
20
21    // エラーコードに基づいて処理を分岐
22    switch ($fileData['error']) {
23        case UPLOAD_ERR_OK:
24            // エラーがなく、ファイルが正常にアップロードされた場合
25            // ここでファイルの最終的な保存処理（例: 一時ファイルから永続ストレージへの移動）を行う
26            
27            // アップロードファイルの保存先ディレクトリ
28            $uploadDir = __DIR__ . '/uploads/';
29            if (!is_dir($uploadDir)) {
30                // ディレクトリが存在しない場合は作成を試みる (権限に注意)
31                mkdir($uploadDir, 0777, true);
32            }
33
34            // ファイル名が重複しないようにユニークな名前を生成することも検討すべき
35            // 例: uniqid() . '-' . basename($fileData['name'])
36            $targetPath = $uploadDir . basename($fileData['name']);
37
38            if (move_uploaded_file($fileData['tmp_name'], $targetPath)) {
39                return 'ファイル "' . htmlspecialchars($fileData['name']) . '" のアップロードに成功しました。';
40            } else {
41                return 'ファイルの移動に失敗しました。サーバーの書き込み権限を確認してください。';
42            }
43            break;
44
45        case UPLOAD_ERR_INI_SIZE:
46            // アップロードされたファイルが php.ini の 'upload_max_filesize' ディレクティブで
47            // 指定されたサイズを超過しています。
48            return 'アップロードされたファイルが、許可されている最大サイズ (' . ini_get('upload_max_filesize') . ') を超過しています。';
49            break;
50
51        case UPLOAD_ERR_FORM_SIZE:
52            // HTML フォームの hidden フィールド 'MAX_FILE_SIZE' で指定されたサイズを超過しています。
53            // (このチェックはブラウザ側でのヒントであり、サーバー側でサイズ制限を別途行うべきです)
54            return 'アップロードされたファイルが、フォームで指定された最大サイズを超過しています。';
55            break;
56
57        case UPLOAD_ERR_PARTIAL:
58            // ファイルが一部のみアップロードされた場合のエラーです。
59            return 'ファイルが完全にアップロードされませんでした。通信状況をご確認の上、再度お試しください。';
60            break;
61
62        case UPLOAD_ERR_NO_FILE:
63            // ファイルが選択されていないか、アップロードされなかった場合のエラーです。
64            // (キーワード 'upload_err_no_file' に対応)
65            return 'ファイルが選択されていないか、アップロードされませんでした。';
66            break;
67
68        case UPLOAD_ERR_NO_TMP_DIR:
69            // アップロードファイルを保存するための一時ディレクトリが見つからない場合のエラーです。
70            return 'サーバーの一時フォルダが見つかりません。サーバー管理者に連絡してください。';
71            break;
72
73        case UPLOAD_ERR_CANT_WRITE:
74            // ディスクへの書き込みに失敗した場合のエラーです。
75            return 'ファイルの保存に失敗しました。サーバーの書き込み権限を確認してください。';
76            break;
77
78        case UPLOAD_ERR_EXTENSION:
79            // PHP の拡張モジュールがファイルのアップロードを停止した場合のエラーです。
80            return 'PHPの拡張機能によってファイルアップロードが停止されました。';
81            break;
82
83        default:
84            // 上記以外の予期せぬエラーが発生した場合
85            return '不明なファイルアップロードエラーが発生しました。エラーコード: ' . $fileData['error'];
86            break;
87    }
88}
89
90// --- 以下は、このスクリプトを単体で実行するためのコードです。 ---
91// 実際のWebサーバー環境でファイルをアップロードして動作を確認できます。
92
93// POSTリクエストがあり、ファイルがアップロードされた場合に処理を実行
94if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['uploadedFile'])) {
95    $resultMessage = handleFileUpload($_FILES['uploadedFile']);
96    echo '<p style="color: blue;">' . htmlspecialchars($resultMessage) . '</p>';
97}
98
99?>
100<!DOCTYPE html>
101<html lang="ja">
102<head>
103    <meta charset="UTF-8">
104    <meta name="viewport" content="width=device-width, initial-scale=1.0">
105    <title>PHP ファイルアップロードエラーハンドリング</title>
106    <style>
107        body { font-family: sans-serif; margin: 20px; }
108        form { border: 1px solid #ccc; padding: 20px; border-radius: 5px; max-width: 500px; }
109        label { display: block; margin-bottom: 5px; font-weight: bold; }
110        input[type="file"] { margin-bottom: 15px; }
111        button { padding: 10px 20px; background-color: #007bff; color: white; border: none; border-radius: 5px; cursor: pointer; }
112        button:hover { background-color: #0056b3; }
113        p { margin-top: 15px; }
114    </style>
115</head>
116<body>
117    <h1>ファイルアップロードテスト</h1>
118    <p>このページは、PHPにおけるファイルアップロードのエラーハンドリングの例を示します。</p>
119    <p>特に、<code>UPLOAD_ERR_INI_SIZE</code> (ファイルサイズ超過) と <code>UPLOAD_ERR_NO_FILE</code> (ファイル未選択) の処理に注目してください。</p>
120    <p>
121        <strong>テスト方法:</strong><br>
122        1. 小さなファイルをアップロード: 成功メッセージが表示されます。<br>
123        2. ファイルを選択せずにアップロード: <code>UPLOAD_ERR_NO_FILE</code> のメッセージが表示されます。<br>
124        3. PHP設定で許容されている最大サイズ (<code>upload_max_filesize</code>) を超えるファイルをアップロード:
125           <code>UPLOAD_ERR_INI_SIZE</code> のメッセージが表示されます。<br>
126           (<code>php.ini</code> の設定を確認するか、非常に大きなファイルを試してください。)
127    </p>
128
129    <form action="" method="post" enctype="multipart/form-data">
130        <!-- MAX_FILE_SIZE は、PHPの upload_max_filesize より優先されません。 -->
131        <!-- これはブラウザ側へのヒントであり、セキュリティ目的では使用できません。 -->
132        <!-- サーバー側で必ずファイルサイズのチェックを行ってください。 -->
133        <input type="hidden" name="MAX_FILE_SIZE" value="5000000" /> <!-- 例: 5MB (バイト単位) -->
134        <label for="uploadedFile">アップロードするファイルを選択:</label>
135        <input type="file" name="uploadedFile" id="uploadedFile" required />
136        <br>
137        <button type="submit">ファイルをアップロード</button>
138    </form>
139</body>
140</html>

このサンプルコードは、PHPでファイルをアップロードする際に発生する様々なエラーを適切に処理する方法を、システムエンジニアを目指す初心者向けに示しています。特に、PHPの設定（php.ini）で許可されている最大ファイルサイズを超過した場合のUPLOAD_ERR_INI_SIZEと、ファイルが選択されずにアップロードされた場合のUPLOAD_ERR_NO_FILEといった主要なエラー定数の使い方を解説しています。

handleFileUpload関数は、Webサーバーが受け取ったファイル情報が格納される$_FILESスーパーグローバル変数から、特定のアップロードファイルの配列情報（$fileData）を引数として受け取ります。この関数は、処理結果を示す文字列を戻り値として返します。関数内部では、引数で渡された$fileData配列のerrorキーに含まれるエラーコードをPHPの内部定数と比較し、switch文を使ってそれぞれのエラー状況に応じた処理を行います。エラーがない場合はUPLOAD_ERR_OKとなり、move_uploaded_file関数で一時ファイルを永続的な保存先へ移動させます。これにより、ファイルアップロード時の潜在的な問題を正確に検出し、ユーザーに適切なフィードバックを提供することが可能になります。