Homestead 安裝過程記錄 (Windows)
# 安裝
# 本地軟體安裝
# 1. 安裝 Git
# 設定 Git
初次使用 Git 需設定使用者名稱和 E-mail:
$ git config --global user.name "John Doe"
$ git config --global user.email "johndoe@example.com"
若出現亂碼 ESC[33
和 ESC[m
可執行此指令:
$ git config --global core.pager "less -r"
# 2. 終端機 - Git Bash
終端機建議使用 Git Bash (安裝 Git 即會自動安裝Git Bash)。在 Git Bash 中無法使用 Ctrl
C/V
複製貼上,需要用 Ctrl
Insert
複製、Shift
Insert
貼上。
# 3. 安裝 SSH
Window 7 安裝SSH (Win10 系統已安裝):OpenSSH for Windows
生成私鑰:Generating a new SSH key and adding it to the ssh-agent
# 4. 安裝 VirtualBox (虛擬機)
# 5. 安裝 Vagrant (虛擬機管理工具)
# 6. 安装 Homestead 虛擬機 Box
執行:
$ vagrant box add laravel/homestead
# 7. 安裝 Homestead
Laravel 官網介紹:
Laravel Homestead 是一個官方預載的 Vagrant box,提供你一個美好的開發環境,你不需要在你的本機電腦安裝 PHP、HHVM、網頁伺服器或任何伺服器軟體。不用擔心搞亂你的系統!Vagrant box 可以搞定一切。如果有什麼地方出問題了,你可以在幾分鐘內快速的砍掉並重建虛擬機器!
Homestead 可以在任何 Windows、Mac 或 Linux 系統上面執行,裡面包含了 Nginx 網頁伺服器、PHP 7.0、MySQL、Postgres、Redis、Memcached、Node,以及所有你在使用 Laravel 開發各種精彩的應用程式時所需要的軟體。
執行:
$ git clone https://github.com/laravel/homestead.git ~/Homestead
$ cd ~/Homestead
$ init.bat
# 8. 配置 Homestead
(可選) 自動複製.gitconfig到虛擬機 (配置 Vagrantfile)
(可選) 移動Vagrant Box及VirtualBox VMs到其他磁碟 (固態硬碟適用)
# 9. BIOS 設定
重新開機,進入 BIOS,將「Intel Virtualization Technology」(Intel 虛擬化技術) 選項開啟
# 10. 啟動虛擬機
執行(Windows須使用Git-bash):
開機:
$ vagrant up
開機並更新設定:
$ vagrant up --provision
SSH連線、操作:
$ vagrant ssh
關機(虛擬機使用完畢須關機,否則下次使用會出問題):
$ vagrant halt
# 11. 安裝 phpMyAdmin
# 12. (Ubuntu) 修改Ubuntu預設編輯器
登入虛擬機,執行:
$ sudo update-alternatives --config editor
出現以下畫面:
輸入 3
,將會切換成Vim編輯器。
# 13. 配置共享資料夾
預設的資料夾為 C:\Users\[使用者]\code
,若 code
資料夾不存在須創建。
$ mkdir ~/code && cd ~/code
# 14. 新增 Laravel 專案
使用 Composer 下載 Laravel 安裝包:
$ composer global require "laravel/installer"
建立新 Laravel 專案 (blog
為專案名稱):
$ laravel new blog
修改 Homestead.yaml:
folders:
...
- map: ~/code/blog
to: /home/vagrant/code/blog
sites:
...
- map: blog.test
to: /home/vagrant/code/blog/public
重新啟動虛擬機:
$ vagrant halt && vagrant up --provision && vagrant ssh
# 15. 修改 Hosts 設定
開啟 C:\Windows\System32\drivers\etc\hosts
,增加以下設定:
192.168.10.10 blog.test
# 其他
# Homestead 安裝問題
# 在本機安裝 Homestead 的安全憑證
解決 HTTPS 顯示為不安全的問題。
登入虛擬機,輸入以下指令取得憑證 (your-dir
替換成任一已存在的資料夾):
$ sudo cp /etc/nginx/ssl/ca.homestead.homestead.crt ~/code/your-dir
# Ubuntu 20.04 的版本要執行下方的指令
$ sudo cp /etc/ssl/certs/ca.homestead.homestead.crt ~/code/your-dir
開啟檔案總管,雙擊開啟憑證,點擊 安裝憑證,憑證存放區選擇為 受信任的根憑證授權單位,之後點擊完成即可。
# (Windows CMD) 設定在虛擬機中用 Composer 安裝套件時,新增 .bat 檔
Config (bin-compat) - Composer
於 Homestead 執行:
$ composer config -g bin-compat full
# 增加路徑至 PATH
執行:
sudo vim ~/.profile
輸入:
PATH="/home/vagrant/.yarn/bin:$PATH"
# 執行 php artisan storage:link 時出錯 (無法新增 symlinks)
解決方法:重新開機並以 系統管理員 執行 Git bash,啟動虛擬機。完成後再執行一次 php artisan storage:link
。
# 執行 Vagrant up 時出錯,重新下載相關檔案
刪除以下資料夾:
C:\Users\[使用者]\.vagrant.d
C:\Users\[使用者]\VirtualBox VMs
C:\Users\[使用者]\Homestead\.vagrant
再重新執行 vagrant up