• ホームページ
  • 記事
  • SEO
  • Laravel ファイルのアップロード: 包括的なステップバイステップのチュートリアル

Laravel ファイルのアップロード: 包括的なステップバイステップのチュートリアル

公開: 2024-10-07

目次

トグル

Laravelファイルのアップロード

ファイルのアップロードは多くの Web アプリケーションで不可欠な機能であり、ユーザーは画像、ドキュメント、ビデオなどのさまざまな種類のファイルをアップロードできます。人気の PHP フレームワークである Laravel は、ファイルのアップロードをスムーズかつ安全に処理する方法を提供します。このチュートリアルでは、Laravel でファイルのアップロードを設定および実装する方法を最初から検討します。初心者でも中級開発者でも、このガイドは Laravel でのファイルのアップロードをマスターするのに役立ちます。

1. Laravel ファイルアップロードの概要

ファイルのアップロードは、最新の Web アプリケーションに不可欠です。プロフィール写真、履歴書、マルチメディア コンテンツをアップロードする場合でも、信頼性が高く安全なファイル アップロード システムを使用することが重要です。 Laravel には組み込み関数があり、このプロセスを簡単かつ効率的に行うことができます。ファイルの検証、ストレージ、セキュリティのサポートにより、Laravel はファイルのアップロードを管理するシームレスな方法を提供します。

このチュートリアルでは、次のことを行います。

  • ファイルアップロードフォームを作成します。
  • ファイルの検証を処理します。
  • ファイルをサーバーに保存します。
  • アップロードされたファイルを表示します。
  • ファイルアップロードプロセスを保護します。

このガイドを終えると、Laravel アプリケーションでファイルのアップロードを実装およびカスタマイズする方法をしっかりと理解できるようになります。

2. 前提条件

チュートリアルに入る前に、次のものがマシンにインストールされていることを確認してください。

  • PHP >= 8.0
  • Composer(PHP の依存関係マネージャー)
  • Laravel9以降
  • データベース管理用のMySQL または SQLite
  • LaravelとPHPの基礎知識

Laravel の設定方法に慣れていない場合は、Laravel の公式ドキュメントを参照するか、次のコマンドを使用して新しい Laravel プロジェクトを作成してください。

バッシュ

コードをコピーする

Composer create-project –prefer-dist laravel/laravel file-upload-tutorial

プロジェクトが作成されたら、プロジェクト フォルダーに移動します。

バッシュ

コードをコピーする

cd ファイルのアップロード チュートリアル

3. Laravelプロジェクトのセットアップ

Laravel プロジェクトがセットアップされたら、基本設定を構成しましょう。

データベース構成:ルート ディレクトリで.envファイルを開き、データベースの資格情報を更新します。 MySQL を使用している場合は、次のフィールドを更新します。
平文
コードをコピーする
DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=laravel_upload

DB_USERNAME=ルート

DB_PASSWORD=

.envファイルを構成した後、次のコマンドを実行してデフォルトのテーブルを移行します。
バッシュ
コードをコピーする
php 職人の移行

A. ブートストラップのインストール (オプション)

アップロード フォームのスタイルを設定するには、簡単に Bootstrap を含めることができます。 resource/views/layoutsフォルダーに、 layout.blade.phpファイルを作成し、Bootstrap を含めます。

html
コードをコピーする
<!DOCTYPE html>

<html lang=”ja”>

<頭>

<meta charset=”UTF-8”>

<meta name=”viewport” content=”width=デバイス幅、初期スケール=1.0″>

<title>ファイルアップロードのチュートリアル</title>

<link href=”https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css” rel=”stylesheet”>

</head>

<本文>

<div class=”コンテナ mt-5″>

@yield('コンテンツ')

</div>

</body>

</html>

4. ファイルアップロードフォームの作成

次に、ファイルアップロードフォームを作成しましょう。

コントローラーの作成:ファイルのアップロードを処理するコントローラーを生成します。
バッシュ
コードをコピーする
php 職人 make:controller FileUploadController

フォームを定義します。resources/viewsフォルダーに、次のコードを含むUpload.blade.phpというファイルを作成します。
 html
コードをコピーする
@extends('レイアウト.レイアウト')

@section('コンテンツ')

<div class=”row”>

<div class=”col-md-6 offset-md-3″>

<h3 class=”text-center”>ファイルをアップロードする</h3>

<form action=”{{route('file.upload.post') }}” Method=”POST” enctype=”multipart/form-data”>

@csrf

<div class=”form-group mb-3”>

<label for=”file”>ファイルを選択してください:</label>

<input type=”file” class=”form-control” name=”file” id=”file”>

@error('ファイル')

<small class=”text-danger”>{{ $message }}</small>

@enderror

</div>

<button type=”submit” class=”btn btn-primary”>アップロード</button>

</form>

</div>

</div>

@endsection

