Laravel入門:フォームとデータ保存ができる小さなアプリの作り方(PHP)

Laravel入門:フォームとデータ保存ができる小さなアプリの作り方(PHP) Laravel

こんにちは!ともです。問い合わせや申し込みのフォームを作るとき、「入力された内容を、ためておける形にしたい」と思う場面があります。画面だけならHTMLで作れますが、保存の仕組みまで含めると、フレームワークの出番になります。

この記事では、PHPの代表的なフレームワーク「Laravel(ララベル)」を使い、名前とメッセージを入力するとデータベースに保存され、一覧で確認できる小さなアプリを作ります。フォームと保存という、実務で一番よく出てくる形が題材です。

フレームワーク自体が初めての場合は、先に全体像の記事で考え方を押さえておくと読みやすくなります。

フレームワークとは何か

【この記事で分かること】

この記事で分かること
この記事で分かること
  • Laravelで作るフォームアプリの完成形
  • 必要なものとコスト
  • PHPとComposerの用意、プロジェクト作成の手順
  • データの型(モデル)と保存先(データベース)の用意の仕方
  • フォームの表示と、送信された内容を保存する処理の作り方

【完成品のイメージ:入力すると保存され、一覧に出る】

完成品のイメージ:入力すると保存され、一覧に出る
完成品のイメージ:入力すると保存され、一覧に出る

完成すると、ブラウザで開ける入力フォームが手に入ります。名前とメッセージを書いて送信すると、その内容がデータベースに保存され、同じページの下に一覧として表示されます。サーバーを止めても、保存した内容は消えません。

流れは「フォームを表示する→送信を受け取る→保存する→一覧に出す」という、Webアプリの基本の往復です。題材はシンプルですが、住所(URL)と処理の結び付け、画面の部品化、保存の決まりごとなど、フレームワークの基本部品が一通り登場します。

【必要なものとコスト】

必要なものとコスト
必要なものとコスト

PHPもLaravelも無料で公開されているオープンソースです。自分のパソコンの中で動かす範囲では、料金はかかりません。

項目内容
使うツールPHP/Composer(PHPの部品管理ツール)/Laravel/SQLite(初期設定のデータベース)
料金の目安無料(約0円)
前提ターミナルの基本操作/VS Codeなどのエディタ

バージョンの目安として、2026年11月時点でLaravelの現行系列は13系で、PHP 8.3以上が必要です。PHPとComposerをまとめて用意できる公式の道具(Laravel Herdなど)もありますが、用意の仕方の細部は環境で変わるため、この記事では「PHP 8.3以上とComposerがコマンドで使える状態」を出発点にし、細部は公式ドキュメントで確認する形にします。

言語そのものがどんな位置づけかを確認したい場合は、言語全体の記事もあわせてどうぞ。

プログラミング言語とは何か

【難易度と進め方の目安】

難易度と進め方の目安
難易度と進め方の目安

難易度は中くらいです。PHP本体とComposerという2つの用意が必要な分、入口の手順は少し長くなります。目安の所要時間は、初期設定込みで1時間30分前後です。

進め方は「PHPとComposerの確認→プロジェクト作成→データの型決め→フォーム画面→保存の処理→動作確認」の順番です。エディタはVS Codeがあると作業がしやすくなります。

VS Codeのインストールと初期設定

【インストール・初期設定】

インストール・初期設定
インストール・初期設定

まず、PHPとComposerが使えるかを確認します。ターミナルでバージョンが表示されれば用意ができています。表示されない場合は、公式サイトの案内に沿って先に用意してください(PHPは php.net、Composerは getcomposer.org が公式の配布元です)。

# PHPのバージョンを表示する(8.3以上が目安)
php -v

# Composerのバージョンを表示する(部品管理ツールが使えるか確認)
composer -V

確認できたら、プロジェクトを作ります。作成には少し時間がかかります。

# Laravelのプロジェクトを作成する(contact-app という名前のフォルダができる)
composer create-project laravel/laravel contact-app

# できたプロジェクトのフォルダへ移動する
cd contact-app

# 開発サーバーを起動する(ブラウザで http://127.0.0.1:8000 を開く)
php artisan serve

Laravelの案内ページが表示されれば土台は動いています。「php artisan」は、プロジェクト専用の作業コマンドです。この先も、データの型作りや保存先の用意で何度も使います。サーバーは「Ctrl+C」で止められます。

【作り方の骨格1:データの型と保存先を用意する】

作り方の骨格1:データの型と保存先を用意する
作り方の骨格1:データの型と保存先を用意する

保存するデータの型(モデル)と、保存先のテーブルを用意します。Laravelでは、型とテーブルの設計図をセットで生成するコマンドがあります。

# 「Inquiry(問い合わせ)」のモデルと、テーブル設計図(マイグレーション)を一緒に作る
php artisan make:model Inquiry -m

生成された設計図(database/migrations フォルダ内のファイル)に、保存したい項目を書き足します。名前とメッセージの2項目です。

// テーブルを作るときの処理(設計図の「up」の中身)
public function up(): void
{
    // inquiries テーブルを作成する
    Schema::create('inquiries', function (Blueprint $table) {
        // 自動で番号が付く主キー
        $table->id();
        // 名前:短い文字列の項目
        $table->string('name');
        // メッセージ:長めの文字列の項目
        $table->text('message');
        // 作成日時と更新日時を自動で記録する項目
        $table->timestamps();
    });
}

