版本：5.3

Laravel Homestead

简介

Laravel 致力于让 PHP 的开发过程变得更加轻松愉快，这其中也包括你的本地开发环境。

Laravel Homestead 是一个官方预封装的 Vagrant box，提供给你一个完美的开发环境，你无需在本机电脑上安装 PHP、HHVM、Web 服务器或其它服务器软件。并且不用再担心系统被搞乱！Vagrant box 为你搞定一切。如果有什么地方出错了，你也可以在几分钟内快速的销毁并重建虚拟机！

Vagrant 是一个虚拟机管理软件。提供简单、优雅的方式来管理与配置虚拟机，Homestead 构建于 Vagrant 之上。

Homestead 可以在 Windows、Mac 或 Linux 系统上面运行，里面包含了 Nginx Web 服务器、PHP 7.0、MySQL、Postgres、Redis、Memcached、Node，以及所有你在使用 Laravel 开发时所需要用到的各种软件。

备注

如果你是 Windows 用户，你可能需要启用硬件虚拟化（VT-x）。这通常需要通过 BIOS 来启用它。如果你在一个 UEFI 系统上使用的是 Hyper-V，你需要关闭 Hyper-V 才能启用 VT-x。

内置软件

Ubuntu 16.04
Git
PHP 7.0
Nginx
MySQL
MariaDB
Sqlite3
Postgres
Composer
Node (With PM2, Bower, Grunt, and Gulp)
Redis
Memcached
Beanstalkd

安装与设置

第一步

在你启动 Homestead 环境之前，须先安装 VirtualBox 5.x 或 VMWare 以及 Vagrant。这些软件在各个常用的平台都有提供简单易用的界面安装包。

若要使用 VMware provider，你需要同时购买 VMware Fusion / Workstation 以及 VMware Vagrant plug-in 的软件授权。使用 VMware 可以在共享文件夹上获得较快的性能。

安装 Homestead Vagrant box

当 VirtualBox / VMware 以及 Vagrant 安装完成后，你使用以下命令将 laravel/homestead 这个 box 安装进你的 Vagrant 程序中。box 的下载会花费你一点时间，具体的下载时长由网络速度决定：

vagrant box add laravel/homestead

如果上面的命令运行失败，代表你使用的可能是旧版的 Vagrant，请升级你的 Vagrant。

安装 Homestead

你可以通过手动克隆代码仓库的方式来安装 Homestead。建议将代码仓库克隆至「home」目录中的 Homestead 文件夹，如此一来 Homestead box 就能将主机服务提供给你所有的 Laravel 项目：

cd ~

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

一旦你克隆完 Homestead 的代码仓库，即可在 Homestead 目录中运行 bash init.sh 命令来创建 Homestead.yaml 配置文件。Homestead.yaml 文件将会被放置在你的 ~/.homestead 目录中：

bash init.sh

配置 Homestead

配置你的提供者

Homestead.yaml 文件中的 provider 参数设置取决于你用的是哪一个 Vagrant 提供者：virtualbox、vmware_fusion 或 vmware_workstation。你可以根据自己的喜好来设置提供者：

provider: virtualbox

配置共享文件夹

你可以在 Homestead.yaml 文件的 folders 属性里列出所有想与 Homestead 环境共享的文件夹。这些文件夹中的文件若有变更，它们将会在你的本机电脑与 Homestead 环境自动更新同步。你可以在这里设置多个共享文件夹：

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

若要启用 NFS，只需要在共享文件夹的设置值中加入一个简单的参数：

folders:
    - map: ~/Code
      to: /home/vagrant/Code
      type: "nfs"

配置 Nginx 网站

对 Nginx 不熟悉吗？没关系。sites 属性可以帮助你可以轻易指定一个 域名 来对应到 homestead 环境中的一个目录上。在 Homestead.yaml 文件中已包含了一个网站设置范本。同样的，你也可以增加多个网站到你的 Homestead 环境中。Homestead 可以同时为多个 Laravel 应用提供虚拟化环境：

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

如果你在 Homestead box 配置之后更改了 sites 属性，那么应该重新运行 vagrant reload --provision 来更新 Nginx 配置到虚拟机上。

关于 Hosts 文件

你必须将在 Nginx sites 中所添加的「域名」也添加到你本机电脑的 hosts 上。hosts 文件会将请求重定向至 Homestead 环境中设置的本地域名。在 Mac 或 Linux 上，该文件通常会存放在 /etc/hosts。在 Windows 上，则存放于 C:\Windows\System32\drivers\etc\hosts。设置内容如下所示：

192.168.10.10  homestead.app

务必确认 IP 地址与 Homestead.yaml 文件中设置的相同。将域名设置在 hosts 文件之后，你就可以通过网页浏览器访问你的网站。

http://homestead.app

启动 Vagrant box

编辑完 Homestead.yaml 后，在命令行里进入你的 Homestead 目录并运行 vagrant up 命令。Vagrant 就会根据 Homestead.yaml 里的配置信息，为虚拟机设置共享文件夹和 Nginx 网站。

如果要移除虚拟机，可以使用 vagrant destroy --force 命令。

根据项目分开安装

除了全局使用同一个 Homestead 环境，Homestead 还允许你为项目独立配置一个独占的 Homstead。

