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

Copy
1<?php
2
3/**
4 * アップロードされたファイルの情報を基に、エラーメッセージを生成します。
5 * システムエンジニアを目指す初心者向けに、ファイルアップロード時の
6 * 各種エラー定数の意味とハンドリング方法を示します。
7 *
8 * @param array $fileInfo アップロードされたファイルの $_FILES 配列からの情報
9 * @return string エラーメッセージ、または成功メッセージ
10 */
11function handleFileUploadError(array $fileInfo): string
12{
13    // $_FILES 配列に必要な 'error' キーが存在しない場合は、不正なデータと見なします。
14    if (!isset($fileInfo['error'])) {
15        return 'ファイルアップロード情報が不正です。';
16    }
17
18    switch ($fileInfo['error']) {
19        case UPLOAD_ERR_OK:
20            // エラーがなく、ファイルは正常にアップロードされました。
21            return 'ファイルは正常にアップロードされました。';
22
23        case UPLOAD_ERR_INI_SIZE:
24            // キーワードにもある通り、php.ini の upload_max_filesize を超えています。
25            // 現在の最大ファイルサイズ設定を取得して表示すると、ユーザーに分かりやすいです。
26            return 'アップロードされたファイルが大きすぎます。(' . ini_get('upload_max_filesize') . 'まで)';
27
28        case UPLOAD_ERR_FORM_SIZE:
29            // HTMLフォームで指定された MAX_FILE_SIZE (バイト単位) を超えています。
30            return 'アップロードされたファイルが大きすぎます。(フォーム指定サイズ上限)';
31
32        case UPLOAD_ERR_PARTIAL:
33            // ファイルの一部しかアップロードされませんでした。ネットワークの問題などが考えられます。
34            return 'ファイルの一部のみがアップロードされました。';
35
36        case UPLOAD_ERR_NO_FILE:
37            // ファイルがアップロードされませんでした。ユーザーがファイルを選択しなかった可能性があります。
38            return 'ファイルが選択されていないか、アップロードされませんでした。';
39
40        case UPLOAD_ERR_NO_TMP_DIR:
41            // サーバーの一時ディレクトリが存在しない、またはアクセス権がありません。
42            // サーバー管理者に連絡して設定を確認する必要があります。
43            return '一時保存用のフォルダが見つかりません。サーバー管理者に連絡してください。';
44
45        case UPLOAD_ERR_CANT_WRITE:
46            // ファイルの書き込みに失敗しました。
47            // アップロードされたファイルをサーバーの一時ディレクトリに保存できない場合に発生します。
48            // サーバーの一時ディレクトリのパーミッション（書き込み権限）を確認してください。
49            return 'ファイルの保存に失敗しました。サーバーの書き込み権限を確認してください。';
50
51        case UPLOAD_ERR_EXTENSION:
52            // PHP の拡張機能によってファイルのアップロードが停止されました。
53            // 拡張機能側の問題や設定によるものです。
54            return 'PHPの拡張機能により、ファイルのアップロードが中断されました。';
55
56        default:
57            // その他の不明なエラーコードです。
58            return '不明なファイルアップロードエラーが発生しました。エラーコード: ' . $fileInfo['error'];
59    }
60}
61
62// --- サンプル実行 ---
63// 実際には、ファイルのアップロードが行われると $_FILES グローバル変数にデータが格納されます。
64// ここでは単体で動作させるため、$_FILES から取得されるであろうデータを擬似的に作成します。
65
66echo "--- 正常アップロードの例 ---\n";
67// 正常にアップロードされた場合のシミュレーション
68$simulatedFileOk = [
69    'name' => 'document.pdf',
70    'type' => 'application/pdf',
71    'tmp_name' => '/tmp/phpABCDEFG', // サーバー上の一時ファイル名
72    'error' => UPLOAD_ERR_OK,
73    'size' => 512000, // 500KB
74];
75echo handleFileUploadError($simulatedFileOk) . "\n\n";
76
77echo "--- UPLOAD_ERR_CANT_WRITE の例 (リファレンス情報) ---\n";
78// UPLOAD_ERR_CANT_WRITE が発生した場合のシミュレーション
79$simulatedFileCantWrite = [
80    'name' => 'report.xlsx',
81    'type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
82    'tmp_name' => '', // エラーのため、一時ファイル名は存在しないか無効
83    'error' => UPLOAD_ERR_CANT_WRITE,
84    'size' => 0,
85];
86echo handleFileUploadError($simulatedFileCantWrite) . "\n\n";
87
88echo "--- UPLOAD_ERR_INI_SIZE の例 (キーワード関連) ---\n";
89// UPLOAD_ERR_INI_SIZE が発生した場合のシミュレーション
90// (php.ini の upload_max_filesize を超えた場合)
91$simulatedFileIniSize = [
92    'name' => 'very_large_archive.zip',
93    'type' => 'application/zip',
94    'tmp_name' => '',
95    'error' => UPLOAD_ERR_INI_SIZE,
96    'size' => 200 * 1024 * 1024, // 仮に200MB (upload_max_filesizeが通常より低いと仮定)
97];
98echo handleFileUploadError($simulatedFileIniSize) . "\n\n";
99
100echo "--- UPLOAD_ERR_NO_FILE の例 ---\n";
101// UPLOAD_ERR_NO_FILE が発生した場合のシミュレーション
102// (ファイルが選択されなかった場合)
103$simulatedFileNoFile = [
104    'name' => '',
105    'type' => '',
106    'tmp_name' => '',
107    'error' => UPLOAD_ERR_NO_FILE,
108    'size' => 0,
109];
110echo handleFileUploadError($simulatedFileNoFile) . "\n\n";

