Homestead 安裝過程記錄 (Windows)

# 安裝

# 本地軟體安裝

PHP
Composer
Node.js
Yarn(可選)：npm install -g yarn

# 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 (虛擬機)

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