プログラミング

Laravel Homestead 設定ガイド

最終更新： 17/04/2025
1分未満

Laravelアプリケーションの開発環境をセットアップするために、Homesteadは非常に便利なツールです。Laravel Homesteadは、Laravel開発のために最適化されたVagrantボックスで、仮想マシン環境上に構築されます。このボックスを使用すると、開発者はローカル環境で問題なくLaravelを動作させることができます。以下に、Homesteadのインストールとセットアップ手順を完全かつ包括的に説明します。

1. 必要なソフトウェアのインストール

まず、Homesteadを使用するにはいくつかのソフトウェアをインストールする必要があります。

関連記事

1.1 VirtualBox

VirtualBoxは、仮想マシンを作成して実行するためのソフトウェアです。まず、公式サイトからVirtualBoxをインストールしましょう。

  1. VirtualBoxの公式サイトにアクセスします：https://www.virtualbox.org/

  2. オペレーティングシステムに合ったバージョンをダウンロードし、インストールします。

1.2 Vagrant

Vagrantは、仮想環境の構築を管理するためのツールです。HomesteadはVagrantを使用して仮想マシンを管理します。

  1. Vagrantの公式サイトにアクセスします：https://www.vagrantup.com/

  2. 自分のオペレーティングシステムに合ったVagrantをダウンロードしてインストールします。

1.3 Git

Gitは、ソースコードを管理するためのツールです。LaravelのプロジェクトにGitを使用するために、Gitをインストールする必要があります。

  1. Gitの公式サイトにアクセスします：https://git-scm.com/

  2. 自分のオペレーティングシステムに合ったGitをダウンロードし、インストールします。

2. Homesteadのインストール

2.1 Homesteadインストーラーのインストール

次に、Homesteadのインストールを行います。これにはComposerが必要です。まず、Composerをインストールしていない場合は、公式サイトからインストールしてください。

  1. ターミナルを開き、以下のコマンドを実行してHomesteadをインストールします。

    bash
    composer require laravel/homestead --dev

2.2 Homesteadの設定

Homesteadをインストールした後、次に仮想マシンの設定を行います。

  1. Homesteadを初期化するには、以下のコマンドを実行します。

    bash
    vendor/bin/homestead init

  2. このコマンドにより、Homestead.yamlという設定ファイルが作成されます。このファイルには、仮想マシンの設定情報が含まれています。必要に応じて、このファイルを編集して、プロジェクトに合わせた設定を行います。

2.3 仮想マシンの起動

設定が完了したら、Homesteadの仮想マシンを起動します。以下のコマンドを実行して、仮想マシンを立ち上げます。

bash
vagrant up

このコマンドにより、VagrantはHomestead仮想マシンを起動し、設定に基づいて必要なサービスを開始します。

3. Homestead.yamlファイルの設定

Homestead.yamlファイルは、Homesteadの動作を制御するための設定ファイルです。例えば、プロジェクトのルートディレクトリや、仮想マシン内でアクセスできる共有フォルダ、データベースの設定などを行います。

3.1 マウントするフォルダの設定

プロジェクトディレクトリを仮想マシン内にマウントする設定を行います。Homestead.yamlファイルのfoldersセクションで、ホスト側のフォルダとゲスト側のフォルダを指定します。

yaml
folders:
    - map: ~/Code
      to: /home/vagrant/Code

上記の設定では、ホストマシンの~/Codeディレクトリがゲストマシンの/home/vagrant/Codeにマウントされます。このディレクトリ内にLaravelプロジェクトを配置します。

3.2 サイトの設定

次に、Laravelプロジェクトを動かすために、仮想ホストを設定します。Homestead.yamlのsitesセクションに、プロジェクトの設定を追加します。

yaml
sites:
    - map: homestead.test
      to: /home/vagrant/Code/my-laravel-app/public

この設定により、homestead.testというドメインが仮想マシンに割り当てられ、my-laravel-appディレクトリ内のpublicフォルダがWebルートとして設定されます。

3.3 データベースの設定

HomesteadはMySQLやPostgreSQLなどのデータベースも提供します。Homestead.yamlファイルのdatabasesセクションでデータベースを設定できます。

yaml
databases:
    - homestead
    - my_laravel_database

これにより、仮想マシン内でhomesteadとmy_laravel_databaseという2つのデータベースが作成されます。

4. Homesteadの使用

4.1 HomesteadにSSH接続

仮想マシンにSSHで接続するためには、以下のコマンドを実行します。

bash
vagrant ssh

これにより、仮想マシン内にSSH接続され、コマンドラインで操作を行うことができます。

4.2 Laravelアプリケーションのセットアップ

仮想マシン内で、Laravelプロジェクトを作成したいディレクトリに移動し、以下のコマンドで新しいLaravelプロジェクトを作成します。

bash
composer create-project --prefer-dist laravel/laravel my-laravel-app

作成したLaravelプロジェクトに必要なパッケージをインストールしたら、.envファイルを編集して、データベースの設定を行います。

bash
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=my_laravel_database
DB_USERNAME=root
DB_PASSWORD=

5. ブラウザでアクセス

設定が完了したら、homestead.testにアクセスすることで、ブラウザからLaravelアプリケーションにアクセスできるようになります。もし、homestead.testが認識されない場合は、hostsファイルに以下のエントリを追加してください。

192.168.10.10 homestead.test

これで、homestead.testにアクセスすることで、Homestead仮想マシン上で動作するLaravelアプリケーションを見ることができます。

6. まとめ

HomesteadはLaravelの開発環境を迅速に構築できる強力なツールです。Vagrantを利用して仮想マシン上にセットアップし、プロジェクトの開発を効率よく行うことができます。上記の手順を守ることで、Homesteadを使ってLaravelアプリケーションを簡単にセットアップし、開発環境を整えることができます。

最終更新： 17/04/2025
1分未満
Back to top button