Laravelでアップロードファイル情報を取得！ファイル名やサイズ操作を徹底解説

1. ファイルアップロードの基本概念

1. ファイルアップロードの基本概念

パソコンを使い始めたばかりの方にとって、「アップロード」という言葉は少し難しく感じるかもしれません。これは、自分のパソコンの中にある画像や文章などのデータを、インターネット上のサーバーという「大きな保管庫」に送り届ける作業のことを指します。

Laravel（ララベル）という道具を使うと、この送られてきたデータをプログラムで受け取ることができます。受け取ったデータは単なる塊ではなく、「名前は何？」「重さはどれくらい？」「種類は何？」といった情報が付随しています。これらの情報を正しく読み取ることが、安全で使いやすいWebサイトを作る第一歩となります。

まずは、HTMLというWebページの見た目を作る言語で、ファイルを送るための窓口（フォーム）を作成する必要があります。ここで大切なのは、enctype="multipart/form-data"という魔法の言葉を記述することです。これがないと、ファイルの中身がサーバーに届かないので注意しましょう。

2. Requestを使ってファイルを受け取る方法

2. Requestを使ってファイルを受け取る方法

ユーザーが送信ボタンを押すと、Laravelの「コントローラー」という場所にデータが届きます。このとき、データはRequest（リクエスト）という箱の中に入っています。この箱の中から、特定のファイルを取り出す作業から始めます。

プログラムの世界では、$request->file('キー名')という書き方をして、特定のファイルにアクセスします。この「キー名」は、HTMLの入力欄で決めた名前のことです。例えば、写真を選択する場所の名前を「photo」にしていたら、プログラムでも「photo」と書くことになります。

まずは、ファイルが正しく届いているかを確認し、その存在を変数という「一時的な保管場所」に代入するコードを見てみましょう。変数は、データの入れ物だと考えてください。

// ユーザーが送ってきたリクエストからファイルを取り出す
$file = $request->file('profile_image');

// ファイルが存在するかどうかをチェックする
if ($request->hasFile('profile_image')) {
    echo 'ファイルを受け取りました！';
}

3. 元のファイル名を取得する（getClientOriginalName）

3. 元のファイル名を取得する（getClientOriginalName）

ユーザーが自分のパソコンで付けていたファイルの名前を知りたいときは、getClientOriginalNameという命令を使います。例えば、ユーザーが「my_dog.jpg」という名前の写真を送ってきた場合、この命令を使うことで「my_dog.jpg」という文字列を手に入れることができます。

ただし、注意点があります。インターネットの世界には色々な人がいるため、ファイル名に特殊な記号が入っていたり、悪意のある名前が付けられていたりすることもあります。そのため、そのままの名前で保存するのではなく、中身を確認するためにこの名前を使うのが一般的です。

この名前を取得することで、「〇〇というファイルがアップロードされました」と画面に表示してあげると、ユーザーも安心しますよね。それでは、実際の書き方を確認してみましょう。

// アップロードされたファイルを取得
$file = $request->file('document');

if ($file) {
    // ユーザーのパソコンでの元の名前を取得
    $originalName = $file->getClientOriginalName();
    echo '元のファイル名は：' . $originalName;
}

実行結果は以下のようになります。

元のファイル名は：report_2026.pdf

4. ファイルのサイズを確認する（getSize）

4. ファイルのサイズを確認する（getSize）

次に重要なのが「ファイルサイズ」です。これはファイルの「重さ」のようなものです。大きすぎるファイルを無制限に許可してしまうと、サーバーの容量がいっぱいになってしまったり、処理が遅くなったりする原因になります。そのため、プログラムで「このファイルは何バイトかな？」と調べる必要があります。

LaravelではgetSizeという命令を使います。この命令で返ってくる数値は「バイト（byte）」という単位です。パソコンに詳しくない方のために説明すると、1,024バイトで「1キロバイト（KB）」、さらにその1,024倍で「1メガバイト（MB）」となります。普段私たちが目にする写真のサイズは、だいたい数メガバイト程度であることが多いです。

以下のコードでは、ファイルサイズを取得し、それが制限を超えていないかを判断する例を示します。

$file = $request->file('upload_file');

if ($file) {
    // サイズをバイト単位で取得
    $size = $file->getSize();
    
    // 1MB(1048576バイト)より大きいかチェック
    if ($size > 1048576) {
        echo 'ファイルが大きすぎます。1MB以下にしてください。';
    } else {
        echo 'ファイルサイズは：' . $size . 'バイトです。';
    }
}

5. 拡張子とファイルの種類を特定する

5. 拡張子とファイルの種類を特定する

ファイル名の後ろについている「.jpg」や「.pdf」といった文字を「拡張子（かくちょうし）」と呼びます。これは、そのファイルが画像なのか、文章なのか、音楽なのかを判別するための印です。Laravelでは、この拡張子を安全に取得する方法が用意されています。

getClientOriginalExtensionという命令を使うと、ユーザーが送ったファイルの拡張子を取得できます。また、もっと厳密に「このファイルは本当に画像データかな？」と調べたいときは、getMimeTypeという命令を使います。これはファイルの表面上の名前ではなく、中身の性質を判定してくれる頼もしい機能です。

例えば、悪意のある人がプログラムファイルを「image.jpg」と名前だけ変えて送ってきても、MIMEタイプ（マイムタイプ）を調べれば、それが画像ではないことを見破ることができます。安全なWebサイト作りには欠かせない知識です。

