Laravel的目的就是让开发这的开发体验更愉快，开发过程更加简单。在环境搭建上也是如此。
Laravel
homestead是一个官方发布的vagrant封装包——一个虚拟机——提供完备的开发环境。在homestead配置完成后，不需要在本地环境中配
置任何的开发工具，vagrant可以搞定一切。因为是虚拟机，不会对本地系统产生任何的破坏。同时如果出现故障，可以在几分钟内销毁并重建虚拟机。
homestead是跨平台的，可以在windows，Linux，Mac上运行，其中集成了nginx，php5.6，MySql，postgres，Redis，Memcached，HHVM等所有开发laravel所需的软件。
本文档是针对windows环境下homestead的配置运行。
1. 本地环境设置
1.1 编辑器
建议使用sublime Text 3，会有单独文档来说明如何使用Sublime Text高效开发php。
1.2 php
运行composer必须要有PHP，建议使用最新版本的发行版php，目前最新版本5.6.8。php
windows版本分为32位和64位的，64位目前仍处于试验阶段，我们选择稳定的32位版本。其中又分为thread safe和not
thread safe版本，在web开发中我们选择not thread safe版本，点击这里下载。
注意 php windows版本使用VC11编译，系统需要有Visual C++ Redistributable for Visual Studio 2012 x86 or x64，如果系统没有安装这个包，请点击这里下载安装。
（1） 下载压缩包解压到C盘根目录
（2） 配置环境变量，添加C:\php-5.6.8-nts-Win32-VC11-x86到PATH。
（3） 修改php配置。拷贝php.ini-development 为php.ini。去extension=php_openssl.dll（composer需要） extension=php_mbstring.dll（laravel需要）前的注释。找到; extension_dir = "ext"，修改为extension_dir = "C:\php-5.6.8-nts-Win32-VC11-x86\ext"。
（4）打开console，运行php -version确认php安装成功。
C:\>php -version PHP 5.6.8 (cli) (built: Apr 15 2015 15:07:05) Copyright (c) 1997-2015 The PHP Group Zend Engine v2.6.0, Copyright (c) 1998-2015 Zend Technologies
1.3 composer
点击这里下载。
安装完成后，打开console，运行composer --version确认安装成功。
C:\>composer --version Composer version 1.0-dev (bc45d9185513575434021527d7756420e9f4b2cf) 2015-05-11 14:49:39
composer默认会从·http://packagist.org/· 下载依赖包，速度比较慢，可以采用国内的镜像包来替代源。
composer的全局配置文件位于 C:\Users\benjamincao\AppData\Roaming\Composer\composer.json，两个速度比较快的可选的源配置如下：
{ "repositories":[
{ "type":"composer", "url":"https://toran.reimu.io/repo/packagist/"
},
{ "packagist":false
}
]
}
或者
{ "repositories": [
{ "type": "composer",
"url": "http://comproxy.cn/repo/packagist"
},
{ "packagist": false
}
]
}
在开发laravel项目时，也可以在当前项目的composer.json文件中添加这些国内镜像，可以加快对包的更新
1.4 putty
putty是免费的ssh客户端，登录homestead虚拟机的利器。
点击这里下载。
注意 如果不使用putty登录，用homestead ssh登录，也可以。
2. Homestead 相关软件安装
2.1 vagrant
vagrant是一个虚拟机管理工具。在添加虚拟机后，可以启动虚拟机的镜像，如果出现错误，可以随时销毁重建开发环境。
从这里 下载。下载后直接安装。
vagrant安装确认：
C:\>vagrant --version Vagrant 1.7.2
2.2 virtualbox
virtualbox是作为vagrant的一个provider，安装后，在启动homestead时候，vagrant会自动启动virtualbox。
从这里 下载，下载直接安装。
2.3 homestead
直接使用composer安装
composer global require "laravel/homestead=~2.0"
homestead将会被安装在C:\Users\benjamincao\AppData\Roaming\Composer\vendor\laravel\homestead
2.4 Git
安装Git的目的是使用Git Bash，homestead的启动脚本是bash shell，windows下面使用Git Bash正好。
点击这里下载，然后安装。安装完毕就可以使用了。
3. 环境启动
3.1 使用vagrant添加homestead镜像文件
vagrant box add laravel/homestead
选择virtualbox作为provider。
下载的虚拟机，位于C:\Users\benjamincao\VirtualBox VMs\homestead
注意虚拟机文件较大，下载需要较长时间，可以直接拷贝后，添加到vagrant中。
vagrant box add laravel/homestead file:///d:/hbox/virtualbox.box
3.2 生成rsa key
通过ssh登录homestead需要这个。
打开Git Bash，这是一个比较完备的Windows下的shell工具。在运行homestead的命令的时候都需要在这个bash中运行。
ssh-keygen.exe -t rsa -C "[email protected]"
3.3 配置并启动homestead
cd AppData/Roaming/Composer/vendor/laravel/homestead/ homestead init
生成homestead的配置文件，位于C:\Users\benjamincao\.homestead\Homestead.yaml
homestead edit
使用编辑器打开创建的配置文件。
--- # 虚拟机配置。 ip: "192.168.10.10" memory: 2048 cpus: 1 provider: virtualbox authorize: ~/.ssh/id_rsa.pub keys: - ~/.ssh/id_rsa # 共享文件夹配置，map是本地文件夹，此处修改为本地项目文件夹；to是虚拟机的文件夹，一般不需要修改，因为homestead中的nginx的配置也是如此。 folders: - map: ~/Code to: /home/vagrant/Code # nginx的配置。需要在本地hosts中添加域名的解析。 sites: - map: homestead.app to: /home/vagrant/Code/public # mysql的数据库配置 databases: - homestead # 这个不知道是干什么用的，猜测是环境变量设置。 variables: - key: APP_ENV value: local
一个可用的配置示例：
--- ip: "192.168.10.10" memory: 2048 cpus: 1 provider: virtualbox authorize: c:/Users/benjamincao/.ssh/id_rsa.pub keys: - c:/Users/benjamincao/.ssh/id_rsa folders: - map: D:/workspace/ERP/trunk to: /home/vagrant/Code sites: - map: homestead.app to: /home/vagrant/Code/Laravel/public databases: - homestead variables: - key: APP_ENV value: local # blackfire: # - id: foo # token: bar # client-id: foo # client-token: bar # ports: # - send: 93000 # to: 9300 # - send: 7777 # to: 777 # protocol: udp
启动homestead
homestead up
3.4 登录说明
登录主要包括ssh的登录和mysql的登录。
3.4.1 ssh登录
homestead ssh
我这里在使用homestead ssh时，总是会出现屏幕卡死的情况，推荐使用putty登录。
初始用户名密码 vagrant / vagrant
3.4 2 mysql密码
homestead / secretroot / secret
3.5 高级配置
3.5 增加新的网站
- 方法一
在homestead.yaml中添加站点配置。然后再homestead目录执行命令vagrant provision。vagrant provision这个命令是有破坏性的，它会重新构建数据库 - 方法二
ssh登录homestead后，执行serve命令。serve domain.app /home/vagrant/Code/path/to/public/directory 80
4. 命令详解
4.1 homestead命令
| 命令 | 解释 |
|---|---|
| up | 启动homestead |
| halt | 停止homestead |
| init | 创建初始化的homestead.yaml |
| edit | 编辑homestead.yaml |
| suspend | 挂起homestead |
| resume | 继续挂起的homestead |
| ssh | 通过ssh登录homestead |
| run | 通过ssh在homestead上运行命令 |
| status | 获取homestead的状态 |
| list | 列表命令 |
| help | 显示命令的帮助 |
| provision | 重新配置homestead |
| destory | 销毁homestead |
| update | 更新homestead镜像 |
在 1.3 composer 的安装中最好使用翻墙工具进行翻墙后安装，避免一直提示 “Connection Error [ERR_CONNECTION]: Unable to connect to getcomposer.org ...” 错误
在 2.3 homestead中
直接使用composer安装时，最好在composer.json中加上
避免错误：
如果homestead up的时候，一直提示下面的错误
解决：确保CPU开启了Virtualization Technology（VT）虚拟化支持。针对Intel的CPU，可在开机时按住相应的功能键进入BIOS，确认Intel Virtual Technology配置为enable。
错误：
执行以下步骤：
1、删除C:\Users\Carnet Motors\VirtualBox VM目录下的所有文件
2、在CMD运行如下命令
新版本安装不能直接 homestead init 而是要使用
bash init.sh
~ homestead up Bringing machine ‘default‘ up with ‘virtualbox‘ provider... ==> default: Box ‘laravel/homestead‘ could not be found. Attempting to find and install... default: Box Provider: virtualbox default: Box Version: <= 0.3.0
打开C:\Users\Carnet Motors\AppData\Roaming\Composer\vendor\laravel\homestead\scripts\homestead.rb文件 把
config.vm.box_version = settings["version"] ||= "<= 0.3.0" 改为 config.vm.box_version = settings["version"] ||= ">= 0.3.0"