Homestead 安裝過程記錄 (Windows)

2019/05/11 LaravelHomestead

# 安裝

# 本地軟體安裝

  1. PHP
  2. Composer
  3. Node.js
  4. Yarn(可選):npm install -g yarn

# 1. 安裝 Git

下載 Git

# 設定 Git

初次使用 Git 需設定使用者名稱和 E-mail:

$ git config --global user.name "John Doe"
$ git config --global user.email "johndoe@example.com"

若出現亂碼 ESC[33ESC[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 (虛擬機)

下載 VirtualBox

# 5. 安裝 Vagrant (虛擬機管理工具)

下載 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

(詳細、必讀) 配置 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

安裝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 安装问题汇总

# 在本機安裝 Homestead 的安全憑證

解決 HTTPS 顯示為不安全的問題。

登入虛擬機,輸入以下指令取得憑證 (your-dir 替換成任一已存在的資料夾):

$ sudo cp /etc/nginx/ssl/ca.homestead.homestead.crt ~/code/your-dir
# 如果上面不行就換下面
$ 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"

解決方法:重新開機並以 系統管理員 執行 Git bash,啟動虛擬機。完成後再執行一次 php artisan storage:link

# 執行 Vagrant up 時出錯,重新下載相關檔案

刪除以下資料夾:

  • C:\Users\[使用者]\.vagrant.d
  • C:\Users\[使用者]\VirtualBox VMs
  • C:\Users\[使用者]\Homestead\.vagrant

再重新執行 vagrant up