前記

在開始接觸 homestead 之前一直想著這貨有什麼卵用，本地安裝個 XAMPP 直接開始碼。後來為了保護系統的清潔性（-_-|||），避免開發環境汙染到物理環境：

• 所以開始考慮到虛擬機器，接著在 VMware 上搭了個 Linux，用著一段時間：這尼瑪每次都要開個 GUI 出來啟動虛擬機器好麻煩；
• 於是開始考慮 Vagrant，Vagrant 是基於 VBox、VMware 等用於快速建立生產環境的工具，基於命令列的管理方式。此時並沒有想著直接用 homestead 而是自己連滾帶爬建一個 box （Vagrant 中的 box 相當於一個完整封裝的虛擬機器，homestead 就是一個 box），簡單地搭建了一個開發環境，但是感覺不夠全面，於是棄坑，但是至少了解了 Vagrant 的一些工作機制；
• 最後回憶起有 homestead 這東西，Rock!

基礎

Vagrant 基本原理就是通過配置檔案，在後臺啟動一個預配置好的虛擬機器（生產環境），通過埠對映，我們可以連線物理機並自動轉發到虛擬機器上進行通訊。

環境準備

這裡的版本號僅供參考，筆者使用的系統為 Win10。

預配置

Vagrant 的環境變數 VAGRANT_HOME 用於指定當前下載 box 的存放位置，所以該資料夾會佔用較大的空間，你可以將其指定到對應的路徑。

安裝 homestead

安裝完 Vagrant 後其會自動新增到環境變數，使用 vagrant 命令新增 laravel/homestead 環境：

vagrant box add laravel/homestead

接著會顯示下載源路徑和進度資訊，由於貴國牆高，建議複製下載源路徑扔到某下載工具下載，之後切換到 box 檔案的當前目錄，使用如下方式新增本地 box：

vagrant box add laravel/homestead 這裡_替換為_box_檔名稱

配置 homestead

Laravel 官方為我們提供了 Vagrantfile 等開發環境初始化配置檔案，省得手動配置，首先使用 git 把這些配置檔案拉下來：

git clone https://github.com/laravel/homestead.git homestead
 

然後切換到該目錄，執行初始化命令（注意這裡要使用 Cygwin）：

./init.sh

看看這個檔案幹了什麼：

其實就是複製一些配置模板檔案到 ~/.homestead 檔案下，接著進入 ~/.homestead，修改 homestead 的配置檔案：

其實這配置檔案很容易理解，挑幾個重要的講，其餘預設即可：

• [ip] 物理機的 IP 地址，用於本地埠繫結

• [authorize] 你的 SSH 連線公鑰（如何生成 SSH 金鑰請 參考這裡）

• [keys] SSH 私鑰

• [folders] 把你的本地檔案對映到虛擬機器（例如上圖將 ~/Sources/Web 對映到虛擬機器的 /home/vagrant/sources），這樣可以物理機和虛擬機器同步訪問檔案。

• [sites] Nginx 配置中的網站根目錄， map 為你的域名（如果自定義了域名，要新增到 hosts 檔案），to 為網站根目錄

• [databases] 建立一個名為 homestead 的 MySQL 資料庫

注意：Vagrant 啟動時會替換 box 預設的 SSH 私鑰，而 homestead 的配置檔案也會將我們配置的 SSH 金鑰進行替換。

預設 Vagrant 替換的 SSH 私鑰會導致連線失敗（至少我是這樣），所以我們直接讓 homestead 替我們工作即可，需要達成該目的你需要修改 homestead 配置目錄下名為 Vagrantfile 的檔案，新增一句

config.ssh.insert_key = false

啟動 homestead

如此簡單便配置完了，接下來在 homestead 目錄下啟動 homestead：

vagrant up

啟動完成後，埠會被對映到本地，通過訪問物理機的 8000 埠可以重定向到虛擬機器的 80 埠，2222 重定向到虛擬機器的 22 埠。

然後你可以隨時關閉虛擬機器：

vagrant halt

或者把環境廢了（放心你重新 up 會自動生成一個新環境，而且對映的檔案在本地，如果沒有在虛擬機器上儲存附加資訊，不會造成損失）

vagrant destory

注意：如果你是 win10，並且用著相同版本號的程式，應該會遇到 VBox 網路介面卡而導致 homestead 無法啟動的問題，開啟 homestead/scripts/homestead.rb 檔案，並將對應語句註釋即可：

其實每次都要到 homestead 目錄去進行啟動有點不爽，筆者偷懶寫了一個批處理，將批處理儲存為 homestead.bat ，並把該批處理目錄新增到 PATH 變數即可隨處執行：

@echo off
set CWD=%cd%
rem 下面替換為你的 homestead 路徑
set HOMESTEAD_HOME=C:\homestead

if exist %HOMESTEAD_HOME% (
    rem Redirect to the drive which is specified
    %HOMESTEAD_HOME:~0,2%
    chdir %HOMESTEAD_HOME%

    if "%1"=="up" ( goto up )
    if "%1"=="halt" ( goto halt )
    if "%1"=="status" ( goto status )
) else (
    echo The directory %HOMESTEAD_HOME% dosen't exist.
)
goto nothing

:up
vagrant up
goto nothing

:halt
vagrant halt
goto nothing

:status
vagrant status

:nothing
%CWD:~0,2%
chdir %CWD%

例如，啟動 homestead：

homestead up

關機：

homestead halt

檢視狀態

homestead status

題外話：使用 SSH 連線到 homestead

可以使用 Putty 或者 Xshell 連線到物理機的 2222 埠對 homestead 進行操作，使用者名稱為 vagrant：