設計図ができたら、データベースへ反映します。初期設定ではSQLiteという軽いデータベースが使われ、プロジェクト内のファイルとして保存先が作られます。

# 設計図をデータベースへ反映する(テーブルが作られる)
php artisan migrate

モデル側(app/Models/Inquiry.php)には、「保存してよい項目」を明示します。これは、想定外の項目が紛れ込まないようにするための決まりです。

<?php

// モデルが属する名前空間の宣言
namespace App\Models;

// データの型の土台を読み込む
use Illuminate\Database\Eloquent\Model;

// 問い合わせデータの型
class Inquiry extends Model
{
    // フォームからの保存を許可する項目(名前とメッセージだけ)
    protected $fillable = ['name', 'message'];
}

【作り方の骨格2:フォームの表示と保存の処理を作る】

作り方の骨格2:フォームの表示と保存の処理を作る
作り方の骨格2:フォームの表示と保存の処理を作る

次に、画面と処理を用意します。処理を担うファイル(コントローラ)を生成し、住所(URL)との対応を登録します。

# 問い合わせの処理を担うコントローラを生成する
php artisan make:controller InquiryController

生成された app/Http/Controllers/InquiryController.php に、表示と保存の処理を書きます。

<?php

// 表示の処理:保存済みの一覧を取り出して、画面へ渡す
public function index()
{
    // 新しい順に並べた問い合わせの一覧を取得する
    $inquiries = Inquiry::latest()->get();

    // 画面(inquiries.index)へ一覧を渡して表示する
    return view('inquiries.index', compact('inquiries'));
}

// 保存の処理:フォームから送られた内容を受け取って保存する
public function store(Request $request)
{
    // 入力の決まりをチェックする(名前とメッセージは必須)
    $validated = $request->validate([
        'name' => 'required|max:50',
        'message' => 'required|max:1000',
    ]);

    // チェックを通った内容だけを、データベースへ保存する
    Inquiry::create($validated);

    // 保存後は一覧の住所へ戻り、完了の知らせを添える
    return redirect('/inquiries')->with('status', '保存しました');
}

住所の対応(routes/web.php)には、表示と保存の2行を登録します。

// 問い合わせ一覧の住所(開く操作)に、表示の処理を結びつける
Route::get('/inquiries', [InquiryController::class, 'index']);

// フォーム送信の住所(送る操作)に、保存の処理を結びつける
Route::post('/inquiries', [InquiryController::class, 'store']);

画面(resources/views/inquiries/index.blade.php)は、入力フォームと一覧を並べた形にします。フォームには、送信の安全確認のための決まりの1行(@csrf)を含めます。

<!-- 入力フォーム:送信先は保存の住所、方式はPOST -->
<form method="POST" action="/inquiries">
  <!-- 送信元の確認のための決まりの行(Laravelのフォームでは必須) -->
  @csrf
  <!-- 名前の入力欄 -->
  <label>名前 <input type="text" name="name"></label>
  <!-- メッセージの入力欄 -->
  <label>メッセージ <textarea name="message"></textarea></label>
  <!-- 送信ボタン -->
  <button type="submit">送信する</button>
</form>

<!-- 保存済みの一覧を1件ずつ表示する -->
@foreach ($inquiries as $inquiry)
  <p>{{ $inquiry->name }}:{{ $inquiry->message }}</p>
@endforeach

サーバーを起動して http://127.0.0.1:8000/inquiries を開き、送信→一覧への表示まで確認できれば完成です。

【つまずきやすい点】

つまずきやすい点
つまずきやすい点

よくあるつまずきは4つです。1つ目は、PHPのバージョンです。Laravel 13系はPHP 8.3以上が前提で、古いPHPではプロジェクト作成の時点で止まります。php -v の数字を最初に確認してください。

2つ目は、保存が「項目が許可されていない」というエラーで止まることです。モデル側の「保存してよい項目」($fillable)に書き忘れがないかを確認します。これは事故防止のための仕組みなので、外すのではなく項目を足すのが正しい直し方です。

3つ目は、フォーム送信時のエラー(419という数字が表示される)です。フォーム内の @csrf の行が抜けていると、確認のための仕組みが働いて送信が止まります。生成したフォームには必ず含めてください。

4つ目は、マイグレーションの反映忘れです。設計図を直したのに画面がエラーのまま、という場合は、php artisan migrate を実行したか振り返ってください。

【まとめ】

まとめ
まとめ

Laravelの入門は、「プロジェクト作成→モデルと設計図の用意→データベースへ反映→コントローラと住所の登録→画面の用意」という流れで進みます。フォームと保存という基本の往復の中に、フレームワークの部品の役割が一通り出てくる構成です。

「決まった型でCRUDの骨格を一気に生成したい」という場合は、Rubyのフレームワークの作例も比較してみてください。

Ruby on Rails入門:CRUDアプリの骨格を作る手順

作ったプロジェクトはGitで記録しておくと、設計図の変遷まで残って安心です。

GitのインストールとGitHub連携の手順

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました