coiai Logo
ホーム記事コラムPodcast会社情報
お問い合わせ

MVC とは?を理解するために簡単なアプリをつくる with Laravel

❓ これは何

ソフトウェアを構築するには、様々な設計モデルがあります。

今回はバックエンドの開発で基礎的で代表的なMVCモデルを少しわかったつもりになるために、
簡単なメモアプリを作ります。

この記事では Laravel を使っています。
まだ Hello World ができていない方は、先に済ませておきましょう。
M1 mac でLaravel のHelloWorldする方法

このページでの🐏はコラムです。読み飛ばしてOKです。

今回完成すると次のようなものになります。
この記事ではスタイリングなどの解説はしていません。
1時間内でとりあえず作ることを目標にしています。

🪴 環境

この記事では Apple Silicon に合わせた書き方になっている箇所があります。(Docker関係)
ご注意ください。

  • Apple m1 MacBook Air
  • 14.5(23F79)

🔧 やり方

MVC(Model-View-Controller)は、ソフトウェア設計の基本原則の一つです。

アプリケーションの構造を

  • Model
  • View
  • Controller

の3つの部分に分けることで、保守性と可読性を向上させます。

🐳 初期設定

ここではApple m1 での設定となっています。
主にDockerに関する操作についてです。

docker-compose.yml は次のようにしました。

version: '3.8'
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    image: laravel-app
    container_name: laravel-app
    restart: unless-stopped
    working_dir: /var/www
    volumes:
      - .:/var/www
    networks:
      - laravel
    environment:
      - DB_CONNECTION=mysql
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=your_database_name
      - DB_USERNAME=your_database_user
      - DB_PASSWORD=your_database_password

  webserver:
    image: arm64v8/nginx:alpine
    container_name: webserver
    restart: unless-stopped
    ports:
      - "8000:80"
    volumes:
      - .:/var/www
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    networks:
      - laravel

  db:
    image: arm64v8/mariadb:10.5
    container_name: db
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=your_database_name
      - MYSQL_USER=your_database_user
      - MYSQL_PASSWORD=your_database_password
    volumes:
      - dbdata:/var/lib/mysql
    ports:
      - "3306:3306"
    networks:
      - laravel

volumes:
  dbdata:

networks:
  laravel:
    driver: bridge

.env ファイルに次のコードを追記します。

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password

コンテナを起動し、コンテナにアクセスします。

docker-compose up -d
docker-compose exec app bash

migrate したら exit します。

php artisan migrate

マイグレーションファイルの作成

Laravelでは、マイグレーションファイルを使ってデータベーススキーマ(スキーマとは簡単にいうと構造のこと)の変更を定義します。
マイグレーションファイルは、PHPコードでデータベースのテーブルやカラムの追加、削除、変更を記述します。

database/migrationsディレクトリに新しいマイグレーションファイルを生成します。

notes というテーブルが作成されます。

実行後、database/migrations/ホゲホゲcreate_notes_table.php というファイルが作成されていると思います。(ホゲホゲには日付などが入っているはず)

php artisan make:migration create_notes_table --create=notes

🐏 php artisan とは?

  • command: 実行するコマンド(例: make:migration, serve, migrateなど)
  • options: オプションとして指定するもの(例: –force, –quietなど)
  • arguments: コマンドに渡す引数(例: マイグレーションの名前など)
php artisan [command] [options] [arguments]

create_notes_table.php

function up()の中身を次のように追記します。

upメソッド
マイグレーションを適用する際に実行されます。
例では、notesテーブルを作成し、
id, title, content, timestamps
のカラムを定義しています。

