Laravel12にBreezeをインストールする方法:php.newとBunで環境構築

Laravelバージョンアップ・ニュース

Laravelの新しい環境構築方法【php.new】を使って、Laravel12でBreezeを使ってBreezeプロジェクトを作成する方法をご紹介します。

さらに今回は、Node.jsの代わりに、Bunという新しいツールを使います。

新しい環境構築方法にご興味あれば、見てみてくださいね。

結論からいうと、Laravelの環境構築がものすごく手軽になると感じました。カップラーメンと同様3分どころか、1分とかからないかもしれません^^

動画編はこちらです。

動画ではスターターキットでLivewireを選んでいますが、

本記事では、Breezeを使った方法をご紹介します。

↓↓↓

Laravel12のプロジェクトを新しい開発環境構築方法で作る:php.newとBun使用

インストール方法のあとに、メリット・デメリットをまとめたので、気になる方は最後まで読んでくださいね。

Laravelの公式サイトはこちら。

php.newとBunを使ってLaravel12の環境構築をする方法

まずは環境構築を行い、そのあと、Laravel Breezeをインストールしていきます。

Windows環境を使っていますが、Macの場合に動作が異なることがあります。その場合は、青色の枠内で補足説明をいれています。

php.newのインストール

公式サイトに書かれているとおり、Windowsの場合は、管理者としてWindows PowerShellを起動し、下記コマンドを実行します。

無事インストールが終了すると、次のような画面となります。

