Laravel開發環境搭建：Homestead虛擬機配置與安裝詳細教程

gitbox 2025-06-13

Laravel 是一個流行的PHP 框架，廣泛用於構建高效、可擴展和安全的Web 應用程序。在開發Laravel 項目時，一個常見的需求是搭建一個可靠且高效的開發環境。 Homestead 是Laravel 官方提供的虛擬機，預裝了開發所需的所有軟件和配置，可以大大簡化開發環境的搭建過程。本文將詳細介紹如何通過Homestead 搭建Laravel 開發環境。

1. 安裝VirtualBox 和Vagrant

在搭建Homestead 環境之前，我們需要先安裝VirtualBox 和Vagrant。 VirtualBox 是一款功能強大的虛擬機軟件，而Vagrant 則是用於創建和管理虛擬機的工具。安裝完這兩個工具後，我們即可開始安裝Homestead。

2. 安裝Homestead

安裝Homestead 非常簡單，只需要在命令行中執行以下命令：

 
vagrant box add laravel/homestead

執行該命令後，Vagrant 會下載Homestead 虛擬機鏡像並將其添加到Vagrant 環境中。

3. 配置Homestead

成功安裝Homestead 後，我們需要對其進行配置。進入Homestead 安裝目錄（默認為~/.homestead），找到Homestead.yaml 配置文件。這個文件用於定義開發環境的配置。

打開Homestead.yaml 文件，你會看到一些默認配置，如下所示：

 
ip: 192.168.10.10
memory: 2048
cpus: 1
provider: virtualbox
authorize: ~/.ssh/id_rsa.pub
keys:
    - ~/.ssh/id_rsa
folders:
    - map: ~/code
      to: /home/vagrant/code
sites:
    - map: homestead.test
      to: /home/vagrant/code/public

這些配置項可以根據實際需求進行調整。例如，ip 字段定義了Homestead 虛擬機的IP 地址，memory 字段指定了虛擬機的內存大小，cpus 字段則設置了虛擬機的CPU 核心數。 authorize 和keys 字段定義了SSH 密鑰，用於身份驗證。

此外，你還可以根據需要配置文件夾映射和網站映射。 folders 字段定義了本地文件夾與虛擬機內文件夾之間的映射關係，sites 字段則定義了本地域名與虛擬機內網站位置的映射。

4. 啟動Homestead 虛擬機

配置完成後，我們可以通過命令行啟動Homestead 虛擬機。在Homestead 安裝目錄下，執行以下命令：

 
vagrant up

執行該命令後，Homestead 虛擬機將啟動，並根據Homestead.yaml 中的配置自動安裝所需的軟件和環境。

5. 訪問Laravel 應用程序

當Homestead 虛擬機啟動完成後，您可以通過瀏覽器訪問Laravel 應用程序。在Homestead.yaml 中配置的站點映射中，會有一個默認站點homestead.test。只需在瀏覽器中輸入該域名，即可訪問Laravel 應用程序。

總結

Homestead 是一個便捷且可靠的Laravel 開發環境，通過簡單的配置和命令，就可以快速搭建一個適合Laravel 開發的虛擬機。通過本文的詳細教程，您可以輕鬆完成Homestead 的安裝與配置，提升開發效率並專注於Laravel 應用程序的開發。