$file = $request->file('avatar');

if ($file) {
    // 拡張子を取得（例：jpg, png）
    $extension = $file->getClientOriginalExtension();
    
    // MIMEタイプを取得（例：image/jpeg）
    $mimeType = $file->getMimeType();
    
    echo '拡張子：' . $extension . '<br>';
    echo '形式：' . $mimeType;
}

6. ファイル情報の活用と安全な設計

6. ファイル情報の活用と安全な設計

ここまで学んだ情報の取得方法を組み合わせることで、高度なファイル管理が可能になります。例えば、「画像ファイルのみを許可し、かつサイズは2MB以内で、保存するときはプログラム側で勝手に決めたランダムな名前にする」といった処理が作れるようになります。

なぜ保存時に名前を変える必要があるのでしょうか？それは、同じ名前のファイルがアップロードされたときに、古いファイルが上書きされて消えてしまうのを防ぐためです。また、日本語のファイル名はサーバーの種類によっては文字化け（文字がぐちゃぐちゃになる現象）を起こすことがあるため、英語と数字だけの名前に変えてあげるのがプロの技です。

Laravelのstoreメソッドなどを使うと、情報を取得したあとにそのまま保存する工程へスムーズに移行できます。まずは情報をしっかり取得して、中身が正しいものかを確認するクセをつけましょう。これにより、初心者でもセキュリティに配慮したプログラミングができるようになります。

ファイル操作は、一見難しそうに見えますが、一つ一つの命令（メソッド）が何をしているのかを理解すれば、パズルのように組み合わせていくだけです。今回の「情報の取得」をマスターすれば、ファイルの移動や削除といった次のステップも驚くほど簡単に感じられるはずです。

まとめ

まとめ

これまでの解説で、Laravelを利用したファイルアップロードにおける情報取得の基本から、実務で役立つ応用的なテクニックまでを詳しく見てきました。Webアプリケーション開発において、ユーザーから送信されるファイルを安全かつ正確に処理することは、システムの信頼性を左右する非常に重要な要素です。

ファイル情報取得の重要ポイント

LaravelのIlluminate\Http\UploadedFileクラスには、ファイルのメタデータを操作するための強力なメソッドが豊富に用意されています。単にファイルを受け取るだけでなく、以下の情報を適切に精査することが、高品質なプログラムへの近道となります。

• getClientOriginalName(): ユーザーがアップロードした際の元のファイル名を特定します。
• getSize(): ファイルの容量（バイト単位）を確認し、サーバー負荷やストレージ容量を管理します。
• getClientOriginalExtension(): 拡張子を確認し、許可されたファイル形式（jpg, pdfなど）か判別します。
• getMimeType(): ファイルの「中身」を厳密に判定し、セキュリティリスクを回避します。

実践的なコード例：情報の統合的な取得

実際の開発現場では、これらのメソッドを組み合わせて、バリデーション（検証）や保存処理の前に一括で情報をログに記録したり、データベースへ保存するための準備を行ったりします。以下に、取得した情報を連想配列にまとめて整理する実践的なサンプルプログラムを紹介します。

// Requestからファイルオブジェクトを取得
$uploadFile = $request->file('user_report');

// ファイルが存在し、かつアップロードが有効かを確認
if ($request->hasFile('user_report') && $uploadFile->isValid()) {
    // 各種情報を取得して配列に格納
    $fileDetails = [
        'name' => $uploadFile->getClientOriginalName(),
        'extension' => $uploadFile->getClientOriginalExtension(),
        'size_bytes' => $uploadFile->getSize(),
        'size_kb' => round($uploadFile->getSize() / 1024, 2),
        'mime_type' => $uploadFile->getMimeType(),
    ];

    // デバッグ用に出力（実際の開発ではDB保存などに利用）
    print_r($fileDetails);
} else {
    echo 'ファイルのアップロードに失敗したか、ファイルが選択されていません。';
}

上記のコードを実行すると、以下のような形式でファイルの詳細データが得られます。これにより、プログラム内での条件分岐が非常にスムーズになります。

Array
(
    [name] => resume_tokyo_2026.docx
    [extension] => docx
    [size_bytes] => 204800
    [size_kb] => 200
    [mime_type] => application/vnd.openxmlformats-officedocument.wordprocessingml.document
)

セキュリティとユーザー体験の向上

ファイルを扱う上で忘れてはならないのが、セキュリティ対策です。ユーザーが指定したファイル名をそのまま保存名として使用すると、ディレクトリトラバーサル攻撃の隙を与えたり、既存ファイルを意図せず上書きしたりする危険性があります。Laravelでは、情報を取得した後にstore()やstoreAs()メソッドを使用して、システム側で生成した安全な名前で保存することが推奨されています。

また、ファイルサイズ制限を超えた場合に「なぜエラーになったのか」を具体的（例：2MB以下にしてください等）に伝えることで、ユーザーの利便性は飛躍的に向上します。今回学んだメソッドを駆使して、安全で親切な設計を心がけましょう。

PHPやLaravelの基礎を固めることは、バックエンドエンジニアとしての大きな武器になります。特にAzureなどのクラウド環境へデプロイする際も、ローカルでのファイルハンドリングの理解が、ストレージサービスの活用（Azure Blob Storageなど）にそのまま役立ちます。一歩ずつ、確実に知識を積み上げていきましょう。