このPHPサンプルコードは、ファイルをアップロードする際に発生する可能性のある様々なエラーを効果的に処理するための handleFileUploadError 関数を提示しています。この関数は、アップロードされたファイルの情報を格納する配列 $fileInfo（通常、PHPの $_FILES グローバル変数から得られる形式）を引数として受け取ります。関数は、この情報に基づいてエラーの種類を判別し、適切なエラーメッセージを文字列として返します。

特に、リファレンス情報にある UPLOAD_ERR_CANT_WRITE は、サーバーがアップロードされたファイルを一時的に保存しようとした際に、書き込み権限の問題などで失敗した場合に発生するエラーを示します。この場合、サーバーの一時ディレクトリのパーミッション設定を確認する必要があります。また、キーワードに関連する UPLOAD_ERR_INI_SIZE は、PHPの設定ファイル php.ini で定義されている upload_max_filesize の上限をアップロードファイルが超えた場合に発生します。このエラーの際には、ini_get 関数を使用して現在の最大ファイルサイズ設定をメッセージに含めることで、ユーザーに具体的な情報を提供しています。

コードは UPLOAD_ERR_OK で正常終了を、UPLOAD_ERR_NO_FILE でファイル未選択のエラーをハンドリングするなど、主要なファイルアップロードエラー定数に対応しています。サンプルコードの後半では、実際のファイルアップロードなしに、これらのエラーケースを仮想的に再現して関数が返すメッセージの具体例を示しており、エラーハンドリングの仕組みを実践的に学ぶことができます。