downメソッド
マイグレーションをロールバックする際に実行されます。
例では、notesテーブルを削除しています。
ロールバックとはデータベースのマイグレーションを元に戻す操作を指します。具体的には、適用されたマイグレーションを取り消し、以前の状態に戻すことです。

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    /**
     * Run the migrations.
     */
    public function up(): void
    {
        Schema::create('notes', function (Blueprint $table) {
            $table->id();
            $table->string('title');
            $table->text('content');
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     */
    public function down(): void
    {
        Schema::dropIfExists('notes');
    }
};

マイグレーションを実行します。
このコマンドで上記コードのupが実行されることになります。。

php artisan migrate

📦 MODEL

メモモデルの作成

モデルはデータベースとのやり取りや、データの検証の実装を担当します。

メモアプリケーションでは、Noteモデルがこれに該当します。Noteモデルはメモのデータ(タイトルと内容)を管理します

メモモデルの作成

php artisan make:model Note

modelsの中の Note.php に次のコードを記述します。

use HasFactory;
Laravelのファクトリ機能を使用します。

protected $fillable = [‘title’, ‘content’];:
マスアサインメントを許可する属性を指定します。

マスアサインメント(Mass Assignment)とは、配列やオブジェクトからモデルの複数の属性に一括で値を割り当てることです。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Note extends Model
{
    use HasFactory;

    /**
     * The attributes that are mass assignable.
     *
     * @var array
     */
    protected $fillable = [
        'title',
        'content',
    ];
}

🐏 use HasFactory; とは?

ファクトリは、テストデータを作成するクラスであるFactoryを使用して、データベーステーブルにランダムなデータを生成する機能です。

🎮 CONTROLLER

controller の作成

コントローラーはユーザーの入力に応じてモデルとビューを調整します。
リクエストを受け取り、適切なモデルとビューを呼び出してレスポンスを返します。

メモアプリケーションでは、NoteControllerがコントローラーに該当します。
NoteControllerはメモの作成、表示、編集、削除のロジックを担当します。

メモコントローラの作成

php artisan make:controller NoteController --resource

app/Http/Controllers/NoteController.php に次のコードを追加します。

各メソッドは、特定のアクション(一覧表示、作成、保存、表示、編集、更新、削除)を担当します。

リクエストを処理し、適切なビューを返します。

$request->validate([
       'title' => 'required',  // タイトルは必須
       'content' => 'required', // 内容も必須
]);

こういった書き方で、バリデーションを実装できます。

<?php

namespace App\Http\Controllers;

use App\Models\Note;
use Illuminate\Http\Request;

class NoteController extends Controller
{
    // メモの一覧を表示するメソッド
    public function index()
    {
        // データベースからすべてのメモを取得
        $notes = Note::all();
        
        // 'notes.index'ビューを表示し、取得したメモをビューに渡す
        return view('notes.index', compact('notes'));
    }

    // 新しいメモを作成するフォームを表示するメソッド
    public function create()
    {
        // 'notes.create'ビューを表示
        return view('notes.create');
    }

    // 新しいメモを保存するメソッド
    public function store(Request $request)
    {
        // リクエストデータをバリデート
        $request->validate([
            'title' => 'required',  // タイトルは必須
            'content' => 'required', // 内容も必須
        ]);

        // リクエストデータを使って新しいメモを作成
        Note::create($request->all());

        // メモの一覧ページにリダイレクトし、成功メッセージを表示
        return redirect()->route('notes.index')
                        ->with('success', 'Note created successfully.');
    }

    // 特定のメモを表示するメソッド
    public function show(Note $note)
    {
        // 'notes.show'ビューを表示し、特定のメモをビューに渡す
        return view('notes.show', compact('note'));
    }

    // 特定のメモを編集するフォームを表示するメソッド
    public function edit(Note $note)
    {
        // 'notes.edit'ビューを表示し、特定のメモをビューに渡す
        return view('notes.edit', compact('note'));
    }

    // 特定のメモを更新するメソッド
    public function update(Request $request, Note $note)
    {
        // リクエストデータをバリデート
        $request->validate([
            'title' => 'required',  // タイトルは必須
            'content' => 'required', // 内容も必須
        ]);

        // 特定のメモを更新
        $note->update($request->all());

        // メモの一覧ページにリダイレクトし、成功メッセージを表示
        return redirect()->route('notes.index')
                        ->with('success', 'Note updated successfully');
    }

    // 特定のメモを削除するメソッド
    public function destroy(Note $note)
    {
        // 特定のメモを削除
        $note->delete();

        // メモの一覧ページにリダイレクトし、成功メッセージを表示
        return redirect()->route('notes.index')
                        ->with('success', 'Note deleted successfully');
    }
}

ルートの設定

ルートの設定

routes/web.php に次のコードを追記します。

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\NoteController;

Route::get('/', [NoteController::class, 'index']);

Route::resource('notes', NoteController::class);

👁️ VIEW

Viewの作成

ビューはユーザーインターフェースを表示します。
データの表示やユーザーの入力を受け付けます。

メモアプリケーションでは、index.blade.php、create.blade.php、edit.blade.php、show.blade.phpがビューに該当します。
これらのビューは、メモのリスト表示、作成フォーム、編集フォーム、詳細表示を担当します。

まずは resources/views に layout.blade.php を作ります。

共通レイアウトを定義し、各ビューで使用します。
ヘッダーやフッターなど、どのページでも使うものもここに書いておくと、このファイルの役割がわかりやすいでしょう。

<!DOCTYPE html>
<html>
<head>
    <title>Memo App</title>
</head>
<body>
    @yield('content')
</body>
</html>

Resources/views フォルダに notes というディレクトリを作り、下記ファイルを作成します。

  • index.blade.php
  • create.blade.php
  • edit.blade.php
  • show.blade.php

index.blade.php

メモの一覧を表示し、各メモに対して詳細表示、編集、削除のリンクがあります。

@extends('layout')

@section('content')
    <h1>Notes</h1>
    <a href="{{ route('notes.create') }}">Create a new note</a>
    <ul>
        @foreach ($notes as $note)
            <li>
                <a href="{{ route('notes.show', $note->id) }}">{{ $note->title }}</a>
                <a href="{{ route('notes.edit', $note->id) }}">Edit</a>
                <form action="{{ route('notes.destroy', $note->id) }}" method="POST">
                    @csrf
                    @method('DELETE')
                    <button type="submit">Delete</button>
                </form>
            </li>
        @endforeach
    </ul>
@endsection

🐏 hoge.blade.php とは?

hoge.blade.php とかくと、Laravelが提供するテンプレートエンジンの「Blade」が使用できます。
BladeはPHPのテンプレートエンジンで、HTML, PHP をより見やすく、書きやすくすることが出来ます。

  • @extends(‘layout’)は、layout.blade.phpを継承することを示しています。
  • @section(‘content’)と@endsectionの間に、レイアウトに挿入するコンテンツを記述します。
  • @foreachループを使って、$notesコレクションの各メモを表示します。
  • @csrfはCSRFトークンを生成し、フォームの送信を保護します。
  • @method(‘DELETE’)はHTMLフォームでDELETEメソッドを使うためのBladeディレクティブです。

🐏 CSRFトークンとは?

CSRF(Cross-Site Request Forgery、クロスサイトリクエストフォージェリ)は、
ユーザーが意図しないリクエストをWebアプリケーションに送信する攻撃です。
CSRFトークンは、この攻撃を防ぐために使用されるセキュリティ機構です。

基本的にPOSTの時には @csrf と書いておけばいいでしょう()

create.blade.php

メモの作成フォームです。

@extends('layout')

@section('content')
    <h1>Create Note</h1>
    <form action="{{ route('notes.store') }}" method="POST">
        @csrf
        <label>Title:</label>
        <input type="text" name="title">
        <label>Content:</label>
        <textarea name="content"></textarea>
        <button type="submit">Create</button>
    </form>
@endsection

edit.blade.php

メモの編集フォームです。

@extends('layout')

@section('content')
    <h1>Edit Note</h1>
    <form action="{{ route('notes.update', $note->id) }}" method="POST">
        @csrf
        @method('PUT')
        <label>Title:</label>
        <input type="text" name="title" value="{{ $note->title }}">
        <label>Content:</label>
        <textarea name="content">{{ $note->content }}</textarea>
        <button type="submit">Update</button>
    </form>
@endsection

show.blade.php

メモの詳細画面です。

@extends('layout')

@section('content')
    <h1>{{ $note->title }}</h1>
    <p>{{ $note->content }}</p>
    <a href="{{ route('notes.index') }}">Back to Notes</a>
@endsection

これで完成です!
実行し、確認してみましょう。

投稿日: 2024年7月16日
カテゴリ: Laravel, おすすめ
タグ: プログラミング
coiai

coiai

この記事もおすすめ

「最新版を使えばいい」は本当に正しい?Dependabotを使って“pin + 自動更新”にする理由

「最新版を使えばいい」は本当に正しい?Dependabotを使って“pin + 自動更新”にする理由

依存ライブラリやGitHub Actions、Terraform Providerのバージョン管理をしていると、よく出てくるのが次の考え方です。 新しいバージョンが出たら、常に最新版へ上げればいいのでは? 一見すると合理的です。 実際、古いバージョンを長期間使い続けるより、継続的にアップデートした方が、脆弱性や非互換の問題を後回しにしにくくなります。 ただし、実際の開発運用では、 「バージョンを固定しない」ことと「常に新しい状態を保つ」ことは別です。 むしろ、 バージョンは固定し、Dependabotで自動的に更新PRを作る という運用の方が、安全性と更新頻度を両立しやすくなります。 今回は、実際の開発チームで出た「pinするべきか、しないべきか」という議論をベースに、Dependabotをどう使うべきか整理します。 きっかけは「そもそもpinしなくていいのでは?」という疑問 あるプロジェクトで、GitHub ActionsやTerraform Providerのバージョンを更新する話が出ました。 その中で、 理想的には何もpinしない方がいい。新しいバージョンが出たら常にアップグレードすればいいのでは? という意見が出ました。 この考え方自体は間違っていません。 目標としては、 依存関係を古いまま放置しない というのが正しいです。 ただし、その目標を実現する方法として「pinしない」を選ぶと、別の問題が出てきます。 そこで出てきたのが、 「pinしない」のではなく、「pin + automated bumps」にしよう という考え方です。 つまり、 バージョンは固定する。しかし、更新作業は自動化する。 これがDependabotを使う理由です。 GitHub Actionsでは、floating tagがリスクになる たとえばGitHub Actionsでは、次のような指定をすることがあります。 これは分かりやすく、一般的な書き方です。 ただし、v4 のようなタグは、厳密には「特定のコードそのもの」を表しているわけではありません。 タグが別のコミットを指すように変更されれば、同じ @v4 という記述でも、実際に実行されるコードが変わる可能性があります。 CI/CDで実行されるActionは、ビルド環境やデプロイ権限にアクセスすることがあります。 そのため、これはサプライチェーンセキュリティの観点でも重要です。 より厳密に管理するなら、特定のコミットSHAに固定します。 こうすると、同じ設定から実行されるコードが勝手に変わることはありません。 ただし問題があります。 固定しただけでは、そのバージョンは永遠に古くなっていきます。 そこでDependabotを使います。 新しいバージョンが出たら、 という流れにします。 つまり、 固定することで再現性を確保し、Dependabotで鮮度を維持する [&hellip;]

デフォルトサムネイル

GMKtec EVO-X2にUbuntuを入れたら有線LANが認識されなかった話

オンプレミスAIサーバー(ローカルLLM + 社内文書RAG)の構築を始めました。機材はGMKtec EVO-X2、AMD Ryzen AI Max+ 395搭載のミニPCです。128GBのユニファイドメモリをGPUに大きく割り当てられるので、ローカルLLM用途では今いちばん面白いマシンだと思っています。 この記事は初日の作業ログです。結論から言うと「インストールUSBが起動しない」「有線LANが認識されない」という2つの罠を踏んだので、同じ構成を組む方のために記録しておきます。 OSはLinuxかWindowsか 最初に迷うのがここですが、サーバー用途ならUbuntu Server一択でした。 日常操作はすべてブラウザ(Open WebUI)経由なので、サーバーOSにGUIは不要です。管理画面が欲しければCockpitを入れれば、Webブラウザからメトリクス確認・サービス再起動・ターミナルまで使えます。「CUIのサーバー + Web管理画面」が現代の標準形だと思います。 BIOS設定 ― EVO-X2で一番大事なのはVRAM割り当て 電源ON直後にDel連打でBIOS(AMI)へ入ります。設定したのは3つです。 罠その1: インストールUSBが起動しない Ubuntu Server 24.04のISOをMacから dd でUSBメモリに書き込み、いざブート……しません。Boot Overrideに出てくる「UEFI OS」を選んでもWindowsが立ち上がってしまいます。 切り分けの過程が学びでした。 原因はおそらく、dd の書き込みが完全に終わる前に抜いてしまったことです。dd は進捗表示が止まってからもバッファの書き出しが続くので、完了統計が表示されるまで待たなければいけません。パーティションテーブルはディスク先頭に書かれるため、途中で切れていても一見正常に見えるのが厄介なところです。 教訓: インストールUSB作成はbalenaEtcherを使いましょう。 書き込み後に自動でベリファイ(照合)まで走るので、「書けたつもり」が原理的に起きません。Etcherで書き直したら一発で起動しました。 インストール時の選択 罠その2: 有線LANが認識されない インストール完了、ログイン成功。しかし ip a を見ると有線LANにIPがありません。それどころか、よく見ると有線のインターフェース自体が存在しません。 カーネルログを見て原因が確定しました。 EVO-X2の2.5GbEチップ(Realtek RTL8125D)が新しすぎて、Ubuntu 24.04の標準カーネル6.8のドライバが知らないチップだったのです。インストール中にネットに繋がらなかったのもこれが原因でした。ケーブルを何度挿し直しても無駄だったわけです。 教訓: 「繋がらない」時はケーブルを疑う前に dmesg を読みましょう。 カーネルログには大抵、答えがそのまま書いてあります。 解決: HWEカーネル 新しいチップに対応するには、新しいカーネルを入れれば解決します。Ubuntuには**HWE(Hardware [&hellip;]

FSD v2.1 Feature-Sliced Design を導入する

FSD v2.1 Feature-Sliced Design を導入する

この記事は何? 公式のドキュメントやチュートリアル、exsample を読んで理解するのが一番いいですが、備忘録として残しておきます。特に後述の Skills, Steiger については開発する際にあった方が便利なので、それについても記事にします。 FSDとは? FSD (Feature-Sliced Design) はフロントエンドのアーキテクチャの一つです。 FSDとは責務で分けていくアーキテクチャと違い、ページやエンティティで分けていくアーキテクチャというとわかりやすいと思います。 コードの分離の仕方について話す前に、FSDで前提となる この3つについて理解する必要があります。 レイヤー より細かく分けていく方法がありますが、この記事では導入だけ触れたいので、3つのレイヤーのみ説明します。 です。この流れは上(app)に向かえば向かうほどアプリケーション固有、下(shared)に向かうほど汎用的になります。 原則として上位レイヤーは下位レイヤーを利用できるが、下位レイヤーから上位レイヤーへ依存できません。 始め方としては小さく初めて、必要になったらレイヤーを増やしてくようです。 スライス ブログアプリであればレイヤーの pages には といったページに分けられるため、このような構成になります。このblog-list, blog-detail, user がスライスです。これらはページやエンティティによって分けられます。 セグメント これらのmodel, ui といった部分がエンティティです。これらは責務にあたります。sharedに関しては直下にスライスではなくセグメントが入ります。 FSD 2.1 で重要なのは Pages First です。とにかくPagesから作って、細分化の必要ができたら、下位レイヤーに抽出します。 Steiger Steiger とはアーキテクチャリンターです。以下でインストールできます。 AIコーディングのために Claude Skills https://github.com/feature-sliced/skills?utm_source=chatgpt.com このリポジトリが公式に公開されています。 これで Skills を追加できるので、claude にFSDの設計知識を共有できます。

フロントエンドのアーキテクチャについて最初から考える

フロントエンドのアーキテクチャについて最初から考える

これは何? この記事は基本に立ち戻りアーキテクチャの選定を試みた際の備忘録です。Feature-Sliced Design(FSD)や Vertical Slice Architecture など、モダンなアーキテクチャがありますが、どのような判断をもとに選定するのかを考え直します。 アーキテクチャの地図 アーキテクチャを理解するために、以下のような学習のための地図を作りました。設計原則、アーキテクチャ、個別の設計パターンへと詳細になっていきます。 そもそも、、、 このコードは何を担当しているのかを考えるのが最初の問です。 商品一覧画面を作るときに といったタスクを書き出します。 これら全てを一つの巨大なコンポーネントとして作ることもできますが、管理が大変になるのは皆さんもお分かりだと思います。参考:https://blog.cleancoder.com/uncle-bob/2014/05/08/SingleReponsibilityPrinciple.html?utm_source=chatgpt.com ここからどこまでを同じモジュールとして管理するのか?という設計の問題が始まります。 Cohesion と Coupling CohesionとCouplingはそれぞれ、凝集度、結合度というようです。https://qiita.com/dsudo/items/ee3fee1f558c7f1b359f Cohesionは関係するコードがまとまっているか? Couplingは別のコードにどれだけ依存しているか? です。 例えば以下のようなコードがあります。 技術的な種類ごとに整理されていますが、商品一覧のコーディングをするのにそれぞれ別のディレクトリを行き来する必要があります。一方で、以下のように書いた場合はどうでしょうか? この書き方なら、商品に依存するコードがまとまっています。 この書き方が Feature-based Architecture, Vertical Slice Architecture に繋がっていきます。 コロケーションについて colocation Place code as close to where it&#8217;s relevant as possible 同じ種類のコードを集めることではなく、一緒に変更されるコードを近くに置くことです。 https://kentcdodds.com/blog/colocation?utm_source=chatgpt.com Layered Architecture について ここからアーキテクチャの話です。 Layered Architectureでは、技術的責務でアプリケーションを分離します。 これのメリットは責務がわかりやすいところです。 しかし、この方法では前述までとは変わり、機能を変更するときに、横断して変更する可能性があります。 つまり、技術的には分かれている一方で、機能は複数に分散するわけです。 [&hellip;]

この記事を書いた会社

株式会社coiaiは、「想像できることを美しく実現」を掲げ、XR・Web・アプリ・システム開発およびDX支援を行う会社です。 創業2022年、東京都練馬区に本社を置き、要件のヒアリングからPoC(概念実証)、本番運用まで一貫して伴走します。 まずはお気軽にご相談ください。

商号株式会社 coiai創業2022年1月設立2025年1月23日資本金1,500,000円(設立時点)本社所在地東京都練馬区関町北 3-6-9代表者代表取締役 竹村 啓佑 / 代表取締役 服部 陽良

主なご相談内容

  • Webサイト・Webアプリの設計・開発
  • スマートフォンアプリ(iOS / Android)の開発
  • XR・AR・VRを活用した体験設計・開発
  • DX推進・業務システムの企画・開発
  • PoC(概念実証)から本番運用までの伴走支援
  • マーケティング・コンサルティング
会社概要・役員紹介を見る

詳しい会社情報は会社概要ページでご覧いただけます。

資料請求・無料相談

導入要件のヒアリングからPoC、本番運用まで伴走します。まずはお気軽にご相談ください。

フォームで問い合わせメールで相談

お問い合わせの前に 個人情報保護方針 をご確認ください。

株式会社coiai株式会社coiai

XR, Web, システム開発, DX — 想像できることを美しく実現

メールでお問い合わせ

サービス

on-premise AI

基幹システム Anchor

XR開発

会社情報

会社概要

ブログ

お問い合わせ

法務

プライバシーポリシー


所在地

〒177-0051 東京都練馬区関町北3-6-9

営業時間

平日 10:00-18:00

土日祝 休み

info@coiai.net

© 2023–2026 株式会社coiai. All rights reserved.