Homestead for Windows-优快云博客

Homestead Windows

Laravel 致力于让整个 PHP 开发体验变得愉快，包括你的本地开发环境。 Vagrant 提供了一种简单，优雅的方式来管理和配置虚拟机。 Laravel Homestead 是一个官方预封装的 Vagrant box，它为你提供了一个完美的开发环境，而无需在本地机器安装 PHP 、Web 服务器和其他服务器软件。不用担心会搞乱你的操作系统！Vagrant boxes 是一次性的。如果出现问题，你可以在几分钟内销毁并创建 Box! Homestead 可以运行在任何 Windows，Mac，或 Linux 系统，它包括了 Nginx web 服务器， PHP 7.2，PHP 7.1，PHP 7.0，PHP 5.6， MySQL，PostgreSQL，Redis，Memcached， Node，以及开发 Laravel 应用程序所需要的东西。

以下代码都是在windows 使用 git for windows 命令行工具操作的

一:安装VirtualBox

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

二:Vagrant

Vagrant by HashiCorp Vagrant 是用来管理虚拟机的工具，支持当前主流的虚拟机系统如 VirtualBox、VMware、AWS 等。Vagrant 的主要作用是提供一个可配置、可移植和复用的软件环境。Vagrant 让你通过编写一个 Vagrantfile 文件来控制虚拟机的启动、虚拟机网络环境的配置、虚拟机与主机间的文件共享，以及启动后自动执行一些配置脚本，如自动执行一个 Shell Script 来安装一些必备的开发工具，如安装配置MySQL、PHP，甚至是自动配置 Nginx 站点。这意味着，在一个多人开发的项目中，你只需要同步 Vagrantfile 文件，就可以保证参与项目的每个人各自的机器上拥有一致的开发环境。可以在下面网站上搜索需要的vagrant box https://app.vagrantup.com/boxes/search

三:安装Git

如果你先前已使用过 Git for Windows 来作为你进行 Laravel 项目开发时的默认命令行工具，则该工具将会默认为你安装好 Git。

使用以下命令来检测是否成功安装：

> git --version

四:导入Homestead box

Homestead是一个官方预封装的 Vagrant box，它为你提供了一个完美的开发环境，而无需在本地机器安装 PHP 、Web 服务器和其他服务器软件。不用担心会搞乱你的操作系统！Vagrant boxes 是一次性的。如果出现问题，你可以在几分钟内销毁并创建 Box!

内置软件：Ubuntu 16.04、Git、PHP 7.2、PHP 7.1、Nginx、Apache (Optional)、MySQL ……

在线安装 Homestead Vagrant Box，这样安装下载会非常慢，可以使用第二种本地文件安装方式

vagrant box add laravel/homestead

本地文件安装先下载离线 homestead.box ，然后执行

vagrant box add laravel/homestead d:/homestead63/homestead.box

安装的box 镜像储存的位置：以我电脑为例在 ~/.vagrant.d/boxes

五:安装 Homestead 管理脚本

#clone管理脚本

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


#因为master不稳定所以切到稳定tag

git checkout v7.18.0


#创建 Homestead.yaml 配置文件

bash init.sh

运行以上命令后，会在 ~/Homestead 目录下生成以下三个文件：

Homestead.yaml - 主要配置信息文件，我们可以在此文件中配置 Homestead 的站点和数据库等信息；
after.sh - 每一次 Homestead 盒子重置后（provision）会调用的 shell 脚本文件；
aliases - 每一次 Homestead 盒子重置后（provision），会被替换至虚拟机的 ~/.bash_aliases 文件中，aliases 里可以放一些快捷命令的定义。

接下来我们将会对 Homestead.yaml 文件的各项配置信息进行详细讲解。

如果是本地安装的 homestead.box 版本为0，所以需要修改下面步骤生成的配置文件 /Users/xj/Homestead/scripts/homestead.rb 以下内容

config.vm.box_version = settings["version"] ||= ">= 0"

六:Homestead.yaml配置文件

Homestead.yaml 文件在 ~/Homestead 文件夹里，在 Git-Bash 里，你可以使用以下命令使用文件夹打开当前命令行所在目录：

> cd ~/Homestead/
> explorer .

可通过运行下面命令快速打开 Homestead.yaml 文件：

> subl ~/Homestead/Homestead.yaml

为了行文方便，后面如果没有提示的话， Homestead.yaml 指的是 ~/Homestead/Homestead.yaml 文件。

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

虚拟机设置；
SSH 秘钥登录配置；
共享文件夹配置；
站点配置；
数据库配置；
自定义变量；

接下来我们逐个讲解。

