【初心者向け】Laravelのインストール完全ガイド｜Mac・Windowsで環境構築する方法

こんにちは！今回は、PHPの人気フレームワークLaravel（ララベル）を実際にインストールして、ブラウザにLaravelの画面を表示するところまでを解説します。

Laravelをこれから勉強しようと思ったとき、最初につまずきやすいのが「そもそも、どうやって環境を作ればいいの？」という部分です。

PHPだけインストールすればいいのか、Composerって何なのか、データベースは必要なのか……。最初は少しややこしく感じますよね。

僕も開発環境を作るときは、アプリケーションを書く前の「環境構築」という最初の壁を越えるところからスタートします。

そこで今回は、できるだけ迷わないように、Laravelのインストールから動作確認までを順番に整理してみました。

旅行に例えるなら、Laravelの開発は「目的地」へ向かう旅のようなものです。PHPやComposerは移動手段、Laravelは目的地。そして最初に環境を整えておけば、その後の開発がグッと楽になります。

Laravelをインストールする前に準備するもの

まずはLaravelを動かすために必要なソフトウェアを確認しておきましょう。

• PHP：Laravelを動かすために必要
• Composer：PHPのパッケージ管理ツール
• Node.js / npm：フロントエンド関連の処理で使用
• データベース：MySQLなど
• Google Chrome：動作確認用ブラウザ
• Visual Studio Code：ソースコードを編集するためのエディター

また、ローカル環境を簡単に構築するために、MacではMAMP、WindowsではXAMPPを利用する方法があります。

もちろんLaravelはDockerなどの仮想環境でも動かせます。ただ、最初からDockerまで覚えようとすると、Laravelを学ぶ前に環境構築で疲れてしまうことがあります。

今回は、まずLaravelそのものを触ってみたい人向けに、比較的シンプルな構成で進めます。

Laravelのインストール前にバージョンを確認しよう

環境構築で意外と重要なのが「今、自分のPCに何がインストールされているのか」を確認することです。

特にLaravelは、PHPやComposerなどのバージョンとの組み合わせによって、インストール時に問題が発生することがあります。

Macなら「ターミナル」、Windowsなら「コマンドプロンプト」や「PowerShell」を開いて確認してみましょう。

PHPのバージョンを確認する

php -v

PHPのバージョン情報が表示されればOKです。

Composerのバージョンを確認する

composer --version

Composerのバージョンが表示されれば、Composerも利用できる状態です。

Node.jsとnpmのバージョンを確認する

node -v
npm -v

Node.jsとnpmについてもバージョンが表示されることを確認しておきましょう。

ここまで確認できれば、Laravelをインストールするための準備はかなり整っています。

MacでLaravelをインストールする場所を準備する

ここからはMacでLaravelをインストールする場合を見ていきます。

今回はMAMPを利用する前提で、MAMPのドキュメントルート配下にLaravelのプロジェクトを作成します。

Finderから「アプリケーション」→「MAMP」と進み、その中にあるドキュメントルートを確認します。

その中に開発用のフォルダを作り、さらにLaravel用のフォルダを作っておくと、複数のWebアプリケーションを管理しやすくなります。

例えば、次のような構成です。

htdocs
└── dev
    └── laravel

この「laravel」フォルダの中にLaravelプロジェクトを作成していきます。

Laravelのインストール方法｜Composerを使ってプロジェクトを作成

Laravelのインストールでは、Composerを利用する方法が一般的です。

Composerは、PHPで利用するライブラリやフレームワークなどを管理してくれるツールです。

Laravel本体だけでなく、Laravelが必要とする関連パッケージもまとめて取得してくれるので、手作業でファイルを一つずつ用意する必要がありません。

Composer create-projectでLaravelをインストールする

Laravelプロジェクトを作成する基本的なコマンドは次のようになります。

composer create-project laravel/laravel プロジェクト名

今回の例では「umarche」というプロジェクト名を使用します。

また、今回はLaravel 8系を使用するため、バージョンも指定します。

composer create-project laravel/laravel:^8 umarche --prefer-dist

コマンドを実行すると、ComposerがLaravel本体と必要なパッケージをダウンロードし、プロジェクトを自動的に作成してくれます。

Laravelのバージョンを指定する理由

Laravelをインストールするときに、初心者の方が特に注意したいのがバージョン指定です。

何も指定せずにインストールすると、実行した時点での新しいバージョンがインストールされる可能性があります。

例えば、教材や書籍がLaravel 8を前提としているのに、最新バージョンのLaravelがインストールされてしまったらどうでしょうか。

「教材に書いてあるコードを入力したのに動かない……」という状況になる可能性があります。

これは、コードそのものが間違っているとは限りません。Laravelのバージョンによって仕様や構造が変わっていることが原因の場合があります。

そのため、学習環境を教材に合わせる場合は、Laravelのバージョンを意識することが大切です。

--prefer-distオプションとは？

今回のコマンドには、最後に--prefer-distというオプションを付けています。

composer create-project laravel/laravel:^8 umarche --prefer-dist

このオプションを指定すると、Composerが可能な場合に配布用のアーカイブを優先して取得します。

環境やネットワークによって違いはありますが、インストール時のダウンロードを効率化できる場合があります。

コマンドを入力したらEnterキーを押して、Laravelのインストールが完了するまで待ちましょう。

Laravelのインストールが成功したか確認する