Copy
1<?php
2
3/**
4 * ファイルアップロードのエラーコードを解釈し、対応するメッセージを返します。
5 *
6 * この関数は、PHPのファイルアップロード時に発生する可能性のある様々なエラーコードを処理します。
7 * 主に `$_FILES['input_name']['error']` の値に基づいて動作します。
8 *
9 * @param int $errorCode PHPのファイルアップロードエラーコード (UPLOAD_ERR_XXX 定数)。
10 * @return string エラーコードに対応する人間が読めるメッセージ。
11 */
12function getFileUploadErrorMessage(int $errorCode): string
13{
14    switch ($errorCode) {
15        case UPLOAD_ERR_OK:
16            return "ファイルは正常にアップロードされました。";
17        case UPLOAD_ERR_INI_SIZE:
18            return "アップロードされたファイルは、php.ini の upload_max_filesize を超えています。";
19        case UPLOAD_ERR_FORM_SIZE:
20            return "アップロードされたファイルは、HTMLフォームで指定された MAX_FILE_SIZE を超えています。";
21        case UPLOAD_ERR_PARTIAL:
22            return "ファイルは一部のみアップロードされました。";
23        case UPLOAD_ERR_NO_FILE: // キーワードに関連するエラー
24            return "ファイルがアップロードされませんでした (選択されていません)。";
25        case UPLOAD_ERR_NO_TMP_DIR:
26            return "一時フォルダがありません。サーバー管理者に連絡してください。";
27        case UPLOAD_ERR_CANT_WRITE: // このリファレンス情報の主題
28            return "ディスクへの書き込みに失敗しました。一時ファイルを保存する権限がない可能性があります。サーバー管理者に連絡してください。";
29        case UPLOAD_ERR_EXTENSION:
30            return "PHPの拡張モジュールがファイルのアップロードを停止しました。";
31        default:
32            return "不明なアップロードエラーが発生しました (エラーコード: " . $errorCode . ")。";
33    }
34}
35
36// 以下は、getFileUploadErrorMessage() 関数の使用例です。
37// 通常は、HTMLフォームからファイルが送信された際に $_FILES グローバル変数が設定されますが、
38// ここではテストのために手動でエラーコードを設定して模擬します。
39
40// シナリオ1: UPLOAD_ERR_CANT_WRITE の模擬
41// これは、PHPがアップロードされた一時ファイルをサーバーのディスクに書き込めない場合に発生します。
42// 例えば、一時ディレクトリの権限不足などが原因です。
43$mockErrorCantWrite = UPLOAD_ERR_CANT_WRITE;
44echo "--- UPLOAD_ERR_CANT_WRITE の例 ---\n";
45echo "エラーコード: " . $mockErrorCantWrite . "\n";
46echo "メッセージ: " . getFileUploadErrorMessage($mockErrorCantWrite) . "\n\n";
47
48// シナリオ2: UPLOAD_ERR_NO_FILE の模擬 (キーワードに関連)
49// これは、ユーザーがファイル選択フィールドで何もファイルを選択せずにフォームを送信した場合に発生します。
50$mockErrorNoFile = UPLOAD_ERR_NO_FILE;
51echo "--- UPLOAD_ERR_NO_FILE の例 (キーワード関連) ---\n";
52echo "エラーコード: " . $mockErrorNoFile . "\n";
53echo "メッセージ: " . getFileUploadErrorMessage($mockErrorNoFile) . "\n\n";
54
55// シナリオ3: 正常なアップロードの模擬
56$mockErrorOk = UPLOAD_ERR_OK;
57echo "--- 正常アップロードの例 ---\n";
58echo "エラーコード: " . $mockErrorOk . "\n";
59echo "メッセージ: " . getFileUploadErrorMessage($mockErrorOk) . "\n";
60
61?>

PHPのサンプルコードは、ファイルアップロード時に発生する様々なエラーを分かりやすく表示するためのものです。特に、UPLOAD_ERR_CANT_WRITEは、アップロードされた一時ファイルをPHPがサーバーのディスクに書き込めない場合に発生するエラーコードを指します。これは、一時ファイルを保存するディレクトリの書き込み権限が不足している時などに起こります。

コードの中心であるgetFileUploadErrorMessage関数は、ファイルアップロード時にPHPが返すエラーコード（UPLOAD_ERR_OKやUPLOAD_ERR_CANT_WRITEなどの定数）を整数値として引数に受け取ります。そして、そのコードに対応した、人間が理解しやすいエラーメッセージを文字列として戻り値で返します。

サンプルコードでは、この関数の使い方を具体的に示しています。例えば、UPLOAD_ERR_CANT_WRITEを模擬してディスク書き込み失敗のエラーメッセージが出力される様子や、キーワードにあるUPLOAD_ERR_NO_FILEを模擬してファイルが選択されなかった場合のエラーメッセージが表示される様子を確認できます。また、ファイルが正常にアップロードされた場合のメッセージも示されており、これによりファイルアップロード時のエラーハンドリングの基本が理解できます。