はじめに
LaravelはPHPフレームワークの中でも人気が高く、フロントエンドとの連携が簡単に行えます。本記事では、Laravel 11にBreezeを導入し、ReactとTypeScriptを使ったモダンな開発環境をローカルで構築する手順を紹介します。
必要なツールと環境
事前に以下のツールをインストールしておきましょう。
- PHP (バージョン8.1以上)
- Composer
- Node.js (LTS推奨)
- npm または Yarn
- データベース (例: MySQL)
また、Laravelの開発環境としてLaravel Sailを利用することもおすすめです。
環境構築手順
Laravel 11 プロジェクトの作成
まず、Composerを使って新しいLaravel 11プロジェクトを作成します。
composer create-project laravel/laravel laravel-react-ts
cd laravel-react-ts
Breezeのインストールと設定
Laravel Breezeは、認証を簡単にセットアップできる軽量なスターターパックです。
composer require laravel/breeze --dev
インストールが完了したら、BreezeをReactとTypeScriptオプション付きでセットアップします。
php artisan breeze:install react --typescript
npmパッケージのインストールとビルド
以下のコマンドを実行して、必要なnpmパッケージをインストールします。
npm install
コマンドを実行することで、フロントエンドの開発サーバーが起動します。
npm run dev
Laravel Debugbar追加
composer require --dev barryvdh/laravel-debugbar
設定ファイルの公開
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"
データベースの設定
.env
ファイルを編集して、データベースの接続情報を設定します。
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=laravel_db DB_USERNAME=root
DB_PASSWORD=your_password
設定を反映するために、以下のコマンドを実行してデータベースをマイグレーションします。
php artisan migrate
ローカル開発サーバーの起動
以下のコマンドでLaravelの開発サーバーを起動します。
php artisan serve
ブラウザでhttp://localhost:8000
を開き、Laravelのトップページが表示されることを確認します。
Breeze + React + TypeScriptの動作確認
Breezeの初期セットアップにより、ログイン・登録画面がReactとTypeScriptで構築されています。これらの画面が正しく動作しているか確認しましょう。
よくある問題と解決策
npmパッケージのインストール時にエラーが発生する
依存関係の不整合が原因の場合があります。以下のコマンドで解決できる場合があります。
npm install --legacy-peer-deps
おわりに
この記事では、Laravel 11、Breeze、React、TypeScriptを使ったモダンな開発環境を構築する手順を紹介しました。この環境を基に、さらなるカスタマイズやプロジェクトの開発を楽しんでください!