Laravelのインストールが完了すると、ターミナルにさまざまなメッセージが表示されます。

最後の方に、次のようなメッセージが表示されれば、Laravelのインストールに成功しています。

Application key set successfully.

ここまで表示されたら、ひとまず大きな山場はクリアです。

新しくLaravelプロジェクトのフォルダも作成されているはずなので、次は実際にLaravelを起動してみましょう。

Laravelの簡易サーバーを起動する

インストールしたLaravelをブラウザで表示するには、まずLaravelのプロジェクトディレクトリへ移動します。

cd umarche

そして、Laravelの開発用サーバーを起動します。

php artisan serve

コマンドを実行すると、ローカル環境でLaravelのサーバーが起動します。

ターミナルに表示されたURLをコピーして、Google Chromeなどのブラウザで開いてみましょう。

http://127.0.0.1:8000

Laravelのウェルカム画面が表示されたら、インストールは成功です！

Laravelの画面が表示されたときの達成感

ここはLaravel初心者にとって、かなり嬉しい瞬間です。

ターミナルでコマンドを入力しているだけだと、「本当にLaravelが動いているのかな？」と少し不安になります。

ところがブラウザを開いてLaravelの画面が表示された瞬間、「ちゃんと動いた！」と実感できます。

環境構築は地味に見えますが、この瞬間を経験すると、その後の学習が一気に楽しくなります。

WindowsでLaravelをインストールする場合の注意点

ここまでMacを中心に説明してきましたが、WindowsでもComposerを利用してLaravelをインストールできます。

ただし、今回の環境ではMacとWindowsでLaravelのバージョン指定方法に注意が必要です。

MacでLaravel 8系をインストールするコマンド

composer create-project laravel/laravel:^8 umarche --prefer-dist

WindowsでLaravel 8系をインストールするコマンド

composer create-project "laravel/laravel=8.*" umarche --prefer-dist

OSによってコマンドの書き方が異なるため、教材や環境に合わせて使い分けるようにしてください。

composer create-project laravel/laravel:^8 umarche --prefer-dist

composer create-project "laravel/laravel=8.*" umarche --prefer-dist

MacとWindowsのLaravelインストールコマンドまとめ

OSによって指定方法が違うため、コマンドをそのままコピーするときは注意しましょう。

Laravelのインストールでつまずいたときのチェックポイント

Laravelのインストールでエラーが発生した場合は、いきなりLaravelだけを疑うのではなく、周辺の環境から確認すると原因を見つけやすくなります。

PHPが認識されているか確認する

php -v

PHPのバージョンが表示されなければ、PHPのインストールやPATHの設定を確認しましょう。

Composerが使えるか確認する

composer --version

Composerが認識されない場合は、Composerのインストール状態やPATHを確認します。

Node.jsとnpmを確認する

node -v
npm -v

フロントエンド関連の処理を行う際にはNode.jsやnpmが必要になることがあります。

Laravelのバージョンを確認する

学習教材と自分の環境でLaravelのバージョンが違っていないかも確認しましょう。

「書いてある通りにやっているのにエラーになる」という場合、バージョン違いが原因になっているケースは珍しくありません。

Laravelの環境構築で覚えておきたいこと

今回の作業を通して、Laravelをインストールするだけでも、PHP、Composer、Node.js、データベース、Webサーバーなど、いくつもの要素が関係していることが分かります。

最初は少し複雑に見えるかもしれません。

でも、すべてを一度に理解する必要はありません。

まずは「Laravelを動かすためには、こういう部品が必要なんだ」と全体像をつかむだけでも十分です。

• PHP → Laravelを動かす土台
• Composer → PHPパッケージを管理するツール
• Node.js / npm → フロントエンド側の開発で利用
• MySQLなどのデータベース → データを保存する場所
• MAMP / XAMPP → ローカル開発環境を構築するための選択肢
• Visual Studio Code → Laravelのコードを書くエディター
• Google Chrome → Webアプリを確認するブラウザ

まとめ｜Laravelのインストールは最初の一歩

今回は、Laravelのインストール方法と初期設定について紹介しました。

最初にPHPやComposerなどのバージョンを確認し、Composerを使ってLaravelプロジェクトを作成します。

その後、php artisan serveで簡易サーバーを起動し、ブラウザからLaravelの画面が表示できれば環境構築は完了です。

今回の手順をまとめると、次の流れになります。

1. PHPをインストールしてバージョンを確認する
2. Composerをインストールしてバージョンを確認する
3. Node.jsとnpmを確認する
4. Laravelのプロジェクトを作成する場所を準備する
5. ComposerでLaravelをインストールする
6. Laravelのインストール完了を確認する
7. php artisan serveで開発用サーバーを起動する
8. ブラウザでLaravelの画面を確認する

環境構築が終われば、いよいよLaravelを使ったWebアプリケーション開発のスタートです。

最初はターミナルのコマンドやバージョン指定など、見慣れないものが多く感じると思います。

でも、一度自分のPCでLaravelを起動できれば、その後の理解はかなり進めやすくなります。

旅行も同じで、最初に空港までたどり着いてしまえば、あとは目的地へ向かって進むだけです。

「Laravelの画面が表示された！」

この小さな成功をスタート地点にして、ルーティング、Blade、データベース、CRUD、認証機能など、少しずつLaravelの世界を旅していきましょう。

まずは自分の環境でLaravelを起動できるところまで、ぜひ試してみてください！