【PHP8.x】is_uploaded_file関数の使い方
is_uploaded_file関数の使い方について、初心者にもわかりやすく解説します。
基本的な使い方
is_uploaded_file関数は、指定されたファイルがHTTP POSTによるアップロードを通じてアップロードされたかどうかを調べる関数です。この関数は、セキュリティ上の重要な役割を果たします。なぜなら、悪意のあるユーザーがファイルを偽装してシステムに侵入しようとするのを防ぐことができるからです。具体的には、ユーザーがアップロードしたファイルを処理する前に、この関数を使ってファイルが正規のアップロードプロセスを経たものであることを確認します。
is_uploaded_file関数は、引数としてファイルのパスを受け取ります。このパスは、アップロードされたファイルが一時的に保存されている場所を指します。関数は、指定されたファイルが存在し、かつアップロードされたファイルである場合にtrueを返します。それ以外の場合、つまり、ファイルが存在しないか、アップロードされたファイルでない場合はfalseを返します。
この関数を使用する際には、ファイルパスが信頼できる情報源から提供されていることを確認することが重要です。例えば、ユーザーが直接入力したファイルパスをそのままis_uploaded_file関数に渡すことは避けるべきです。なぜなら、悪意のあるユーザーが偽のファイルパスを入力することで、セキュリティ上の脆弱性を悪用する可能性があるからです。通常は、$_FILESスーパーグローバル変数を通じて得られる一時ファイル名をこの関数に渡すのが安全です。
is_uploaded_file関数は、アップロードされたファイルを安全に処理するための基本的なツールの一つです。しかし、これだけで完全に安全が確保できるわけではありません。ファイルのコンテンツの検証や、適切なファイルサイズの制限、ファイル名のサニタイズなど、他のセキュリティ対策と組み合わせて使用することで、より安全なWebアプリケーションを構築できます。
構文(syntax)
1is_uploaded_file(string $filename): bool
引数(parameters)
string $filename
- string $filename: アップロードされたファイルへのパスを指定する文字列
戻り値(return)
bool
指定されたファイルがHTTP POSTリクエストでアップロードされたファイルである場合に true を返します。それ以外の場合は false を返します。
サンプルコード
PHPでis_uploaded_fileを使ったファイルアップロードエラー処理
1<?php 2 3/** 4 * is_uploaded_file() を使用してファイルのアップロードとエラー処理を行う 5 * 6 * この関数は、HTTP POSTリクエストで送信されたファイルを安全に処理します。 7 * ファイルアップロード時に発生する可能性のある様々なエラーをチェックし、 8 * is_uploaded_file() を使って不正なファイル操作でないことを検証します。 9 */ 10function processFileUpload(): void 11{ 12 // 1. フォームが送信され、ファイルが選択されているかを確認 13 if (!isset($_FILES['userfile']) || !is_array($_FILES['userfile'])) { 14 // フォームが送信されていない、または壊れている場合は何もしない 15 return; 16 } 17 18 // 2. アップロード時のエラーコードを確認 19 $errorCode = $_FILES['userfile']['error']; 20 if ($errorCode !== UPLOAD_ERR_OK) { 21 handleUploadError($errorCode); 22 return; 23 } 24 25 $tmpFilePath = $_FILES['userfile']['tmp_name']; 26 27 // 3. is_uploaded_file() でファイルが正当なアップロードか検証【最重要】 28 // このチェックがないと、サーバー上の任意のファイルを指定される攻撃を受ける可能性がある。 29 // is_uploaded_file() が false を返す場合は、不正なアクセス試行としてエラー処理する。 30 if (!is_uploaded_file($tmpFilePath)) { 31 echo '<p style="color: red;">エラー: 不正なファイルアップロードの試みです。</p>'; 32 return; 33 } 34 35 // 4. ファイルを永続的な場所に移動する 36 $uploadDir = __DIR__ . '/uploads/'; 37 // セキュリティのため、ユーザーが指定したファイル名をそのまま使わないことが望ましい 38 $safeFilename = uniqid('', true) . '_' . basename($_FILES['userfile']['name']); 39 $destination = $uploadDir . $safeFilename; 40 41 // アップロードディレクトリが存在しない場合は作成する 42 if (!is_dir($uploadDir)) { 43 mkdir($uploadDir, 0755, true); 44 } 45 46 if (move_uploaded_file($tmpFilePath, $destination)) { 47 echo '<p style="color: green;">ファイルは正常にアップロードされました。</p>'; 48 } else { 49 echo '<p style="color: red;">エラー: ファイルの移動中に問題が発生しました。</p>'; 50 } 51} 52 53/** 54 * ファイルアップロードのエラーコードに対応するメッセージを表示する 55 * 56 * @param int $errorCode $_FILES['userfile']['error'] の値 57 */ 58function handleUploadError(int $errorCode): void 59{ 60 $message = 'エラー: '; 61 switch ($errorCode) { 62 case UPLOAD_ERR_INI_SIZE: 63 $message .= 'アップロードされたファイルは、php.ini の upload_max_filesize ディレクティブの値を超えています。'; 64 break; 65 case UPLOAD_ERR_FORM_SIZE: 66 $message .= 'アップロードされたファイルは、HTML フォームで指定された MAX_FILE_SIZE を超えています。'; 67 break; 68 case UPLOAD_ERR_PARTIAL: 69 $message .= 'ファイルは一部しかアップロードされませんでした。'; 70 break; 71 case UPLOAD_ERR_NO_FILE: 72 $message .= 'ファイルが選択されませんでした。'; 73 break; 74 case UPLOAD_ERR_NO_TMP_DIR: 75 $message .= 'サーバーに一時保存フォルダがありません。'; 76 break; 77 case UPLOAD_ERR_CANT_WRITE: 78 $message .= 'サーバーにファイルを書き込めませんでした。'; 79 break; 80 case UPLOAD_ERR_EXTENSION: 81 $message .= 'PHPの拡張機能がファイルのアップロードを中止しました。'; 82 break; 83 default: 84 $message .= '不明なアップロードエラーが発生しました。'; 85 break; 86 } 87 echo '<p style="color: red;">' . htmlspecialchars($message, ENT_QUOTES, 'UTF-8') . '</p>'; 88} 89 90// HTTPメソッドがPOSTの場合のみ、ファイル処理を実行する 91if ($_SERVER['REQUEST_METHOD'] === 'POST') { 92 processFileUpload(); 93} 94 95?> 96<!DOCTYPE html> 97<html lang="ja"> 98<head> 99 <meta charset="UTF-8"> 100 <title>PHP is_uploaded_file エラー処理サンプル</title> 101</head> 102<body> 103 <h1>ファイルアップロードフォーム</h1> 104 <p> 105 is_uploaded_file() は、ファイルがHTTP POSTによってアップロードされたものであることを確認するセキュリティ上重要な関数です。<br> 106 この関数が false を返した場合、それは不正なアクセスや設定ミスの可能性があることを示します。 107 </p> 108 109 <!-- ファイルアップロードフォームには enctype="multipart/form-data" が必須 --> 110 <form action="" method="post" enctype="multipart/form-data"> 111 <p> 112 ファイルを選択してください: 113 <input type="file" name="userfile"> 114 </p> 115 <p> 116 <input type="submit" value="ファイルを送信"> 117 </p> 118 </form> 119</body> 120</html>
PHP 8のis_uploaded_file関数は、指定されたファイルがHTTP POSTアップロードによってアップロードされたものであるかを安全に確認するためのものです。この関数は、引数として検証したいファイルのパスを文字列（string $filename）で受け取ります。通常、これは$_FILESスーパーグローバル変数から取得できる一時的なファイルパスです。検証が成功し、ファイルが正規のアップロードファイルであればtrueを、そうでなければfalseを真偽値（bool）として返します。
この関数は、ファイルアップロード処理におけるセキュリティの要となります。もしこのチェックを怠ると、悪意のあるユーザーがサーバー上の任意のファイルを指定し、それを操作する「ディレクトリトラバーサル」のようなセキュリティ上の脆弱性を引き起こす可能性があります。
サンプルコードでは、まず$_FILES配列の存在やアップロード時のエラーコード（UPLOAD_ERR_OKなど）を確認し、その後にis_uploaded_file()を使って、一時ファイルが実際にHTTP POSTで送られた正当なファイルであるかを厳重に検証しています。この検証がfalseを返した場合、それは不正なアップロードの試みとして扱われ、エラーメッセージが表示されます。これにより、PHPにおける安全なファイルアップロードとエラー処理の基盤を築くことができます。
is_uploaded_file関数は、アップロードされたファイルがHTTP POSTリクエストによる正規の一時ファイルであるかを検証する、セキュリティ上非常に重要な機能です。このチェックを怠ると、サーバー上の既存ファイルが不正に扱われる危険性がありますので、必ず使用してください。また、is_uploaded_file()の実行前に、$_FILES配列の存在確認や、様々なアップロードエラーコード（UPLOAD_ERR_INI_SIZEなど）の確認も必須となります。ファイルを永続的に保存する際は、ユーザーが指定したファイル名をそのまま使わず、basename関数で安全な名前に加工し、必要に応じてユニークなIDを付与するなどのセキュリティ対策を講じることが重要です。HTMLフォームにはenctype="multipart/form-data"の指定を忘れないでください。
PHP is_uploaded_file が false を返す例
1<?php 2 3/** 4 * is_uploaded_file() が false を返す典型的なケースを示すサンプルコード。 5 * この関数は、指定されたファイルが HTTP POST アップロード経由でアップロードされた 6 * 有効なファイルであるかどうかを確認します。 7 * 8 * @param string $filePath 確認するファイルパス。 9 * @return void 10 */ 11function demonstrateIsUploadedFileReturnsFalse(string $filePath): void 12{ 13 echo "Checking file: '{$filePath}'\n"; 14 15 // is_uploaded_file は、指定されたファイルが HTTP POST アップロードによって 16 // 生成された一時ファイルである場合にのみ true を返します。 17 // それ以外のファイル（存在しないファイル、通常のファイルなど）では false を返します。 18 if (is_uploaded_file($filePath)) { 19 echo " 結果: '{$filePath}' はアップロードされた一時ファイルです。\n"; 20 } else { 21 echo " 結果: '{$filePath}' はアップロードされた一時ファイルではありません (または存在しません)。\n"; 22 } 23 echo "\n"; 24} 25 26// ---------------------------------------------------- 27// is_uploaded_file が false を返すケース 28// ---------------------------------------------------- 29 30// ケース1: 存在しないファイルパスを指定した場合 31// このファイルはシステム上に存在しないため、is_uploaded_file は false を返します。 32demonstrateIsUploadedFileReturnsFalse('/path/to/non_existent_upload_file.tmp'); 33 34// ケース2: 存在するが、HTTP POST アップロード経由ではない通常のファイルを指定した場合 35// まずテスト用のファイルを作成します。 36$testFilePath = 'non_uploaded_regular_file.txt'; 37// ファイルが存在しなくても、file_put_contents はファイルを作成します。 38file_put_contents($testFilePath, 'This is a test content for a regular file.'); 39 40// 作成したファイルは通常のファイルであり、HTTP POST アップロードされた一時ファイルではないため、 41// is_uploaded_file は false を返します。 42demonstrateIsUploadedFileReturnsFalse($testFilePath); 43 44// テストファイルをクリーンアップします。 45if (file_exists($testFilePath)) { 46 unlink($testFilePath); 47 echo "Cleaned up: '{$testFilePath}'\n"; 48} 49 50// ---------------------------------------------------- 51// (参考) is_uploaded_file が true を返す可能性のあるケース (実際のアップロード処理が必要なためコメントアウト) 52// ---------------------------------------------------- 53// 実際のファイルアップロードでは、例えば $_FILES['userfile']['tmp_name'] のような 54// 一時ファイルパスに対して is_uploaded_file が true を返します。 55// 56// <form action="upload.php" method="post" enctype="multipart/form-data"> 57// <input type="file" name="userfile"> 58// <input type="submit" value="Upload"> 59// </form> 60// 61// // upload.php の内部で 62// if (isset($_FILES['userfile']) && is_uploaded_file($_FILES['userfile']['tmp_name'])) { 63// // ここでは true が返され、ファイル処理に進むことができます。 64// echo "アップロードされた有効なファイルです！"; 65// } else { 66// echo "アップロードされたファイルではありません。"; 67// } 68 69?>
PHPのis_uploaded_file関数は、指定されたファイルパスがHTTP POSTアップロードによって生成された一時ファイルであるかどうかを厳密にチェックします。この関数は引数として確認したいファイルパス（文字列型）を受け取り、結果を真偽値（ブール型）で返します。指定されたファイルがHTTP POSTアップロードによる有効な一時ファイルであればtrueを、そうでなければfalseを返します。
このサンプルコードは、is_uploaded_file関数がfalseを返す典型的な状況を初心者にもわかりやすく示しています。具体的には、システム上に存在しないファイルパスを指定した場合、ファイルが存在しないため当然ながらfalseが返されます。また、ファイルがシステム上に存在していても、それがHTTP POSTアップロードによって作成された一時ファイルではない通常のファイルである場合（例えば、プログラムがfile_put_contents関数などで作成したファイル）もfalseが返されます。
通常、この関数はウェブアプリケーションでユーザーがファイルをアップロードした際に、$_FILESスーパーグローバル変数を通じて提供される一時ファイルパスに対して使われます。その場合、有効なアップロードであればtrueが返され、ファイルの移動や処理に進むことができます。このチェックは、セキュリティ上、不正なファイル操作を防ぐために非常に重要な工程となります。
is_uploaded_file関数は、ファイルがサーバーに存在するかを確認するものではなく、正規のフォーム送信によってアップロードされた一時ファイルであるかを厳密に検証するためのものです。そのため、自分で作成したファイルや任意のファイルパスを指定しても必ずfalseを返します。この関数には、$_FILESグローバル変数に格納される一時ファイルのパス (tmp_name) を渡すのが唯一の正しい使い方です。このチェックはセキュリティ対策として非常に重要であり、悪意のあるリクエストによってサーバー上の意図しないファイルが操作されるのを防ぎます。ファイルアップロード処理を実装する際は、必ずこの関数で検証した後にmove_uploaded_file関数でファイルを移動させるようにしてください。