[PHPのはじめ方] Part31: Laravelフレームワークの導入と基本操作

Laravelは、現在世界中で最も人気のあるPHPフレームワークの一つです。エレガントで分かりやすい構文が特徴で、Webアプリケーション開発を効率的かつ楽しく進めることができます。

PHPのコードをより構造化し、再利用しやすくするために設計されており、特に中規模から大規模なアプリケーション開発に適しています。

Laravelの主な特徴：

• MVCアーキテクチャ: アプリケーションの関心事をモデル(Model)、ビュー(View)、コントローラ(Controller)に分離し、コードの見通しを良くします。
• Artisanコンソール: データベースのマイグレーション、コード生成、タスク実行など、開発を助ける便利なコマンドラインツールです。
• Eloquent ORM: データベース操作をオブジェクト指向的に、直感的に行えるようにします。
• Bladeテンプレートエンジン: PHPコードをHTML内にシンプルに記述でき、レイアウトの継承なども簡単に実現できます。
• 豊富な組み込み機能: ルーティング、ミドルウェア、認証、キャッシュ、キューなど、Web開発に必要な多くの機能が標準で提供されています。

Laravelを学ぶことで、モダンなPHP開発の手法を身につけ、より効率的に高品質なWebアプリケーションを構築できるようになります。さあ、一緒にLaravelの世界を探検しましょう！✨

必要なもの

Laravelプロジェクトを開始するには、まず以下のツールがコンピュータにインストールされている必要があります。

• PHP: Laravel 11 (2024年3月リリース) を利用する場合、PHP 8.2以上が必要です。それ以前のLaravelバージョンでは要求されるPHPバージョンが異なります。
• Composer: PHPのパッケージ管理ツールです。Laravel本体や関連ライブラリのインストールに使用します。

まだインストールしていない場合は、それぞれの公式サイトを参照してインストールしてください。

Composerでプロジェクト作成

Composerが利用可能になったら、ターミナル（コマンドプロンプト）を開き、プロジェクトを作成したいディレクトリに移動して、以下のコマンドを実行します。

composer create-project laravel/laravel my-laravel-app

my-laravel-app の部分は、あなたの好きなプロジェクト名に変更してください。このコマンドは、最新安定版のLaravelプロジェクトをダウンロードし、必要な依存関係をインストールします。

特定のLaravelバージョンを指定してインストールしたい場合は、次のようにバージョン番号を追加します。（例：Laravel 10系）

composer create-project laravel/laravel my-laravel-app "10.*"

プロジェクトの構造 (一部抜粋)

プロジェクトが作成されると、様々なディレクトリやファイルが生成されます。主要なものをいくつか見てみましょう。

開発用サーバーの起動

Laravelには、開発に便利な組み込みのWebサーバーが用意されています。プロジェクトディレクトリに移動し、以下のArtisanコマンドを実行してみましょう。

cd my-laravel-app
php artisan serve

サーバーが起動すると、通常は http://127.0.0.1:8000 または http://localhost:8000 でアクセスできるようになります。ブラウザでこのURLを開くと、Laravelのウェルカムページが表示されるはずです。✅

ルーティング：リクエストの入り口

Webアプリケーションは、特定のURLへのアクセスに対して、対応する処理を実行します。この「URLと処理を結びつける」仕組みがルーティングです。Laravelでは、主に routes/web.php ファイルでWeb用のルートを定義します。

routes/web.php ファイルを開いてみましょう。初期状態では、ウェルカムページを表示するためのルートが定義されています。

<?php

use Illuminate\Support\Facades\Route;

// ルートURL ('/') へのGETリクエストがあった場合に、
// 'welcome' という名前のビューを返すクロージャ（無名関数）を実行する
Route::get('/', function () {
    return view('welcome');
});

// 新しいルートを追加してみましょう！
// '/hello' へのGETリクエストがあった場合に、文字列を返す
Route::get('/hello', function () {
    return 'Hello Laravel! 👋';
});

ファイルを保存した後、ブラウザで http://localhost:8000/hello にアクセスしてみてください。「Hello Laravel! 👋」と表示されれば成功です！

コントローラ：処理をまとめる場所

ルート定義の中に直接処理（クロージャ）を書くこともできますが、アプリケーションが複雑になってくると、関連する処理をクラスにまとめた方が管理しやすくなります。この処理をまとめるクラスがコントローラです。

以下のArtisanコマンドで、新しいコントローラを作成してみましょう。

php artisan make:controller WelcomeController

このコマンドにより、app/Http/Controllers/WelcomeController.php ファイルが作成されます。中身を以下のように編集してみましょう。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request; // Requestクラスを使わない場合は不要
use Illuminate\View\View; // Viewクラスを使うことを明示 (必須ではない)

class WelcomeController extends Controller
{
    /**
     * ウェルカムページを表示するメソッド
     */
    public function index(): View // 戻り値の型を宣言 (PHP 7.4以降)
    {
        $userName = 'Laravel User'; // ビューに渡すデータ
        // 'greeting' ビューを表示し、'name' というキーで $userName を渡す
        return view('greeting', ['name' => $userName]);
    }

    /**
     * 挨拶メッセージを表示するメソッド
     */
    public function hello(): string // 戻り値の型を宣言
    {
        return 'Hello from WelcomeController! 👋';
    }
}

次に、routes/web.php を編集して、ルートからこのコントローラのメソッドを呼び出すように変更します。

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\WelcomeController; // 作成したコントローラをuse

// '/' へのGETリクエストを WelcomeController の index メソッドに割り当て
Route::get('/', [WelcomeController::class, 'index']);

