こんにちは!ともです。問い合わせや申し込みのフォームを作るとき、「入力された内容を、ためておける形にしたい」と思う場面があります。画面だけなら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があると作業がしやすくなります。
【インストール・初期設定】

まず、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:データの型と保存先を用意する】

保存するデータの型(モデル)と、保存先のテーブルを用意します。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:フォームの表示と保存の処理を作る】

次に、画面と処理を用意します。処理を担うファイル(コントローラ)を生成し、住所(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で記録しておくと、設計図の変遷まで残って安心です。
なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。
\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /


コメント