Laravel Homestead

簡介
安裝與設定
常見用法
網路介面卡
升級 Homestead
舊版本

簡介

Laravel 致力於讓 PHP 開發體驗更愉快，也包含本地的開發環境。Vagrant 提供了一個簡單、優雅的方式來管理與供應虛擬機器。

Laravel Homestead 是一個官方預載的 Vagrant box，提供一個美好的開發環境，不需要在本機電腦安裝 PHP、HHVM、網頁伺服器或任何伺服器軟體。不用擔心搞亂你的系統！Vagrant box 可以搞定一切。如果有什麼地方搞爛掉了，還可以在幾分鐘內快速地砍掉並重建虛擬機器！

Homestead 可以在任何 Windows、Mac 或 Linux 系統上面執行，裡面包含了 Nginx 網頁伺服器、PHP 7.1、MySQL、Postgres、Redis、Memcached、Node，以及所有在使用 Laravel 開發各種精彩的應用程式時所需要的軟體。

{note} 如果是 Windows 的使用者，您可能需要啟用硬體虛擬化(VT-x)。這通常需要透過 BIOS 來啟用它。假如您使用的 Hyper-V 是在 UEFI 系統上，為了使用 VT-x 您可能需同時地禁用 Hyper-V。

內建軟體

Ubuntu 16.04
Git
PHP 7.1
Nginx
MySQL
MariaDB
Sqlite3
Postgres
Composer
Node (包含 Yarn, PM2, Bower, Grunt, and Gulp)
Redis
Memcached
Beanstalkd

安裝與設定

前置動作

在啟動 Homestead 環境之前，必需先安裝 VirtualBox 5.1，VMWare，或 Parallels 以及搭配 Vagrant。這些軟體在各個常用的平台都有提供易用的視覺化安裝程式。

若要使用 VMware provider，你需要同時購買 VMware Fusion / Workstation 及 VMware Vagrant plug-in。雖然他不是免費的，但 VMware 可以在共享資料夾上獲得較快的性能。

若要使用 Parallels provider，則必需安裝 Parallels Vagrant plug-in，它是免費的。

安裝 Homestead Vagrant Box

當 VirtualBox / VMware 以及 Vagrant 安裝完成後，可以在終端機執行下列指令將 laravel/homestead 這個 box 安裝進你的 Vagrant 程式中。下載 box 會花一點時間，時間長短將依據你的網路速度決定：

vagrant box add laravel/homestead

如果此指令執行失敗了，請確保安裝的 Vargrant 是最新版。

安裝 Homestead

可以簡單地透過複製(clone)儲存庫的方式來安裝 Homestead。建議可將儲存庫複製至你的「home」目錄中的 Homestead 資料夾，如此一來 Homestead box 將能提供主機服務給你所有的 Laravel 專案：

cd ~

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

複製完 Homestead 儲存庫，即可在 Homestead 目錄中執行 bash init.sh 指令來建立 Homestead.yaml 設定檔。 Homestead.yaml 檔案將會被放置在 ~/.homestead 隱藏目錄中：

// Mac / Linux...
bash init.sh

// Windows...
init.bat

設定 Homestead

設定提供者

在 ~/.homestead/Homestead.yaml 檔案中的 provider 是用來設定想要使用哪一個 Vagrant 提供者，像是：virtualbox、vmware_fusion、vmware_workstation 或 parallels。你可以根據喜好來決定提供者：

provider: virtualbox

設定共享目錄

可以在 Homestead.yaml 檔案的 folders 屬性裡列出所有想與 Homestead 環境共享的目錄。這些目錄中的檔案若有更動，它們將會同步更動在你的本機電腦與 Homestead 環境。可以將多個共享目錄都設定於此：

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

若要啟用 NFS，只需要在共享目錄的設定值中加入一個簡單的參數：

folders:
    - map: ~/Code
      to: /home/vagrant/Code
      type: "nfs"

也可以使用 Vagrant 的 Synced Folders 傳遞參數，將他們列在 options 的鍵下：

folders:
    - map: ~/Code
      to: /home/vagrant/Code
      type: "rsync"
      options:
          rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
          rsync__exclude: ["node_modules"]

