簡介

Laravel 致力於讓整個 PHP 開發體驗變更的更愉快，包括你的本機開發環境。 Vagrant 提供了一種簡單、優雅的方式來管理和配置虛擬主機。

Laravel Homestead 是一個官方預先包裝的 Vagrant box ，它為你提供了一個完美的開發環境，你不需要在本地機器安裝 PHP、 web 伺服器和其他的伺服器軟體。你再也不用擔心會弄亂你的作業系統了！ Vagrant boxes 是一次性的。如果出現問題， 你可以在幾分鐘內銷毀並重新建立box !

Homestead 可以運行在任何Windows、 Mac、 或Linux 系統， 它包括了Nginx web 伺服器， PHP 7.3、 PHP 7.2、 PHP 7.1 、 MySQL、PostgreSQL、Redis、 Memcached、 Node 以及你開發Laravel 所需要的東西。

{note} 如果你使用的是 Windows, 你可能需要透過 BIOS 來啟用硬體虛擬化 (VT-x)。如果你在Hyper-V 系統上使用UEFI 你可能還需要停用Hyper-V 以便存取VT-x.

MailhogNeo4j (Optional)

Elasticsearch (Optional)

ngrok#wp-cli

Go

Minio

安裝& 設定

vagrant box add laravel/homestead

安裝 Homestead

你可以透過複製程式碼來安裝 Homestead。建議將程式碼克隆到你的"home" 目錄下的Homestead 資料夾中， 這樣Homestead box 就可以作為你的所有Laravel 專案的主機：

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

因為Homestead 的master 分支並不是穩定的，你應該使用打過標籤的穩定版本。你可以在GitHub 發行頁: 上找到最新的穩定版本:

cd ~/Homestead// 克隆期望的发行版本...git checkout v8.0.1

一旦克隆Homestead 程式碼完成以後，在Homestead 目錄中使用bash init.sh 指令來建立 Homestead.yaml 設定檔。 Homestead.yaml 檔案將會被放在Homestead 目錄中:

// Mac / Linux...bash init.sh// Windows...init.bat

設定Homestead

#設定提供器

Homestead.yaml 檔案中的 provider 參數決定了你使用的是哪一個Vagrant 提供者: virtualbox, vmware_fusion, vmware_workstation, parallels 以及hyperv。你可以根據你的喜好來設定他們:

provider: virtualbox

配置共享資料夾

Homestead.yaml 檔案的folders 屬性裡列出了所有與Homestead 環境共享的資料夾。這些資料夾中的檔案如果發生變更，它們會保持本機與 Homestead 環境之間同步。你可以根據需要配置多個共享資料夾:

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

如果你只創建幾個網站，這種通用的映射將運行的很好。但是，隨著網站數量的不斷增加，你可能會開始遇到效能問題。在包含大量文件的低效能機器或專案中，這個問題會非常明顯。如果遇到此問題，請嘗試將每個專案對應到自己的Vagrant 資料夾:

folders: 
   - map: ~/code/project1
      to: /home/vagrant/code/project1  
    - map: ~/code/project2
      to: /home/vagrant/code/project2

若要開啟NFS, 你只需要在共用的資料夾設定中新增一個簡單的標誌:

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

{note} 當使用NFS 時，你最好使用vagrant-winnfsd 擴充插件。這個外掛程式會替你處理 Homestead box 中的檔案或目錄權限的問題。

你也可以透過在 options 中列出 Vagrant's 的共享資料夾 支援的任何選項:

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.test
      to: /home/vagrant/code/my-project/public

如果你在配置Homestead 虛擬機後更改了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.test

確保監聽的 IP 位址是你在 Homestead.yaml 檔案中所設定的。一旦你將將網域加入hosts 檔案並啟動Vagrant Box 後，你就可以透過瀏覽器造訪該網站了:

http://homestead.test

啟動Vagrant Box

根據你的需求編輯完成Homestead.yaml，在你的Homestead 資料夾中執行vagrant up 指令。 Vagrant 將啟動虛擬機器並自動設定你的共用資料夾和 Nginx 網站。

