Laravelでアップロードファイル情報を取得！ファイル名やサイズ取得を初心者向けに解説

1. Laravelのファイルアップロードの仕組みとは？

1. Laravelのファイルアップロードの仕組みとは？

パソコンやスマートフォンからサーバーへファイルを送ることをアップロードと呼びます。Laravelという便利な道具（フレームワーク）を使うと、この複雑な処理をとても短い命令で実行できます。

ユーザーがブラウザの画面でファイルを選択して「送信」ボタンを押すと、そのデータは「リクエスト」という形でサーバーに届きます。Laravelでは、この届いたデータの中からファイルだけを取り出して、その名前が何であるか、データの重さ（サイズ）がどれくらいか、といったプロパティ（属性情報）を調べることができます。

これらを理解することで、「大きすぎるファイルは受け取らないようにする」「ファイル名を自動で書き換えて保存する」といった高度な機能が作れるようになります。まずは基本となる「情報の取り出し方」をマスターしましょう。

2. フォームからファイルを受け取る準備

2. フォームからファイルを受け取る準備

ファイルを送るためには、まずHTMLという言語で「入力画面（フォーム）」を作る必要があります。ここで非常に重要なのが、formタグに指定する設定です。

ファイルを扱うときは必ずenctype="multipart/form-data"という記述を追加しなければなりません。これは「このフォームでは文字だけでなく、ファイルという重たいデータも送りますよ」とブラウザに教えるための合言葉です。これがないと、プログラム側でファイルを受け取ることができません。

<form action="/upload" method="POST" enctype="multipart/form-data">
    <input type="file" name="user_file">
    <button type="submit">アップロード開始</button>
</form>

上記のコードでは、name="user_file"という名前を付けています。この名前を使って、後ほどLaravelのプログラム側でファイルを探し出すことになります。

3. アップロードされたファイルが存在するか確認する

3. アップロードされたファイルが存在するか確認する

プログラムを書く際に大切なのは、いきなり処理を始めないことです。もしユーザーがファイルを選択せずに送信ボタンを押してしまった場合、無理に情報を取得しようとするとエラーが発生して画面が真っ白になってしまいます。

そこで、hasFileという命令を使って「指定した名前のファイルが本当に届いているか」を確認します。また、ファイルが壊れずに正しく届いているかをチェックするisValidという命令も併せて使うのが一般的です。

public function upload(Request $request)
{
    if ($request->hasFile('user_file') && $request->file('user_file')->isValid()) {
        // ファイルが存在し、かつ正常な場合の処理をここに書く
        return "ファイルを受け取りました！";
    }
    return "ファイルが選択されていないか、エラーが発生しました。";
}

Request（リクエスト）とは、ブラウザから届いたすべての情報が入っているカバンのようなものです。このカバンの中からfile('名前')という命令で、特定のファイルを取り出します。

4. ファイルの基本情報を取得するメソッド一覧

4. ファイルの基本情報を取得するメソッド一覧

ファイルが無事に受け取れたら、いよいよ詳細な情報を取得しましょう。Laravelには、特定の情報を抜き出すためのメソッド（命令）が用意されています。

よく使われるのは以下の項目です。

• getClientOriginalName()：ユーザーのパソコン上での元のファイル名を取得します。
• extension()：ファイルの「拡張子（.jpgや.pngなど）」を取得します。
• getSize()：ファイルのサイズを「バイト」という単位で取得します。
• getMimeType()：ファイルの種類（image/jpegなど）を詳しく判別します。

これらの命令を組み合わせることで、どのようなファイルが送られてきたのかを正確に把握することができます。

5. 実践：ファイル名とサイズを表示するプログラム

5. 実践：ファイル名とサイズを表示するプログラム

では、実際に受け取ったファイルの名前とサイズを変数に代入して、画面に表示するプログラムを書いてみましょう。変数は、データを一時的に入れておくための箱のようなものです。