★Macの場合★ ターミナルで下記コマンドを実行すると、インストールが進みます。
/bin/bash -c “$(curl -fsSL https://php.new/install/mac)”

公式サイトはこちら。

コマンドは変わっている可能性もあるので、公式サイトも見てくださいね。

Bunのインストール

環境に合わせて、コマンドを使ってインストールします。Windowsの場合は、引き続きPowerShell上で下記を実行します。

★Macの場合★ ターミナルで下記コマンドを実行します。インストールが進みます。
/bin/bash -c “$(curl -fsSL https://php.new/install/mac)”

Macの場合は、インストール後、パスを設定する必要があります。
zshの場合は、ターミナルを開き、以下のコマンドを実行して.zshrcファイルを編集します。

ファイルの最後に以下の行を追加します。userの部分は、ユーザー名に変えてください。

変更を保存した後、エディタを終了します。以下のコマンドを実行して、変更を反映させます。

Bunの公式サイトはこちら。Bunのアイコン、かわいいですね。

Laravelプロジェクトの作成

次にLaravelのプロジェクトを作成します。php.newをいれると、Laravelインストーラーが入ってきます。インストーラーを使用して、下記コマンドでプロジェクトを作成します。

sampleは、プロジェクト名です。お好みで変えてください。

プロジェクトを作成する前に、こちらもお好みでディレクトリを移動してくださいね。

わたしはDocumentsの中にlaravelディレクトリを作り、そこで上記コマンドを実行しました。移動するには「cd」コマンドを使います。コマンド入力に慣れていない方は、下記記事もご覧ください。

スターターキットの選択

プロジェクトを作成すると、スターターキット選択画面が表示されます。Youtube動画ではLivewireを選択していますが、Youtube動画ではLivewireを選択していますが、本記事では、Breezeを選択してすすめていきますので、ここでは、None(何も選ばない)を選択してください。

★Macの場合★ スターターキットを選択した後、テスト用のフレームワークを聞かれました。お好みで選択してください。

次にデータベースを聞かれます。今回はデフォルトのsqliteを選んでおきます。

★Macの場合★データベーステーブルについて聞かれた後、次のようにマイグレーションを実行するか選択できました。Yesと入力しておきます。

しばらく待ちます。最後のほうに下記のように質問がでてきます。

“Would you like to run npm install and npm run build?”

「yes」を選ぶと、必要なNode.jsのパッケージがインストールされます。今回はBunを使うので、ここは「no」を選択します。

ブラウザに表示

以上でLaravelプロジェクト作成できました。あまりにあっさりですが^^;

プロジェクトの中に移動します。

サーバーを立ち上げます。

ブラウザで、http://127.0.0.1:8000を開きます。

Laravelトップ画面が表示されます。

ちなみに、Windoswの場合は上記のようなホワイトモードですが、Macの場合はダークモードがデフォルトでした。

エラーが起こった場合(Windows)

わたしの場合は、上記コマンド実行後、エラーになりました。

調べてみると、php.iniに問題があるのではないかということでした。

php.inivariables_order 設定が "EGPCS" だと、システムの環境変数が先に読み込まれて Laravel の .env ファイルの設定が上書きされ、エラーが発生するようです。そこでこの部分を”GPCS”` に変更し、.envの内容が読み込まれるようにしました。

手順は次のとおりです。まずは下記コマンドでphp.iniファイルの場所を確認しました。

コマンド実行後の画面はこちら。

パスの場所にあるphp.iniファイルを開き、variables_order = “EGPCS”をvariables_order = “GPCS”と編集をしました。

再度 php artisan serveコマンドを実行します。

ブラウザでhttp://127.0.0.1:8000を開きます。Laravelトップ画面が表示されます。

Breezeのインストール

それでは引き続き、Breezeパッケージをいれていきます。これまでと同じ手順となります。

php artisan serveを起動したPowerShellはそのままにしておきます。

あらたにPowerShellをたちあげてプロジェクトに移動し、下記コマンドを実行します。

あるいはプロジェクトをVisual Studioで開き、ターミナルの中で下記を実行する形でもOKです。

続いて、下記を実行します。

質問が3個表示されます。次のように回答していきます。

■Which Breeze stack would you like to install?

ここでは、一番上の「blade」を選択します。

■Would you like dark mode support? (yes/no) [no]

お好みですが、ここではnoにします。

■Which testing framework do you prefer?

テスト用フレームワークです。こちらもお好みで選んでください。

しばらく待つと、インストールが終了します。

プロジェクトをブラウザに表示します。右上にLogin/Registerボタンがでてきます。

ただ、Registerボタンを押すと、「Vite manifest not found at:」エラーになります。これは、Bunが起動しておらず、Laravel Viteが実行できないためのエラーです。

Laravel Breezeインストールを行ったPowerShell上で、プロジェクト内で下記コマンドを実行し、Bunをインストールします。

次に、下記でBunを起動します。

再びブラウザを確認してください。

Register画面では次のように表示されます。

bun run devコマンドについて

bun run devコマンドの意味について、少しご説明しますね。

bun run dev コマンドを実行すると、プロジェクト内のCSSやJavaScriptといったソースコードが、自動的にブラウザで動作する形にビルドされます。

つまり、Laravel Breezeで利用されるフロントエンドのコード(Tailwind CSSでのスタイリングやJavaScriptの動作など)が、ブラウザでスムーズに動くように最適化されます。

なお以前はLaravel MixとNode.jsを使用して、この処理が行われていましたが、原理は同じです。

仕組みがイマイチ分からないと感じたら、Laravel Mixについてマンガで解説した記事があるので、こちらも見てみてくださいね。

この部分を分かりやすく伝えたいと思い、熱い想いで、ゆるく描いた漫画です♪

なお、bun run devを実行しなくても、常にスタイルをキープしたいときには下記コマンドを実行しましょう。

本番環境に移行する時などにも、このコマンドを実行します。

初期設定

タイムゾーンと言語の設定も行っておきます。

タイムゾーンの変更

config/app.phpの68行目あたりには、下記コードが入っています。

【config/app.php】

下記のようにします。

言語の変更

.envファイルの中に、言語設定が入っています。

【.env】

ここを次のようにしておきます。

config/app.phpの81行目あたりには、下記コードが入っています。

【config/app.php】

これは.env側で言語設定があれば、そちらが反映されます。なければconfig側の設定が有効になるという意味です。

php.newによる環境構築のメリット・デメリット

以上がphp.newによる環境構築の方法です。現段階で感じたメリットとデメリットについて、まとめていきます。

php.newによる環境構築のメリット

ラクで速い!

あ、一言で終わっちゃいましたが、これにつきます^^

最初のコマンド実行するだけなので1分とかかりません。

php.newによる環境構築のデメリット

デメリットというか、注意したほうが良い点を挙げてみました。次のとおりです。

データベースの問題

デフォルトではSQLiteが使えますが、MySQLなど別のDBを使いたいときは、別途インストールが必要です。

MySQLを使うなら、XAMPPやLaravel Sailを使うほうがよい気がします。本番環境でMySQLを使うのであればMySQLで開発したほうが整合性も取れますし。

ちなみに、デフォルトではブラウザでデータベースを確認することはできません。別途ライブラリのインストールが必要になります。

既に他の環境をしている場合の問題

すでにPCにphpがインストールされていたら、新たにphp.newをいれると、PATHが上書きされたりする可能性があるのでやめたほうが良いかもしれません。

Windowsの場合、php-newでインストールされるディレクトリは HOME/.config/herd-lite/bin/なので、phpのコマンドをphp8.4などとリネームすると良いかもしれません(ただ、実際にテストしていません)。

さいごに

php.newは、開発環境で手軽にLaravelをいれたいときには便利かと思います。環境構築って、一番初めに行うことですが難易度が高く、多くの方がつまずく部分でもあります。

そういった状況の中で、「まずは手軽にLaravelを使いたい」という場合には、php.newはとても良い方法だと思いました。

ただ、既に別の環境をご利用の場合は、特に変えなくても良いかと思います。

従来の方法でLaravelプロジェクトを作成したい場合は、下記をご覧ください。

▶XAMPP編

▶Laravel Sail編

なお、わたしのほうではLaravelの教科書という学習サイトを運営中です。学習を通じて、Laravelで会員制サイトを作れるようになっています。

【Laravelの教科書を通じて作成する画面例】

現在Laravel8~11までのバージョンがあります。近々、Laravel12バージョンも追加予定です。ご興味あれば、下記のご案内ページ見てみてくださいね。

基礎編は無料です。

詳細は、こちらのご案内ページご覧ください。

Laravelの教科書について詳しく知る

Laravelバージョンアップ・ニュース

【Laravelの教科書・プレゼント】

Junko
Laravelの使い方を覚えたい!と思ったら、ぜひ、役立ててほしいです。 基礎編は無料でプレゼント中です♪
ひつじプログラマ
会員制サイトをいちから作っていくよ。ボタンをクリックして詳細を見てね。
Laravelの教科書の詳細を見る

最新のLaravel11版テキストに加え、Laravel8版・Laravel9版・Laravel10版もご用意しています♪

【無料プレゼント】

「LaravelでWebアプリをいちから作れるようになりたい!」

そんなLaravel初心者のあなたへ【Laravelの教科書】基礎編プレゼント中! 会員制フォーラムサイトを学習しながら作れます。

詳細はこちらをクリック

最新のLaravel11版テキストに加え、Laravel8版・Laravel9版・Laravel10版もご用意しています♪

【AWS関連・Webアプリ開発・生成AIのAPI活用のご相談承ってます】
お気軽にお声がけください。
御社にとって、最善の方法をご一緒に考えてまいります。
Zoomミーティング実施中。サンプルアプリご利用可能です。

お問合せフォーム

Laravelの本を書きました。


ひつじが目印♪
クリックするとamazonページへ。

Laravelの使い方を分かりやすく解説した書籍を出版しました。書店やAmazon等のオンラインショップにて販売中です。
Laravel10対応。Laravel11サポートガイドもご用意しています。詳しくは下記ボタンをクリック♪

書籍の詳細を見てみる

Laravelの本を書きました。


ひつじが目印♪
クリックするとamazonページへ。

最新版Laravel11用のサポートガイドご用意しています。

Laravelの使い方を分かりやすく解説した書籍を出版しました。書店やAmazon等のオンラインショップにて販売中です。

書籍の詳細を見てみる
Twitter始めました。
40代からプログラミング!
タイトルとURLをコピーしました