設定 Nginx 網站

對 Nginx 不熟悉嗎？沒關係。sites 屬性幫助你可以輕易的指定「網域」對應至 homestead 環境中的目錄。在 Homestead.yaml 檔案中已包含一個網站設定範例。同樣的，你可以增加數個網站到 Homestead 環境中。Homestead 可以為每個你正在開發中的 Laravel 專案提供方便的虛擬化環境：

sites:
    - map: homestead.app
      to: /home/vagrant/Code/Laravel/public

在配置 Homestead box 之後，若有更改 sites 屬性，你應該重新執行配置指令 vagrant reload --provision 來更新虛擬機裡的 Nginx 設定。

Hosts 檔案

你必須為 Nginx 網站在你機器中的 hosts 檔案增加「網域」。hosts 檔案會將你對 Homestead 網站的請求重導至 Homestead 機器。在 Mac 或 Linux 上，該檔案通常會存放在 /etc/hosts。在 Windows 上，則存放於 C:\Windows\System32\drivers\etc\hosts。你增加至該檔案的內容看起來會像這樣：

192.168.10.10  homestead.app

務必確認 IP 位置與你的 ~/.homestead/Homestead.yaml 檔案中設定相同。一旦將網域設定在 hosts 檔案之後，你就可以透過網頁瀏覽器造訪網站！

http://homestead.app

啟動 Vagrant Box

當你編輯完 Homestead.yaml後，開啟終端機，進入 Homestead 目錄，並執行 vagrant up 指令。Vagrant 就會自將虛擬主機啟動並自動設定共享目錄和 Nginx 網站。

如果要移除虛擬機器，可以使用 vagrant destroy --force 指令。

根據專案各別安裝

有別於將 Homestead 安裝成全域環境且讓所有的專案共用同一個 Homestead box，你可以各別為每一個專案獨立配置一個 Homstead。如果你希望直接在專案裡傳遞 Vagrantfile，那麼替每個專案安裝 Homestead 即是你可以考慮的方式，這將會允許其他人可以簡單地執行 vagrant up 即能開始工作於此專案。

使用 Composer 將 Homestead 直接安裝至你的專案中：

composer require laravel/homestead --dev

一旦 Homestead 安裝完畢，你可以使用 make 指令產生 Vagrantfile 與 Homestead.yaml 存放於專案的根目錄。這個 make 指令將會自動配置 sites 及 folders 於 Homestead.yaml .

Mac / Linux:

php vendor/bin/homestead make

Windows:

vendor\\bin\\homestead make

接著，在終端機中執行 vagrant up 指令，並透過網頁瀏覽器造訪 http://homestead.app 。再次提醒，你仍然需要在 /etc/hosts 裡設定 homestead.app 或其他想要使用的網域。

安裝 MariaDB

如果您偏好 MariaDB 而不是 MySQL，可以在 Homestead.yaml 檔案中加入 mariadb 選項。這選項會移除 MySQL 並同時安裝 MariaDB。 MariaDB 是 MySQL 的一個直接替代品，所以在你的環境設定中的資料庫驅動程式仍然需使用 mysql：

box: laravel/homestead
ip: "192.168.20.20"
memory: 2048
cpus: 4
provider: virtualbox
mariadb: true

常見用法

全域存取 Homestead

有時你可能想你檔案系統任何地方 vagrant up 你的 Homestead 機器。你可以增加簡單的 Bash 函式至你的 Bash 設定檔來做到。此函式會自動指到你的 Homestead 安裝位置，能讓你在系統的任何位置執行任意的 Vagrant 指令：

function homestead() {
    ( cd ~/Homestead && vagrant $* )
}

確保函式中 ~/Homestead 路徑為你實際 Homestead 的安裝位置。一旦函式被設定後，你可以在系統的任何位置執行像是 homestead up 或 homestead ssh 的指令。

透過 SSH 連接

你可以在終端機裡進入你的 Homestead 目錄，並執行 vagrant ssh 指令藉此以 SSH 連上你的虛擬主機。