若要刪除虛擬機，只需執行 vagrant destroy --force 指令。

根據專案安裝

除了全域安裝 Homestead 並且在所有專案共用相同的 Homestead box 之外， 你可以為每個專案配置 Homestead 實例。透過在專案下方建立 Vagrantfile，其他的專案成員只需執行 vagrant up 就能擁有相同的開發環境。

要將Homestead 直接安裝到專案中，需要使用Composer 指令:

composer require laravel/homestead --dev

Homestead 安裝之後， 使用make 指令在專案根目錄中產生 Vagrantfile 和Homestead.yaml 檔案。 make 指令會自動設定 Homestead.yaml 檔案中 sites 和 folders 指令。

Mac / Linux:

php vendor/bin/homestead make

Windows:

vendor\bin\homestead make

接下來，在命令列中執行vagrant up 命令，然後在瀏覽器中訪問http://homestead.test 。記住，在訪問之前你仍然需要在 /etc/hosts 檔案中加入你的 homestead.test 記錄或其他的網域。

安裝MariaDB

#如果你喜歡使用MariaDB 而不是MySQL，你可以在 Homestead.yaml 檔案中增加一個mariadb 的選項。這個選項會刪除 MySQL 並安裝 MariaDB。 MariaDB 只是作為MySQL 的旁支替代品，所以你還是可以在應用的資料庫設定中使用mysql# 資料庫驅動：

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

##安裝MongoDB

mongodb: true

box: laravel/homestead
ip: "192.168.10.10"memory: 4096cpus: 4provider: virtualbox
elasticsearch: 6

安裝 Neo4j

Neo4j 是一個圖形資料庫管理系統。要安裝Neo4j 社群版，需要更新Homestead.yaml 設定項如下：

neo4j: true

預設安裝的Neo4j 會將資料庫使用者名稱設定為homestead ，對應的密碼設定為secret 。要查看 Neo4j 可以在瀏覽器中存取 http://homestead.test:7474 。 Neo4j 對外提供了三個連接埠： 7687 （Bolt）、 7474 （HTTP）、 7473 （HTTPS） 用於從客戶端存取。

#別名

#你可以透過編輯Homestead 目錄下的aliases 檔案為Homestead 虛擬機器新增Bash 別名：

alias c='clear'alias ..='cd ..'

更新完aliases 檔案後， 你應該使用 vagrant reload --provision 指令重啟Homestead 虛擬機， 以確保新的別名在機器上可用。

#每日使用

vagrant up 指令啟動Homestead 虛擬機器。在 Mac / Linux 系統上可以在 Bash 設定檔（ ~/.bash_profile ）中新增 Bash 函數 。在 Windows 上， 你可以將「批次」檔案新增至 PATH 。這些腳本允許你在系統的任何位置運行Vagrant 命令並自動將該命令指向Homestead 的安裝路徑：

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

~/Homestead 路徑調整為實際的Homestead 安裝路徑。這樣你就可以在系統的任何位置運行 homestead up

homestead ssh 等指令。 Windows在系統的任何位置建立一個批次檔homestead.bat

@echo off

set cwd=%cd%
set homesteadVagrant=C:\Homestead
cd /d %homesteadVagrant% && vagrant %*
cd /d %cwd%
set cwd=
set homesteadVagrant=

homestead up

homestead ssh 等指令。

連接資料庫

homestead 預設已經在虛擬機器中為 MySQL 和 PostgreSQL 資料庫做好了設定。為了方便起見， Laravel 中的 .env 檔案將框架配置成預設使用此資料庫。

要從主機的資料庫用戶端連接到MySQL 或PostgreSQL ，應該連接到127.0.0.1 ，連接埠 33060 （MySQL） 或54320 （PostgreSQL）。使用者名稱和密碼分別是 homestead / secret 。

{note} 只有從本地連接 Hoemstead 的資料庫時才能使用這些非標準的連接埠。而 Laravel 在虛擬機器中 運行時還是應該使用預設的 3306 和 5432 連接埠進行資料庫連線。

資料庫備份

