1、准备开发环境

每次项目开发前，检查以下环境配置是否正确并更新到最新版本。

1、安装浏览器 Chrome

下载：https://www.google.cn/chrome

2、安装命令行工具 Git for Windows

下载： Git 官网 或 gitforwindows

查询版本：git --version

升级：Git for Windows 直接下载最新版本安装；虚拟机 VirtualBox 里 Homestead 自带的 Git 则升级 Homestead 即可。

3、安装代码编辑器 SublimeText

• 介绍：以下是几款非常优秀和流行的代码编辑器，首推 SublimeText，其次 Atom。

  • Atom
  • SublimeText
  • PHPStorm
  • Visual Studio
  • Vim
  • Eclipse

• 下载：

软件官网下载。安装后添加环境变量，方便命令行工具调用编辑器：

我的电脑 > 属性 > 高级系统设置 > 环境变量 > 修改用户变量或系统变量中的 Path > 新建 > 添加变量地址，如 C:\Atom > 一路确定，重启计算机。

测试：> atom --version

• 版本：帮助 - 关于

• 升级：软件官网下载最新版安装。

4、安装版本管理软件 Git

• 注：安装了命令行工具 Git for Windows 就默认安装好 Git ，无需另行安装。虚拟机里面 Homestead 也自带 Git，无需另行安装。

5、安装虚拟机 VirtualBox

• 介绍：VirtualBox 是 Oracle 公司的开源虚拟机软件。VirtualBox 号称是最强的免费虚拟机软件，它不仅功能齐全，而且性能也很优异！VirtualBox 支持大部分流行的系统，如：Mac, Windows, Linux 等。

• 下载：VirtualBox 官网下载

• 版本：帮助 - 关于

• 升级：官网下载最新版安装

6、安装虚拟机管理工具 Vagrant

• 介绍：Vagrant 是用来管理虚拟机的工具，支持当前主流的虚拟机系统如 VirtualBox、VMware、AWS 等。Vagrant 的主要作用是通过编写一个 Vagrantfile 文件提供一个可配置、可移植和复用的软件环境。

• 下载：Vagrant 官网下载

• 版本：vagrant --version

• 升级：官网下载最新版本

7、安装 Vagrant 盒子 Laravel Homestead

• 介绍：

Laravel 为开发者提供了一套完善的重量级本地开发环境 —— Laravel Homestead。 Laravel Homestead 实际是一个打包好各种 Laravel 开发所需软件和工具的 Vagrant 盒子。Homestead 包含了两个东西：

• Homestead Vagrant Box 虚拟机盒子；
• Homestead 管理脚本。

Homestead Vagrant Box 虚拟机盒子是提前打包好的 Vagrant Box 虚拟机盒子，里面预装了所有你在使用 Laravel 开发时所需要用到的各种软件。

Homestead 脚本使用 Ruby 和 Shell 脚本编写而成。原理是对 Vagrantfile 文件做定制。将从~/Homestead/Homestead.yaml 读取的配置信息，在 provision 时，解析为 Vagrant 命令并进行对虚拟机的配置。

• 下载：

homestead 管理脚本

Homestead Vagrant Box

• 安装

  • 导入 Homestead Vagrant Box：把 Homestead Box 解压到非中文路径，运行以下命令导入 Box：vagrant box add metadata.json

  • 安装 homestead 管理脚本

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

进入 Homestead 目录，使用 Git 检出我们需要的 Homestead 版本：

> cd ~/Homestead
> git checkout v5.4.0

初始化 Homestead：

> bash init.sh

• 版本：

  • Homestead Vagrant Box：vagrant box list
  • Homestead 管理脚本：（不知道）

• 升级：

更新 Homestead 只需要两个简单步骤。首先，运行 vagrant box update 更新 Vagrant box ：

vagrant box update

然后，更新 Homestead 源代码。如果你是使用 git 克隆仓库安装的，你可以在仓库目录下运行 git pull origin master 命令。

如果你是通过项目 composer.json 文件安装的，你需要更新 Homestead 依赖为 "laravel/homestead": "^7"，然后运行：

composer update

8、配置 Homestead.yaml 文件

Homestead.yaml 文件在 ~/Homestead 文件夹里，是主要配置信息文件，我们可以在此文件中配置 Homestead 的站点和数据库等信息。