但是，你可能會經常需要透過 SSH 連上你的 Homestead 主機，因此你可以考慮在你的本機電腦上創建一個上述的「Bash 函式」來快速 SSH 至 Homestead box。

連接資料庫

homestead 的資料庫設定了 MySQL 與 Postgres 兩種資料庫。為了方便使用，Laravel 的 .env 檔案預設會設定框架會使用此資料庫。

如果想要從本機電腦上透過資料庫連線程式連接你的 MySQL 或 Postgres 資料庫，你應該連接 127.0.0.1 連接埠 33060 (MySQL) 或 54320 (Postgres)。資料庫的帳號及密碼皆為 homestead / secret.

{note} 在本機電腦你應該只使用這些非標準的連接埠來連接資料庫。因為當 Laravel 執行於虛擬主機中時，你會在 Laravel 的資料庫設定檔使用預設的 3306 及 5432 連接埠。

增加更多網站

一旦 Homestead 環境配置完畢且執行後，你可能會想要為 Laravel 應用程式增加更多的 Nginx 網站。你可以在單一個 Homestead 環境中執行多個 Laravel 安裝程式。若要增加額外的網站，只要增加網站至你的 ~/.homestead/Homestead.yaml 檔案中，接著在你的 Homestead 目錄執行 vagrant reload --provision 終端機指令。

設定 Cron 排程器

Laravel 提供了便利的方式來排程 Cron 任務，透過 schedule:run Artisan 指令，排程便會在每分鐘被執行。schedule:run 指令會檢查定義在你 App\Console\Kernel 類別中排程的任務，判斷哪個任務該被執行。

如果你想為 Homestead 網站使用 schedule:run 指令，你可以在定義網站時設置 schedule 選項為 true：

sites:
    - map: homestead.app
      to: /home/vagrant/Code/Laravel/public
      schedule: true

該網站的 Cron 任務會被定義於虛擬機器的 /etc/cron.d 資料夾中。

連接埠

以下的連接埠預設將會被轉發至 Homestead 環境：

SSH: 2222 → 轉發至 22
HTTP: 8000 → 轉發至 80
HTTPS: 44300 → 轉發至 443
MySQL: 33060 → 轉發至 3306
Postgres: 54320 → 轉發至 5432

轉發更多連接埠

你可以轉發更多額外的連接埠給 Vagrant box，同時也可指定連接埠的通訊協定：

ports:
    - send: 93000
      to: 9300
    - send: 7777
      to: 777
      protocol: udp

網路介面卡

Homestead.yaml 檔案中的 networks 屬性，用來配置 Homestead 環境中的網路介面卡。你可以依需求配置多張介面卡：

networks:
    - type: "private_network"
      ip: "192.168.10.20"

啟用橋接模式介面卡，設定 bridge 屬性，並且更改 network type 屬性為 public_network:

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"

啟用 DHCP模式，只要從設定中移除 ip 屬性：

networks:
    - type: "public_network"
      bridge: "en1: Wi-Fi (AirPort)"

升級 Homestead

可以使用兩個簡單的步驟來升級 Homestead，首先，應該先使用指令 vagrant box update 來升級 Vagrant box：

vagrant box update

接下來，再更新 Homestead 的原始程式碼。若您是用 clone 的方式下載的話，可以在本地端儲存庫下，簡單地使用 git pull origin master 更新你的儲存庫。

假如您是透過專案的 composer.json 來安裝 Homestead，請先確認 composer.json 檔中含有 "laravel/homestead": "^4"，再升級專案的相依函示庫：

composer update

舊版本

可以簡單地在 Homestead.yaml 檔案中，藉由增加以下的一行，覆寫 Homestead box 的版本：

version: 0.6.0

範例：

box: laravel/homestead
version: 0.6.0
ip: "192.168.20.20"
memory: 2048
cpus: 4
provider: virtualbox

當使用舊版 Homestead box，需要有相符的 Homestead 原始碼版本。下表列出支援的 box 版本，對應的 Homestead 原始碼版本，以及提供的 PHP 版本：

	Homestead 版本	Box 版本
PHP 7.0	3.1.0	0.6.0
PHP 7.1	4.0.0	1.0.0