ルートのセットアップ: routes/web.phpファイルで、フォームの表示とファイルのアップロードの処理のためのルートを定義します。
 php
コードをコピーする
App\Http\Controllers\FileUploadController を使用します。

Route::get('upload', [FileUploadController::class, 'showForm'])->name('file.upload');

Route::post('upload', [FileUploadController::class, 'uploadFile'])->name('file.upload.post');

5. ファイルアップロードロジックの処理

FileUploadController.phpに、ファイルのアップロード プロセスを処理するロジックを記述します。

フォームを表示します:
php
コードをコピーする
パブリック関数 showForm() {

return view('upload');

}

ファイルのアップロードを処理します:
同じコントローラーに、ファイルのアップロードを処理する次のメソッドを追加します。
 php
コードをコピーする
パブリック関数uploadFile(Request $request) {

// アップロードされたファイルを検証します

$request->validate([

'file' => 'required|file|mimes:jpeg,png,pdf,docx|max:2048',

]);

// ファイルを保存する

if ($request->file('file')) {

$fileName = time() 。 '_' 。 $request->file->getClientOriginalName();

$filePath = $request->file('file')->storeAs('uploads', $fileName, 'public');

}

return back()->with('success', 'ファイルは正常にアップロードされました。');

}

このメソッドはファイル検証を実行し、ファイルが存在するかどうかを確認し、 storeAsメソッドを使用してファイルを保存します。

6. ファイルのアップロードの検証

検証は、ユーザーが許可されたファイルの種類とサイズのみをアップロードできるようにするために重要です。 Laravel のvalidateメソッドは、このプロセスを簡素化します。ここで使用される検証ルールは次のとおりです。

  • required : ファイルがアップロードされていることを確認します。
  • file : アップロードされたアイテムがファイルであることを確認します。
  • mimes : 許可されるファイル タイプ (jpeg、png、pdf、docx など) を指定します。
  • max : 最大ファイル サイズをキロバイト単位で指定します (例: 2048 KB = 2 MB)。

これらのルールは、アプリケーションの要件に合わせてカスタマイズできます。

7. ファイルの保存

Laravel のStorageファサードを使用すると、ファイルを簡単に保存できます。上の例では、 storeAsメソッドを使用してファイルをpublic/uploadsディレクトリに保存します。 public/uploadsフォルダーにアクセスできるようにするには、ストレージ ディレクトリをパブリック フォルダーにリンクする必要があります。次のコマンドを実行します。

バッシュ

コードをコピーする

php 職人ストレージ:リンク

このコマンドは、 storage/app/publicからpublic/storageへのシンボリック リンクを作成します。

8. アップロードしたファイルの表示

アップロードされたファイルを表示するには、ストレージ フォルダーからファイルを取得し、ストレージファサードを使用して URL を生成します。画像やファイルを表示する方法は次のとおりです。

コントローラー内:
php
コードをコピーする
パブリック関数 showUploads() {

$files = Storage::disk('public')->files('uploads');

return view('アップロード', コンパクト('ファイル'));

}

  1. ビュー内:

resource/views/uploads.blade.phpファイルを作成します。
 html
コードをコピーする
@extends('レイアウト.レイアウト')

@section('コンテンツ')

<h3>アップロードされたファイル:</h3>

<ul>

@foreach($files を $file として)

<li><a href=”{{asset('storage/' . $file) }}”>{{basename($file) }}</a></li>

@endforeach

</ul>

@endsection

  1. これにより、ダウンロード リンクを含むアップロードされたファイルのリストが生成されます。

9. ファイルアップロードの保護

ファイルのアップロードは、適切に処理されないとセキュリティ上のリスクを引き起こす可能性があります。ファイルのアップロードを安全にするためのベスト プラクティスをいくつか紹介します。

  • 許可されるファイル タイプを制限する: M​​IMEルールを使用してファイル タイプを常に検証します。
  • ファイル サイズを制限する: ファイル サイズを制限して、サーバー リソースの過剰な消費を防ぎます。
  • 適切なファイル名を使用する: 既存のファイルが上書きされないように、一意の名前を使用してファイルを保存します。
  • ファイルのスキャン: 悪意のあるアップロードを検出するには、ウイルス対策ツールまたはファイル スキャン ツールの使用を検討してください。
  • パブリック アクセスを制限する: パブリックにアクセスできるディレクトリに機密ファイルを保存しないようにします。 Laravel のプライベート ファイル用のストレージディレクトリを使用し、それらを安全に提供するコントローラーを作成できます。

10. 結論

ファイルのアップロードは多くの Web アプリケーションにとって重要な機能であり、Laravel は組み込みのツールと機能を使用してプロセスを簡素化します。このチュートリアルでは、ファイルのアップロードの設定、ファイルの検証と保存、表示、アップロード プロセスの保護の基本について説明しました。この基盤を使用すると、プロジェクトのニーズに合わせてファイル アップロード機能をカスタマイズおよび拡張できます。