使用 vagrant 搭建自己的 Laravel 开发环境 for windows

标签：工具 homestead PHP 环境搭建

什么是vagrant

网上对vagrant的介绍有很多，对于什么是vagrant这个问题，一般有这些说法：

Vagrant 是一个可创建轻量级、高复用性和便于移植的开发环境的工具。

Vagrant 是一款用来构建虚拟开发环境的工具，非常适合 php/python/ruby/java 这类语言开发 web 应用，“代码在我机子上运行没有问题”这种说辞将成为历史。

而我认为的vagrant是这样的：

vagrant 是一个虚拟机管理的工具。利用这个工具，你可很方便的管理你的虚拟机，包括新建、销毁、启动、重载以及与本地文件的共享都非常方便。你可以将你配置好的开发环境（包括操作系统以及各种安装程序及配置）打包成box包，也可以从网上下载配置好的box包，利用这些box包，乐意非常方便地新建基于这个包的虚拟开发环境。

安装vagrant

安装VirtualBox，你的虚拟机就运行在VirtualBox上面。 5.0.20
VirtualBox下载地址：https://www.virtualbox.org/wiki/Downloads
安装Vagrant，下载并安装Vagrant。安装完成之后，默认情况下C:\HashiCorp\Vagrant\bin已加入环境变量（没有的话可以手动加入），因此你可以下cmd下输入vagrant -v下查看vagrant的安装目录
下载box文件。box文件里面打包了你的操作系统环境以及各种安装程序，下面的几个常用box文件的下载地址：
Ubuntu precise 32 VirtualBox：http://files.vagrantup.com/precise32.box
Ubuntu precise 64 VirtualBox：http://files.vagrantup.com/precise64.box
上面的包里面只有Ubuntu操作系统，没有其他开始程序，使用这个box你还需要在你的虚拟机上重新配置你的开发环境

到此你的vagrant已经安装好了，下面是vagrant的配置与使用

vagrant配置

添加box包，在cmd命令下，运行如下命令

//添加Ubuntu的包
vagrant box add Ubuntu C:\precise32.box \\ 'Ubuntu'是包的名字，'C:\precise32.box'是包的地址。
//添加homestead的包
vagrant box add laravel/homestead https://atlas.hashicorp.com/laravel/boxes/homestead

Ubuntu的包里面只是一个Ubuntu的操作系统，并没有其他的软件；laravel/homestead包里面包含了开发laravel应用的一些环境，主要包括：

Ubuntu 14.04
Git
PHP 7.0
HHVM
Xdebug
Nginx
MySQL
SQLite 3
Postgres
Composer
Node（With PM2, Bower, Grunt, and Gulp）
Redis
Memcached
Beanstalkd
Blackfire Profiler
添加完成之后你可以在cmd下运行vagrant box list查看你添加的所有box包。

初始化vagrant环境
进入你的工作目录，运行如下代码

vagrant init laravel/homestead

在此目录下，将会生成基于laravel/homestead包的虚拟环境。默认情况下，将会生成一个Vagrantfile的文件，里面是关于这个虚拟环境的配置。具体配置将会在下面讲到。

启动虚拟机

vagrant up

这样你就能启动你的虚拟机了。

连接到虚拟机

vagrant ssh

当然你也可以使用xshell的工具进行连接，主机：127.0.1.1，端口号：2222，用户名：vagrant，密码：vagrant。

虚拟主机配置

Vagrantfile文件里面包含了你相关虚拟主机的配置，只要把相应配置前面的注释删掉相应的配置就能生效。

1. 网络相关配置

从访问虚拟的网络，vagrant主要提供了三种访问方式

端口映射
较为常用是端口映射，就是将虚拟机中的端口映射到宿主机对应的端口直接使用，在Vagrantfile中配置：

config.vm.network :forwarded_port, guest: 80, host: 8080

guest: 80 表示虚拟机中的80端口， host: 8080 表示映射到宿主机的8080端口。这样你就能在你的机器上通过访问127.0.0.1:8080访问你的虚拟主机了

私有网络
如果需要自己自由的访问虚拟机，但是别人不需要访问虚拟机，可以使用private_network，并为虚拟机设置IP ，在Vagrantfile中配置：

config.vm.network "private_network", ip: "192.168.33.10"

192.168.33.10 表示虚拟机的IP，多台虚拟机的话需要互相访问的话，设置在相同网段即可。

公共网络
如果需要将虚拟机作为当前局域网中的一台计算机，由局域网进行DHCP，那么在Vagrantfile中配置：

config.vm.network :public_network

目录映射

既然是开发环境，那么开发工作肯定还是需要在本地完成，而不是都要进到虚拟机中去完成，虚拟机就好好在后台运行服务就好了，不然就本末倒置了，所以这里就需要使用目录映射功能，将本地的目录映射到虚拟机的对应目录，本地文件的更改自动同步到虚拟主机中。在Vagrant进行目录映射的配置如下：

  config.vm.synced_folder "www", "/srv/www"

前面的参数 “www” 表示的是本地的路径，这里使用对于工作目录的相对路径，这里也可以使用绝对路径，比如： “d:/www/”。后面的参数 “/srv/www” 表示虚拟机中对应映射的目录。

运行脚本

虽然不是必须，但是如果有需要在启动时运行一些脚本（环境的安装或者有些服务的启动需要在完成目录映射之后进行），可以编辑脚本，类似如下（摘自Vagrant Document）：

#!/usr/bin/env bash

apt-get update
apt-get install -y apache2
rm -rf /var/www
ln -fs /vagrant /var/www

保存在和Vagrantfile相同目录，文件名自取（如 boot.sh），然后在Vagrantfile中添加：

config.vm.provision :shell, :path => "boot.sh"

虚拟主机内存和cpu核心

不进行虚拟主机内存配置的话，vagrant将会根据系统环境自动分配虚拟主机内存。这样有可能会吃掉太多的系统内存，通过以下配置，可设置虚拟主机的内存：

config.vm.provider "virtualbox" do |vb|
      #Display the VirtualBox GUI when booting the machine
      #vb.gui = true
      #Customize the amount of memory on the VM:
      vb.memory = "1024"
      vb.cpus = 2
      vb.name = "my_vm"
  end

连接数据库

在本地连接到你的虚拟主机的数据库，要根据你的网络配置，比如我使用的是192.168.33.10的私有网络配置，则连接到数据库的配置如下：

主机名：192.168.33.10
端口号：3306
用户名：homestead
密码：secret

vagrant常用命令

vagrant up （启动虚拟机）
vagrant halt （关闭虚拟机——对应就是关机）
vagrant suspend （暂停虚拟机——只是暂停，虚拟机内存等信息将以状态文件的方式保存在本地，可以执行恢复操作后继续使用）
vagrant resume （恢复虚拟机 —— 与前面的暂停相对应）
vagrant destroy （删除虚拟机，删除后在当前虚拟机所做进行的除开Vagrantfile中的配置都不会保留）

当在启动Vagrant后，对于虚拟机有进行过安装环境相关的配置，如果并不希望写在Vagrant的启动shell里面每次都重新安装配置一遍，可以将当前配置好的虚拟机打包成box。

vagrant package --output NAME --vagrantfile FILE
//可选参数：
//--output NAME ： （可选）设置通过NAME来指定输出的文件名
//--vagrantfile FILE：（可选）可以将Vagrantfile直接封进box中