安裝Homestead
Homestead = VirtualBox + Vargrnt + Homestead Vagrant Box + Homestead Scripts。
安裝VirtualBox
到VirtualBox Download下载VirtualBox for OS X hosts
安裝Vagrant
到Vagrant Download下载Vagrant for OSX。
下載Homestead
使用vagrant box add下载Homestead vagrant box
$ vagrant box add laravel/homestead
==> box: Loading metadata for box 'laravel/homestead'
box: URL: https://vagrantcloud.com/laravel/homestead
This box can work with multiple providers! The providers that it
can work with are listed below. Please review the list and choose
the provider you will be working with.
1) parallels
2) virtualbox
3) vmware_desktop
Enter your choice: 2
==> box: Adding box 'laravel/homestead' (v4.0.0) for provider: virtualbox
box: Downloading: https://vagrantcloud.com/laravel/boxes/homestead/versions/4.0.0/providers/virtualbox.box
选择 2 , virtualbox
下载链接有点慢,同时文件也较大,可以到这儿下载 https://atlas.hashicorp.com/laravel/boxes/homestead
到对应版本 URL 下然后增加
/providers/{{provider}}.box
就可以拿到单独的下载地址了,然后再 vagrant box add 就好啦
- VirtualBox: https://atlas.hashicorp.com/laravel/boxes/homestead/versions/4.0.0/providers/virtualbox.box
- Vmware_Desktop: https://atlas.hashicorp.com/laravel/boxes/homestead/versions/4.0.0/providers/vmware_desktop.box
vagrant box add laravel/homestead /Users/{user}/Downloads/virtualbox.box
修改virtualbox.box的版本号
cd ~/.vagrant.d/boxes/laravel-VAGRANTSLASH-homestead
方法一:
1、该目录下添加文件metadata_url
`vi metadata_url `
添加内容 https://atlas.hashicorp.com/laravel/homestead
2、把版本号 0 重命名为 下载的virtualbox.box的版本,比如 4.0.0
方法二:
修改homestead.rb文件,将config.vm.box_version = settings["version"] ||= ">= 0.4.4"修改为config.vm.box_version = settings["version"] ||= ">= 0"
下载Vagrantfile + Scripts
$ git clone https://github.com/laravel/homestead.git Homestead
Cloning into 'Homestead'...
remote: Counting objects: 2604, done.
remote: Compressing objects: 100% (12/12), done.
remote: Total 2604 (delta 9), reused 15 (delta 9), pack-reused 2583
Receiving objects: 100% (2604/2604), 484.91 KiB | 214.00 KiB/s, done.
Resolving deltas: 100% (1527/1527), done.
# achan @ achandeMac-mini in ~/Documents/WORKSPACE_PHP/Homestead on git:master o [10:18:44]
$ ll
total 176
-rw-r--r-- 1 achan staff 187B 11 1 10:17 CHANGELOG.md
-rw-r--r-- 1 achan staff 1.1K 11 1 10:17 LICENSE.txt
-rw-r--r-- 1 achan staff 1.6K 11 1 10:17 Vagrantfile
drwxr-xr-x 3 achan staff 102B 11 1 10:17 bin
-rw-r--r-- 1 achan staff 809B 11 1 10:17 composer.json
-rw-r--r-- 1 achan staff 55K 11 1 10:17 composer.lock
-rw-r--r-- 1 achan staff 265B 11 1 10:17 init.bat
-rw-r--r-- 1 achan staff 250B 11 1 10:17 init.sh
-rw-r--r-- 1 achan staff 383B 11 1 10:17 phpunit.xml.dist
-rw-r--r-- 1 achan staff 1.4K 11 1 10:17 readme.md
drwxr-xr-x 7 achan staff 238B 11 1 10:17 resources
drwxr-xr-x 28 achan staff 952B 11 1 10:17 scripts
drwxr-xr-x 5 achan staff 170B 11 1 10:17 src
drwxr-xr-x 6 achan staff 204B 11 1 10:17 tests
Vagrantfile : 事實上將來每次下vagrant up指令時,就是在找這個檔案,這是Vagrant Box啟動時第一個執行的檔案,Homestead已經幫我們客製化了。
init.sh : 建立自己的Homestead.yaml、after.sh與aliases,稍後會用到。
scripts目錄 : Homestead自己會用到的scripts,如homestead.rb就在此目錄下。
设置SSH密钥
将会使用SSH方式连接Homestead,所以要设定SSH。
ssh-keygen -t rsa -C "achan@homestead"
设置Homestead.yaml
# achan @ achandeMac-mini in ~/Documents/WORKSPACE_PHP/Homestead on git:master o [10:34:23]
$ sh ./init.sh
init.sh會幫我們在~/.homestead/目錄建立Homestead.yaml ,還幫我們建立了after.sh與aliases
修改Homestead.yaml
homestead.rb會依照Homestead.yaml的設定為我們的Homestead做provision。
$ vi Homestead.yaml
---
ip: "192.168.10.10"
memory: 2048
cpus: 1
provider: virtualbox
authorize: ~/.ssh/id_rsa.pub
keys:
- ~/.ssh/id_rsa
folders:
- map: /Users/achan/Documents/Homestead/Code //本机目录
to: /home/vagrant/code //虚拟机映射目录
sites:
- map: homestead.app
to: /home/vagrant/code/public
databases:
- homestead
# blackfire:
# - id: foo
# token: bar
# client-id: foo
# client-token: bar
# ports:
# - send: 50000
# to: 5000
# - send: 7777
# to: 777
# protocol: udp
- ip : 設定Homestead的IP,若IP沒有相衝,可以不用修改。
- memory : 單位為MB,預設開2GB,若你嫌這樣太耗記憶體,根據經驗,512MB就可以讓Homestead啟動,不過有些service會失敗,1GB以上service都會正常,不過因為記憶體較少,有時會因為swap memory到HDD/SSD導致效能較差。
- cpu : 維持預設1顆CPU即可。
- provider : 使用VirtualBox,不用修改。
- authorize : 設定SSH public key位置,若之前ssh-keygen使用預設位置建立,則不用修改。
- keys : 設定SSH private key位置,若之前ssh-keygen使用預設位置建立,則不用修改。
- folders : Homestead.yaml重要的設定,設定Mac本機與Homestead的對應路徑。
* map : 設定Mac本機Laravel專案路徑,可自行修改。預設值是~/Code,目前接受預設值即可。- to : 設定Homestead內Laravel專案路徑,可自行修改。目前接受預設值即可。
事實上這就是VirtualBox的shared folder機制,我們知道VM最佳使用方式是環境灌在VM內,但專案放在本機,透過shared folder機制讓VM使用本機的專案,這樣的優點是儘管VM損毀開不了機,專案仍然不會受影響,因為專案是放在本機,只要再重新建立一個VM即可。
-
sites : Homestead.yaml重要的設定,讓你可以對Nginx設定網域主機名稱。
map : 網域主機名稱。預設為homestead.app,目前接受預設值即可。
to : 此站台所對應的目錄名稱。預設為/home/vagrant/Projects/Laravel/public。因為Laravel的index.php放在public目錄下。目前接受預設值即可。
databases : Homestead.yaml重要的設定,可以在此設定資料庫名稱,由Homestead幫你自動建立。目前維持預設homestead即可。
variables : 設定Lavavel全域變數,目前使用預設值即
创建 Code目录
$ cd /Users/achan/Documents/Homestead/
$ mkdir Code
Homestead.yaml 里面的Code目录并不存在,因此要创建一个(Laravel代码将下载到这儿)。
修改hosts
添加ip 与 主机名
192.168.10.10 homestead.app
启动Homestead
使用vagrant up啟動Homestead
vagrant init
vagrant up
若此時打開VirtualBox,會發現有一個VM正在執行中,這也證明了Vagrant背後執行的是VirtualBox。
下载Laravel
使用vagrant ssh登入Homestead
vagrant ssh
进入之前创建的Code目录cd Code
使用composer 下载larval
composer create-project laravel/laravel Laravel --prefer-dist
由于国内网络问题,下载较慢。可以使用国内的镜像
Packagist / Composer 中国全量镜像
統一將專案放在Code目錄下,其中Laravel為你的專案目錄名稱。
Composer將會建立一個Laravel目錄,並將Laravel所需要的檔案透過網路下載。
–prefer-dist : 此參數意思是下載用於distribution的穩定版本,而不是正在開發中的版本,對於應用來說,穩定版本較適當。
使用浏览器验证
输入 http://homestead.app/
Laravel
若能在瀏覽器看到Laravel 5,恭喜你,Homestead與Laravel環境已經大功告成了。
增加更多网站
Homestead 环境配置完毕且成功运行后,你可能会想要为 Laravel 应用程序增加其他的 Nginx 站点。你可以在单个 Homestead 环境中运行多个 Laravel 程序。要添加其他网站,只需将网站配置信息添加到 Homestead.yaml 文件中:
sites:
- map: homestead.app
to: /home/vagrant/Code/Laravel/public
- map: another.app
to: /home/vagrant/Code/another/public
如果 Vagrant 没有自动管理你的「hosts」文件,你可能需要手动把新增的站点加入到该文件中:
192.168.10.10 homestead.app
192.168.10.10 another.app
添加站点后,从 Homestead 目录运行 vagrant reload --provision 命令就可以应用新的更改。
如何在OS X安裝Homestead? | 點燈坊
Laravel 虚拟开发环境 Homestead | Laravel 5.5 中文文档