1. 虚拟机设置

Homestead 支持我们对虚拟机的 IP，内存，CPU，虚拟机的默认提供者进行配置。这里我们基本不需要做任何配置，因此可以跳过。

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

2. SSH 秘钥登录配置

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

authorize: ~/.ssh/id_rsa.pub

keys 是数组选项，填写的是本机的 SSH 私钥文件地址。虚拟机初始化时，会将此处填写的所有 SSH 私钥文件复制到虚拟机的 /home/vagrant/.ssh/ 文件夹中，从而使虚拟机能共享主机上的 SSH 私钥文件，使虚拟机具备等同于主机的身份认证。此功能为 SSH 授权提供了便利，例如在后面章节中，我们只需要在 GitHub 上配置一个 SSH 公钥，即可实现 GitHub 对虚拟机和主机共同认证。

此处我们将公钥和私钥一起同步到虚拟机中：

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

接下来我们来生成 SSH Key，开始之前，我们先使用以下命令来检查主机上是否已经生成过 SSH Key：

> ls -al ~/.ssh

如果存在 id_rsa 和 id_rsa.pub的话，请跳过以下生成 SSH 的步骤继续阅读剩下内容。

否则使用以下方法来生成 SSH Key，请将 your_email@example.com 替换为你的邮箱：

> ssh-keygen -t rsa -C "your_email@example.com"
Generating public/private rsa key pair.

命令行会提示让你指定秘钥的名称，按回车键将 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 键即可，大致如下：

这个时候如果我们再使用：

> ls -al ~/.ssh

查看的话，会出现：

SSH 秘钥的两个文件：

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

3. 共享文件夹配置

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

map 对应的是我们本机的文件夹，格式例如：E：/Homestead/Code，以开发者实际项目目录为准。
to 对应的是 Homestead 上的文件夹。

为了后续课程讲解，请统一配置如下：

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

默认 Homestead 会将我们本机的 ~/Code 文件夹映射到 /home/vagrant/Code 文件夹上。现在我们本机还没有 ~/Code 文件夹，让我们来创建一个：

> cd ~
> mkdir Code

执行成功后，同样的，我们可以通过 explorer . 命令在文件夹中打开此目录：

在后面的章节中，我们将会在该文件夹下放置我们所有的 Laravel 项目，Homestead 会把该文件夹下的项目自动映射到虚拟机的 /home/vagrant/Code 文件夹上。

4. 站点配置

站点配置允许你在主机里，通过域名来访问虚拟机里的 Laravel 应用。如下面 sites 配置所示，将 homestead.test映射到一个 Laravel 项目的 public 目录上。这一行配置，会命令 Homestead 为我们新建一个 Nginx 站点，并且把 Web Root 配置到指定目录下。Laravel 应用的 Nginx 站点 Web Root 配置，默认就是在根目录下的 public 目录。

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

目前 Laravel 项目并不存在。这里先统一配置为以上，请不用着急，在后续的章节中，我们会创建该 Laravel 项目。

另外，主机里直接访问虚拟机站点，必须通过绑定 hosts 来实现。接下来我们利用 hosts 文件绑定 homestead.test 到虚拟机 IP 192.168.10.10 上。hosts 文件的完整路径为 C:\Windows\System32\Drivers\etc\hosts，可使用下面命令打开：

> subl C:/Windows/System32/Drivers/etc/hosts

如果你没有集成 subl 命令的话，请使用编辑器直接打开文件，文件路径在 C:\Windows\System32\Drivers\etc\hosts 。

在 hosts 文件的最后面加入以下一行：

192.168.10.10  homestead.test

至此站点就配置好了，等我们在后面章节创建 Laravel 项目后，即可通过浏览器访问 homestead.test 站点。

5. 数据库配置

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

databases:
    - homestead

6. 自定义变量

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

variables:
    - key: APP_ENV
      value: local

Homestead 自定义变量在本书中并未使用，知悉有此功能即可。

运行 Vagrant

完成了 Homestead 的配置，接下来我们要开始启动虚拟机了。

在命令中输入 vagrant，能看到 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

在我们登录成功后，你能看到类似于如下图的界面，现在我们在该终端界面中输入的所有命令都将运行在 Homestead 虚拟机上。

在虚拟机界面下可以输入退出虚拟机：

$ exit

最后尝试关闭 Homestead：

> vagrant halt

全局命令

如果我们想在任何目录都可以执行 vagrant 命令，需要进行以下设置修改 ~/.bash_profile 文件内容

function homestead() {
    ( cd ~/Homestead && vagrant $* )
}

这样我们就可以使用 homestead up 等方式执行了