通过传递 Vagrantfile，可以实现为每个项目分别安装上 Homestead，其他项目成员只需要通过简单的 vagrant up 即能跟你拥有一样的 Homestead 环境。

使用 Composer 将 Homestead 直接安装至项目中：

composer require laravel/homestead --dev

一旦 Homestead 安装完毕，可以使用 make 命令生成 Vagrantfile 与 Homestead.yaml 文件，并存放于项目的根目录。

这个 make 命令将会自动在 Homestead.yaml 文件中配置 sites 及 folders：

Mac / Linux:

php vendor/bin/homestead make

Windows:

vendor\\bin\\homestead make

接着，在命令行中运行 vagrant up 并通过网页浏览器访问 http://homestead.app。再次提醒，你仍然需要在 /etc/hosts 里配置 homestead.app 或其它想要使用的域名。

安装 MariaDB

如果你希望使用 MariaDB 来替换 MySQL，你可以在 Homestead.yaml 文件中增加一个 mariadb 的选项，这个选项会移除 MySQL 并安装 MariaDB。因为 MariaDB 可用作 MySQL 的替代品，所以在你的数据库配置信息里，还是选用 mysql 配置项。

box: laravel/homestead
ip: "192.168.20.20"
memory: 2048
cpus: 4
provider: virtualbox
mariadb: true

常见用法

全局使用

如果你希望在文件系统的任何地方都可以 vagrant up 开启 Homestead 虚拟机，你可以把以下代码放到你的 Bash profile 里面，这个函数允许你在文件系统的任何位置都可以对 Homestead 运行 Vagrant 命令：

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

请确定 ~/Homestead 这个路径跟你的实际 Homestead 的安装路径一致，一旦这个函数安装成功，你即可自由的在任何文件系统位置中使用 homestead up 和 homestead ssh。

通过 SSH 连接

在 Homestead 目录运行 vagrant ssh 命令来连接虚拟主机。

你可能会经常需要使用 SSH 来连接 Homestead 主机，建议你可以在本机电脑上创建一个「别名」以便快速连接 Homestead box。

连接数据库

在 Homestead 中，已经预装了 MySQL 与 Postgres 两种数据库。为了方便使用，Laravel 在 .env 的默认数据库设置中已经将其设置好了。

如果想要从本机电脑上通过 Navicat 或者是 Sequel Pro 来连接数据库，可以通过 127.0.0.1 来使用端口 33060 (MySQL) 或 54320 (Postgres) 连接。帐号密码分别是 homestead / secret。

备注

因为虚拟机做了端口转发，所以本机电脑上你应当只使用这些非标准的连接端口，虚拟机里依然使用默认的 3306 及 5432 连接端口。

增加更多网站

一旦 Homestead 环境配置完毕且成功运行后，你可能会想要为 Laravel 应用程序增加更多的 Nginx 网站。你可以在单个 Homestead 环境中运行多个 Laravel 程序。在 Homestead.yaml 文件中增加另一个网站的设置后，进入 Homestead 目录并运行 vagrant provision 命令，即可新增一个网站。

配置 Cron 调度器

Laravel 提供了便利的方式来调度 Cron 任务，通过 schedule:run Artisan 命令，调度便会在每分钟被运行。schedule:run 命令会检查定义在你 App\Console\Kernel 类中调度的任务，判断哪个任务该被运行。

如果你想为 Homestead 网站使用 schedule:run 命令，你可以在定义网站时将 schedule 选项设置为 true：

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

该网站的 Cron 任务会被定义在虚拟机的 /etc/cron.d 文件夹中。

连接端口

以下本地电脑连接端口将会被转发至 Homestead 环境：

**SSH：**2222 → 转发至 22
**HTTP：**8000 → 转发至 80
**HTTPS：**44300 → 转发至 443
**MySQL：**33060 → 转发至 3306
**Postgres：**54320 → 转发至 5432

转发更多连接端口

如果你需要的话，也可以借助指定连接端口的通信协议来转发更多额外的连接端口给 Vagrant box：

ports:
    - send: 93000
      to: 9300
    - send: 7777
      to: 777
      protocol: udp

网络接口

Homestead.yaml 文件里的 networks 配置项允许你为 Homestead 环境配置网络接口。你可以任意配置多个网络接口：

networks:
    - type: "private_network"
      ip: "192.168.10.20"

想要配置一个桥接接口的话，增加 bridge 配置项，然后 type 填写为 public_network：

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"

想要配置一个 DHCP, 接口的话，请从配置中移除 ip选项：

networks:
    - type: "public_network"
      bridge: "en1: Wi-Fi (AirPort)"

备注

欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。

转载请注明：本文档由 Laravel China 社区 [laravel-china.org] 组织翻译，详见翻译召集帖。

文档永久地址： http://d.laravel-china.org

简介​

内置软件​

安装与设置​

第一步​

安装 Homestead Vagrant box​

安装 Homestead​

配置 Homestead​

配置你的提供者​

配置共享文件夹​

配置 Nginx 网站​

关于 Hosts 文件​

启动 Vagrant box​

根据项目分开安装​

安装 MariaDB​

常见用法​

全局使用​

通过 SSH 连接​

连接数据库​

增加更多网站​

配置 Cron 调度器​

连接端口​

转发更多连接端口​

网络接口​

简介