快速打开：

> atom ~/Homestead/Homestead.yaml

配置类型

Homestead.yaml 里的配置大致可以分为以下几种：

1. 虚拟机设置；
2. SSH 秘钥登录配置；
3. 共享文件夹配置；
4. 站点配置；
5. 数据库配置；
6. 自定义变量。

虚拟机设置

Homestead 支持我们对虚拟机的 IP，内存，CPU，虚拟机的默认提供者进行配置。

ip: "192.168.10.10"
memory: 2048
cpus: 1
provider: virtualbox

SSH 秘钥登录配置

authorize 选项是指派登录虚拟机授权连接的公钥文件，此文件填写的是主机上的公钥文件地址，虚拟机初始化时，此文件里的内容会被复制存储到虚拟机的 /home/vagrant/.ssh/authorized_keys文件中，从而实现 SSH 免密码登录。

authorize: ~/.ssh/id_rsa.pub

keys 是数组选项，填写的是本机的 SSH 私钥文件地址。虚拟机初始化时，会将此处填写的所有 SSH 私钥文件复制到虚拟机的 /home/vagrant/.ssh/ 文件夹中，从而使虚拟机能共享主机上的 SSH 私钥文件，使虚拟机具备等同于主机的身份认证。

将公钥和私钥一起同步到虚拟机中：

keys:
    - ~/.ssh/id_rsa
    - ~/.ssh/id_rsa.pub

生成 SSH Key，先检查主机上是否已经生成过 SSH Key：

> ls -al ~/.ssh

如果不存在 id_rsa 和 id_rsa.pub 的话，使用以下方法来生成 SSH Key，请将 your_email@example.com 替换为你的邮箱：

> ssh-keygen -t rsa -C "your_email@example.com"

命令行会提示让你指定秘钥的名称，按回车键将 SSH Key 保存到默认文件名即可：

Enter a file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]

接下来会询问你为 SSH Key 设置密码，按回车键即可，默认为空密码：

Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

然后一路 Enter 键即可，如图：

image

再使用：

> ll ~/.ssh

查看的话，可看到两个文件：

SSH 秘钥的两个文件：

• id_rsa —— SSH 秘钥的 私钥 (Private Key)
• id_rsa.pub —— SSH 秘钥的 公钥 (Public Key)

共享文件夹配置

通过 folders 来指明本机要映射到 Homestead 虚拟机上的文件夹。

• map 对应的是我们本机的文件夹；
• to 对应的是 Homestead 上的文件夹。

统一配置如下：

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

创建~/Code 文件夹：

> cd ~
> mkdir Code

站点配置

站点配置允许你在主机里，通过域名来访问虚拟机里的 Laravel 应用。如下面 sites 配置所示，将 homestead.app 映射到一个 Laravel 项目的 public 目录上。

sites:
    - map: homestead.app
      to: /home/vagrant/Code/Laravel/public

绑定 hosts：

使用编辑器直接打开文件： C:\Windows\System32\Drivers\etc\hosts ，在最后面加入以下一行：

192.168.10.10 homestead.app

数据库配置

为 Homestead 指定数据库名称，这里使用默认设置即可。

databases:
    - homestead

自定义变量

如果你需要自定义一些在虚拟机上可以使用的自定义变量，则可以在 variables 中进行定义。

variables:
    - key: APP_ENV
      value: local

运行 Vagrant

Vagrant 常用的一些命令行的使用：

命令行	说明
vagrant init	初始化 vagrant
vagrant up	启动 vagrant
vagrant halt	关闭 vagrant
vagrant ssh	通过 SSH 登录 vagrant（需要先启动 vagrant）
vagrant provision	重新应用更改 vagrant 配置
vagrant destroy	删除 vagrant

启动 Homestead：

> cd ~/Homestead && vagrant up

第一次启动时，Vagrant 会做以下这几件事情：

• 以导入的 Homestead 虚拟机盒子为模板，新建一台虚拟机；
• 并按照 Homestead.yaml 里的配置信息，对这台新建的虚拟机进行配置；
• 配置完成后启动虚拟机。

成功启动后，还是在 ~/Homestead 目录中，通过以下命令来 SSH 登录 Homestead 虚拟机中：

> vagrant ssh

退出虚拟机：

> exit

关闭 Homestead：

`> vagrant halt