public function showFileInfo(Request $request)
{
    // ファイルを取得
    $file = $request->file('user_file');

    // 元のファイル名を取得
    $fileName = $file->getClientOriginalName();

    // ファイルサイズを取得（単位：バイト）
    $fileSize = $file->getSize();

    // 拡張子を取得
    $extension = $file->extension();

    return "ファイル名：" . $fileName . "<br>" .
           "サイズ：" . $fileSize . "バイト<br>" .
           "拡張子：" . $extension;
}

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

ファイル名：summer_vacation.jpg
サイズ：102400バイト
拡張子：jpg

このように、直感的な名前の命令を使うだけで、プログラミング初心者でも簡単にファイル情報を扱うことができます。

6. ファイルサイズの単位を変換して読みやすくする

6. ファイルサイズの単位を変換して読みやすくする

getSize()で取得できる数値は「バイト」単位です。しかし、大きなファイルになると「1048576バイト」のように表示されてしまい、人間には分かりにくくなります。一般的には「KB（キロバイト）」や「MB（メガバイト）」という単位に変換することが多いです。

1KBは1024バイト、1MBは1024KBです。計算式を使って、単位を変換してみましょう。

public function formatSize(Request $request)
{
    $file = $request->file('user_file');
    $bytes = $file->getSize();

    // バイトをキロバイト(KB)に変換して小数点第2位で切り捨て
    $kiloBytes = round($bytes / 1024, 2);

    return "このファイルの容量は " . $kiloBytes . " KB です。";
}

このように少し工夫するだけで、ユーザーにとって非常に優しいシステムになります。算数の計算と同じ感覚でプログラムを作ることができるのがLaravelの魅力です。

7. 安全なファイル保存のために拡張子をチェックする

7. 安全なファイル保存のために拡張子をチェックする

不特定多数の人がファイルをおくれるようにすると、中には悪意のあるコンピュータウイルスを含んだファイルを送ろうとする人がいるかもしれません。そのため、保存する前に必ず「画像ファイルなのか」「PDFなのか」といった拡張子チェックを行う必要があります。

extension()メソッドを使うと、Laravelがファイルの中身を自動で判断して正しい拡張子を返してくれます。ユーザーが嘘のファイル名を付けていても見破ることができるので、非常に安全です。

public function checkSecurity(Request $request)
{
    $file = $request->file('user_file');
    $ext = $file->extension();

    if ($ext === 'jpg' || $ext === 'png') {
        return "画像ファイルを確認しました。保存可能です。";
    } else {
        return "画像以外のファイルはアップロードできません。";
    }
}

セキュリティを意識したプログラムを書くことは、プロの開発者への第一歩です。Laravelの機能を活用して、安全なウェブサイトを目指しましょう。

8. ファイル操作でよく使われる用語集

8. ファイル操作でよく使われる用語集

ここまでに出てきた難しい言葉を整理しておきましょう。

これらの用語は、Laravelだけでなくプログラミング全般で使われる共通の言葉です。少しずつ覚えていくことで、リファレンス（説明書）を読むのが楽しくなっていきます。

9. 保存時のファイル名を自動生成する方法

9. 保存時のファイル名を自動生成する方法

最後に、取得した情報を活用してファイルを保存する方法に触れておきます。ユーザーがアップロードした名前をそのまま使うと、同じ名前のファイルが既にあった場合に上書きされてしまう危険があります。

そのため、現在の時刻やランダムな英数字を使って、世界に一つだけのファイル名を作るのが一般的です。Laravelには、ファイル情報を取得しつつ、そのまま保存まで行ってくれる便利な機能も備わっています。

public function storeFile(Request $request)
{
    $file = $request->file('user_file');

    // ファイル情報を取得しつつ、'uploads'フォルダにランダムな名前で保存
    $path = $file->store('uploads');

    return "ファイルはここに保存されました：" . $path;
}

このように、Laravelは裏側でファイル名を安全なものに変換し、保存場所まで管理してくれます。情報の取得から保存まで、一連の流れが非常にスムーズに設計されていることが分かりますね。

まとめ

まとめ