當你的Vagrant 盒子銷毀時，Homestead 能自動備份你的資料庫。為了利用這個功能，你必須使用 Vagrant 2.1.0 或更高的版本。或者，如果你使用一個舊版的 Vagrant，你必須安裝 vagrant-triggers 外掛程式。為了開啟自動資料庫備份，加入如下的行到你的Homestead.yaml 檔案：

backup: true

一旦配置了，當vagrant destroy 指令被執行時，Homestead將匯出你的資料庫到mysql_backup 和postgres_backup 目錄。如果你使用 每個專案安裝 方法，則可以在克隆的 Homestead 或在你的專案根目錄中找到這些目錄。

添加額外的網站

一旦你的Homestead 環境已配置並運行，你可以為你的Laravel應用程式新增額外的Nginx 網站。你可能希望在單一 Homestead 環境運行多個 Laravel 安裝。要新增額外的站點，到Homestead.yaml 檔案中新增網站：

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
    - map: another.test
      to: /home/vagrant/code/another/public

如果Vagrant 不能自動管理你的『hosts』文件，你可能還需要新增一個新的網站到該檔案中：

192.168.10.10  homestead.test
192.168.10.10  another.test

一旦這個網站被加入，從你的Homestead 目錄執行vagrant reload --provision 指令。

站點類型

Homestead 支援多種類型的站點，讓您可以輕鬆運行不是基於 Laravel 的專案。例如，我們可以使用symfony2 網站類型輕鬆地新增一個Symfony 應用到Homestead：

sites:
    - map: symfony2.test
      to: /home/vagrant/code/my-symfony-project/web
      type: "symfony2"

可用的網站類型是：apache，apigility，expressive，laravel（預設），proxy，silverstripe，statamic，symfony2，symfony4，和zf。

網站參數

你可以透過 params 網站指令新增額外的 Nginx fastcgi_param 到你的網站。例如，我們新增一個值為BAR 的Foo 參數：

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
      params:
          - key: FOO
            value: BAR

Homestead.yaml 檔案來設定全域環境變數：

variables:
    - key: APP_ENV
      value: local
    - key: FOO
      value: bar

Homestead.yaml 檔案之後，確保透過執行vagrant reload --provision 指令重新配置機器。這個將更新所有安裝 的 PHP 版本的 PHP-FPM 配置並為 vagrant 使用者更新環境。

schedule:run Artisan 指令去每分鐘運行。 schedule:run 指令將檢查在你在 App\Console\Kernel 類別中定義的計畫來決定要執行哪個作業。

schedule:run 指令運行起來，在定義網站時，你可以設定schedule 選項為true：

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
      schedule: true

/etc/cron.d 目錄中。

.env 檔案：

MAIL_DRIVER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

http://localhost:8025上訪問Mailhog 控制台。

minio: true

's3' => [
    'driver' => 's3',
    'key' => env('AWS_ACCESS_KEY_ID'),    
    'secret' => env('AWS_SECRET_ACCESS_KEY'),    
    'region' => env('AWS_DEFAULT_REGION'),    
    'bucket' => env('AWS_BUCKET'),    
    'endpoint' => env('AWS_URL'),    
    'use_path_style_endpoint' => true
    ]

AWS_ACCESS_KEY_ID=homestead
AWS_SECRET_ACCESS_KEY=secretkey
AWS_DEFAULT_REGION=us-east-1
AWS_URL=http://homestead:9600

buckets:
    - name: your-bucket
      policy: public
    - name: your-private-bucket
      policy: none

ports:
    - send: 50000
      to: 5000
    - send: 7777
      to: 777
      protocol: udp

share homestead.test

share homestead.test -region=eu -subdomain=laravel

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
      php: "7.1"

php7.1 artisan list
php7.2 artisan list
php7.3 artisan list

flip

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

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

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

sudo apt-get -y \
    -o Dpkg::Options::="--force-confdef" \
    -o Dpkg::Options::="--force-confold" \    
    install your-package

vagrant box update

git fetchgit checkout v8.0.1

composer update

vagrant destroy
vagrant up

provider: virtualbox
natdnshostresolver: off

config.vm.provider "virtualbox" do |v|
    v.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]
    end