// '/hello' へのGETリクエストを WelcomeController の hello メソッドに割り当て
Route::get('/hello', [WelcomeController::class, 'hello']);

// 以前のクロージャ定義はコメントアウトまたは削除します
// Route::get('/', function () {
//     return view('welcome');
// });
// Route::get('/hello', function () {
//    return 'Hello Laravel! 👋';
// });

これで、URLへのアクセスがあると、対応するコントローラのメソッドが実行されるようになりました。ただし、/ にアクセスすると、まだ greeting というビューが存在しないためエラーになります。次のステップでビューを作成しましょう。

ビューは、ユーザーに表示されるHTMLなどを生成する役割を担います。Laravelでは、Bladeというシンプルで強力なテンプレートエンジンが標準で用意されています。Bladeを使うと、PHPのロジックをHTML内に簡潔に埋め込んだり、テンプレートの再利用を容易にしたりできます。

ビューファイルは resources/views ディレクトリに配置し、ファイル名は .blade.php という拡張子をつけます。

先ほどコントローラから呼び出すように設定した greeting ビューを作成しましょう。resources/views/greeting.blade.php というファイルを作成し、以下のように記述します。

<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>ごあいさつ</title>
    <!-- bulmaのCDNを追加してみましょう -->
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css">
</head>
<body>
    <section class="section">
        <div class="container">
            <!-- {{ }} はPHPのhtmlspecialcharsを通して変数を安全に表示します -->
            <h1 class="title">こんにちは、 {{ $name }} さん！</h1>

            <!-- @ifディレクティブ: 条件分岐 -->
            @if (strlen($name) > 10)
                <p class="notification is-info">あなたの名前は長いですね！</p>
            @else
                <p class="notification is-success">あなたの名前は素敵ですね！</p>
            @endif

            <h2 class="subtitle">学習リスト</h2>
            <!-- @foreachディレクティブ: 配列のループ -->
            <ul>
                @foreach (['PHP', 'Laravel', 'Blade', 'Artisan'] as $item)
                    <li>{{ $loop->iteration }}. {{ $item }}</li> <!-- $loop変数でループ情報にアクセス可能 -->
                @endforeach
            </ul>

            <!-- @issetディレクティブ: 変数が存在するかチェック -->
            @isset($extraMessage)
                <p class="mt-4 has-text-weight-bold">追加メッセージ: {{ $extraMessage }}</p>
            @endisset

            <!-- {!! !!} はエスケープせずにHTMLを表示します。信頼できないデータには使用しないでください -->
            <div class="mt-4">{!! '<strong>HTMLタグも表示できます</strong>' !!}</div>

            {{-- これはBladeのコメントです。HTMLソースには表示されません --}}
        </div>
    </section>
</body>
</html>

このファイルを保存した後、ブラウザで http://localhost:8000/ にアクセスしてみてください。コントローラから渡された名前が表示され、条件分岐やループが実行されているのが確認できるはずです。

レイアウトの継承

多くのWebページでは、ヘッダー、フッター、サイドバーなど共通のレイアウト部分があります。Bladeでは、レイアウトの継承機能を使って、これらの共通部分を一つの親レイアウトファイルにまとめ、各ページでそのレイアウトを再利用できます。

例：resources/views/layouts/app.blade.php (親レイアウト)

<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <!-- @yieldディレクティブ: 子ビューで定義されたセクションの内容をここに挿入します -->
    <!-- 第2引数はデフォルト値を指定できます -->
    <title>@yield('title', 'マイアプリケーション')</title>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css">
</head>
<body>
    <nav class="navbar is-light" role="navigation" aria-label="main navigation">
        <div class="navbar-brand">
            <a class="navbar-item" href="/">
                My App
            </a>
        </div>
    </nav>

    <section class="section">
        <div class="container">
            @yield('content') <!-- ここにメインコンテンツが入ります -->
        </div>
    </section>

    <footer class="footer">
        <div class="content has-text-centered">
            <p>
                © 2025 My App. All rights reserved.
            </p>
        </div>
    </footer>
</body>
</html>

例：resources/views/child.blade.php (子ビュー)

@extends('layouts.app') <!-- 親レイアウト 'layouts/app.blade.php' を継承 -->

@section('title', '子ページのタイトル') <!-- 親レイアウトの 'title' セクションを上書き -->

@section('content') <!-- 親レイアウトの 'content' セクションの内容を定義 -->
    <h1 class="title">ここは子ページです</h1>
    <p>親レイアウトを継承しています。ヘッダーとフッターは共通です。</p>

    <!-- ここに子ページ固有のコンテンツを追加できます -->
    <div class="box">
        子ページの内容が入ります。
    </div>
@endsection <!-- セクションの終わり -->

このようにレイアウトを継承することで、コードの重複を減らし、メンテナンス性を向上させることができます。

今回は、PHPフレームワークLaravelの導入方法と、基本的な操作について学びました。

• Composer を使ってLaravelプロジェクトを作成する方法
• Artisanコマンド (serve, make:controller) の基本的な使い方
• ルーティング (routes/web.php) でURLと処理を結びつける方法
• コントローラ で処理をまとめる方法
• ビューとBladeテンプレートエンジン ({{ }}, @if, @foreach, @extends, @yield, @section) を使って画面を生成する方法

これらの知識は、Laravelを使ったWebアプリケーション開発の第一歩です。実際に手を動かして、コードを書き換えてみることで、より理解が深まるはずです。

次のステップでは、Laravelの重要な設計思想であるMVCアーキテクチャについて、さらに詳しく掘り下げていきます。モデル(Model)の役割やデータベースとの連携方法などを学び、より本格的なWebアプリケーション開発への扉を開きましょう！🚪