今回の記事では、Laravelを利用してアップロードされたファイルから様々な情報を取得する方法について詳しく学習してきました。初心者の方にとって、サーバーにファイルを送るという処理は少し難しく感じるかもしれませんが、LaravelのRequestオブジェクトを活用することで、驚くほど簡単にファイル名、ファイルサイズ、拡張子、MIMEタイプといった重要なメタデータを取り出すことが可能になります。

ファイルを扱うための大原則とセキュリティ

まず、HTMLフォームを作成する際には、必ずenctype="multipart/form-data"という属性を付与することを忘れないでください。これが記述されていないと、ブラウザはファイルデータを送信せず、サーバー側でファイルを受け取ることができません。これは非常によくあるミスのひとつですので、プログラムが動かないときは真っ先に確認すべきポイントです。

また、実務レベルのアプリケーション開発において最も重要なのは「バリデーション（妥当性確認）」です。ユーザーから送られてくるデータが常に正しいとは限りません。hasFile()メソッドでファイルの存在を確認し、さらにisValid()メソッドでアップロードが正常に完了したかをチェックする癖をつけましょう。これにより、予期せぬエラーでシステムが停止するリスクを大幅に軽減できます。

主要なメソッドの振り返りと応用

ファイル情報を取得するために使用した主なメソッドを再度整理しておきましょう。

• getClientOriginalName()：ユーザーの手元にある時のファイル名を取得。
• getSize()：ファイル容量をバイト単位で取得。
• extension()：ファイルの中身から判断した安全な拡張子を取得。
• getMimeType()：ファイルの種類（形式）を詳細に判別。

特にextension()メソッドは、ユーザーが手動で書き換えた拡張子ではなく、ファイルの内容を解析して本来の形式を教えてくれるため、セキュリティ対策として非常に強力です。画像アップロード機能を作る際には、このメソッドで取得した値が「jpg」や「png」であることを確認してから保存処理に進むようにしましょう。

さらに一歩進んだファイル操作のサンプル

最後に、これまでの知識を総動員して、ファイル情報を一括で取得しつつ、人間が読みやすい形式に加工して出力する実践的なサンプルコードをご紹介します。このコードをコントローラーに貼り付けて動作を確認してみてください。

public function handleFileUpload(Request $request)
{
    // ファイルが正しくアップロードされているか確認
    if ($request->hasFile('user_file') && $request->file('user_file')->isValid()) {
        $file = $request->file('user_file');

        // 各種情報を変数に格納
        $originalName = $file->getClientOriginalName();
        $mimeType = $file->getMimeType();
        $rawSize = $file->getSize();

        // サイズをMB（メガバイト）に変換して整形
        $formattedSize = round($rawSize / 1024 / 1024, 2) . ' MB';

        // 判定ロジック：画像ファイルかどうかを確認
        $isImage = str_contains($mimeType, 'image') ? 'はい' : 'いいえ';

        // 結果をまとめて表示（実際はビューに渡すのが一般的です）
        return "アップロード完了！<br>" .
               "ファイル名: " . $originalName . "<br>" .
               "形式: " . $mimeType . "<br>" .
               "容量: " . $formattedSize . "<br>" .
               "画像ですか？: " . $isImage;
    }

    return "ファイルのアップロードに失敗しました。設定を確認してください。";
}

実行結果のイメージは以下の通りです。

アップロード完了！
ファイル名: profile_picture.png
形式: image/png
容量: 1.45 MB
画像ですか？: はい

このように、Laravelが提供するメソッドを組み合わせるだけで、非常に高度なファイル管理システムを構築する土台ができあがります。ファイルアップロードは、ブログ記事の投稿、プロフィール画像の変更、資料共有サイトなど、あらゆるウェブサービスで必須となる技術です。基本をしっかりと固めて、次のステップである「クラウドストレージ（Amazon S3やAzure Blob Storage）への保存」などにも挑戦していきましょう。

プログラミングの学習において、実際にコードを書いて動かしてみることに勝る上達法はありません。ぜひご自身の環境で、様々なファイルをアップロードして、どのような情報が返ってくるのか試してみてください。