Laravel Breezeは、シンプルで美しいスタートアップキットを提供することで、Laravelの初心者にとって理想的な始め方となっています。このガイドでは、Laravel Breezeのインストールと初期設定のプロセスを、初心者にも分かりやすく解説します。Laravelの環境を整えるために必要なツールや、Breezeを使うことのメリットも併せて紹介しますので、ぜひ参考にしてください。
Laravel Breezeとは？
Laravel Breezeは、Laravelの公式提供する認証スタートキットで、シンプルで軽量な構造を持っています。すぐに使えるログイン・登録機能、パスワードリセットなど、開発の初期段階で一般的に必要となる認証関連機能を迅速に追加できます。Breezeを導入することで、基本的なユーザー認証が直ちに利用可能になり、時間と労力の節約が可能です。
前提条件
Laravel Breezeをインストールする前に、以下の前提条件を満たしていることを確認しましょう。
-
PHPのインストール：PHP 8.1以上が推奨されますが、Laravelの公式サイトでサポートされているバージョンを確認し、インストールしてください。
-
Composerのインストール：PHPの依存管理ツールであるComposerも必要になります。「composer –version」コマンドを使って、正しくインストールされていることを確認できます。
-
Node.jsとnpm：Laravel Mixを動かすために必要ですので、最新の安定バージョンをインストールしましょう。
-
データベース環境：MySQL、PostgreSQLなど、任意のデータベースを利用できます。安定して動作するものを選びましょう。
Laravelプロジェクトの準備
まずはLaravelの新規プロジェクトを作成します。ターミナルを開き、プロジェクトを設置したいディレクトリに移動してから、下記のコマンドを実行します。
composer create-project laravel/laravel example-app
上記のexample-appは皆さんが設定したいプロジェクト名に置き換えてください。これで基本的なLaravelの環境がセットアップされます。
Laravel Breezeのインストール
次に、Laravel Breezeのインストールに進みます。プロジェクトのルートディレクトリに移動し、次のコマンドを実行してBreezeをインストールします。
composer require laravel/breeze --dev
インストールが完了したら、次にBreezeのインストールコマンドを実行します。
php artisan breeze:install
これにより、必要なビューやルートが自動で追加され、基本的な構造が構築されます。
フロントエンド資産の構築
BreezeにはTailwind CSSとAlpine.jsが使用されています。これらを含めた開発環境をセットアップするために、追加のコマンドを実行します。
npm install
npm run dev
このコマンドでTailwind CSSを含んだBreezeのスタイルがビルドされます。npm run devは開発中にWebpackが変更を監視し、即座に更新される状態を維持します。
データベース設定
Laravelのアプリケーションがデータベースと接続するための設定を行います。プロジェクトの.envファイルを開き、データベース接続の設定項目を編集してください。
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password
ここでyour_database_nameなどの部分を実際の接続情報に置き換えます。設定が完了したら、データベーステーブルを生成するためにマイグレーションを実行します。
php artisan migrate
アプリケーションの起動
すべての設定が完了したら、ローカルサーバーを起動して動作を確認します。以下のコマンドを使用して、アプリケーションを起動します。
php artisan serve
ブラウザを開き、http://localhost:8000にアクセスすることで、Breezeを利用したプロジェクトのログイン画面を見ることができます。
まとめ
Laravel Breezeは、シンプルで手早く認証機能を追加できるため、プロジェクトの立ち上げ時に大変便利です。このガイドでは、Breezeの基本的なインストール手順から初期設定までを解説しました。プロジェクトをスムーズに開始するための参考となるはずです。まずはBreezeを用いた認証から始めてみましょう。これを機にLaravelのさらなる機能にも挑戦してみることをお勧めします。
コメント