跳到主要内容
版本：4.2

Laravel Homestead

介绍​

Laravel 致力于让 PHP 开发体验更愉快，也包含您的本地开发环境。vagrant 一个简单、优雅的方式来管理与供应虚拟机器。

Laravel Homestead 是一个官方预载的 Vagrant “封装包”，提供您一个完美的开发环境，不需要您在您的本机端安装 PHP、HHVM，网页服务器或任何服务器软件。不用担心搞乱您的系统！Vagrant 封装包完全搞定。如果有什么地方损坏了，您只要删掉重来即可。

Homestead 可以在任何 Windows, Mac 或 Linux 上面运行，里面包含了 Nginx 网页服务器、PHP 5.6、MySQL、Postgres、Redis、Memcached 还有所有您开发 Laravel 应用程序所需的软件。

注意

如果你使用的是 Windows，你可能需要开启硬件虚拟化 (VT-x)。通常可以在 BIOS 中开启。

Homestead 创建且测试于 Vagrant 1.6 上。

内建软件​

  • Ubuntu 14.04
  • PHP 5.6
  • HHVM
  • Nginx
  • MySQL
  • Postgres
  • Node (With Bower, Grunt, and Gulp)
  • Redis
  • Memcached
  • Beanstalkd
  • Laravel Envoy
  • Fabric + HipChat Extension

安装与设定​

安装 VirtualBox 与 Vagrant​

在启动您的 Homestead 环境之前，您必须先安装 VirtualBox 和 Vagrant. 两套软件在各平台都有提供易用的视觉化安装软件。

增加 Vagrant 封装包​

当 VirtualBox 和 Vagrant 安装完成后，您需要在终端机执行以下列命令将 'laravel/homestead' 封装包安装进您的 Vagrant 安装软件中。下载封装包会根据您的网速速度花费一点时间：

vagrant box add laravel/homestead

如果这个命令失败了, 你可能安装的是一个老版本的 Vagrant 需要指定一个完整的 URL：

vagrant box add laravel/homestead https://atlas.hashicorp.com/laravel/boxes/homestead

安装 Homestead​

使用 Composer + PHP 工具​

一旦封装包已经被加进您的 Vagrant 后，您就可以通过 composer 的 global 命令来安装 Homestead 命令行工具：

composer global require "laravel/homestead=~2.0"

确保 ~/.composer/vendor/bin 目录已经写入 PATH 变量， 这样才可以在命令行下全局执行 homestead 命令。

当您安装完 Homestead 的 命令行工具后, 可以通过使用 init 命令来创建 Homestead.yaml 配置文件。

homestead init

将会在 ~/.homestead 目录中生成 Homestead.yaml 配置文件。如果你使用 Mac 或者 Linux 系统，你可以通过在命令行运行 homestead edit 命令来编辑 Homestead.yaml 文件。

homestead edit

手动通过 Git (没有本地 PHP 环境)​

如果你不想在本地机器上安装 PHP，你可以通过手动克隆仓库的方式来安装 Homestead。想象把克隆的仓库放到一个 Homestead 文件夹下，里面存放了你所有的 Laravel 项目，Homestead box 会把它当做你所有的 Laravel （或者 PHP）项目的文档根目录：

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

当您安装完 Homestead 的 命令行工具后, 可以通过使用 bash init.sh 命令来创建 Homestead.yaml 配置文件：

bash init.sh

将会在 ~/.homestead 目录中生成 Homestead.yaml 配置文件。

设定您的 SSH 密钥​

接下来，您需要编辑下 Homestead.yaml 文件。您可以在文件中设定您的 SSH 公开密钥，以及您主要机器与 Homestead 虚拟机器之间的共享目录。

如果没有 SSH 密钥 在 Mac 和 Linux 平台下，您可以利用下面的命令来创建一个 SSH 密钥:

ssh-keygen -t rsa -C "you@homestead"

在 Windows 下，您需要安装 Git 并且使用包含在 Git 里的 Git Bash 来执行上述的命令。另外您也可以使用 PuTTY 和 PuTTYgen。

一旦您创建了一个 SSH 密钥，记得在您的 Homestead.yaml 文件中的 authorize 属性指明密钥路径。

设定您的共享文件夹​

Homestead.yaml 文件中的 folders 属性列出所有您想跟您的 Homestead 环境共享的文件夹列表。这些文件夹中的文件若有更动，他们将会同步在您的本机与 Homestead 环境里。您可以将您需要的共享文件夹都设定进去。

设定您的 Nginx 站点​

对 Nginx 不熟悉? 没关系。sites 属性允许您简单的将一个 域名 对应到一个您在 homestead 环境中的目录。在 Homestead.yaml 文件中有默认一个简单的站点配置样例提您参考。同样的，您可以添加任何您需要的站点到您的 Homestead 环境中。Homestead 可以作为您开发项目时的一个方便的虚拟化环境。

如果你的 Homestead 站点要使用 HHVM 只需将 hhvm 选项设置为 true：

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

Bash Aliases​

如果要增加 Bash aliases 到您的 Homestead 封装包中，只要加到 ~/.homestead 目录根目录下的 aliases 文件中。

启动 Vagrant 封装包​

当您根据您的情况编辑完 Homestead.yaml 后，在终端机里，从命令行执行 homestead up 命令。如果你是手动安装的 Homestead 并且没有使用 PHP 的 homestead 工具，进入包含克隆了 Homestead 的 Git 目录中执行 vagrant up。

Vagrant 将会开启虚拟机，并且自动设定您的共享目录和 Nginx 站点。如果要删除虚拟机, 您可以使用 homestead destroy 命令，通过执行 homestead list， 您可以获取到完整的 homestead 命令列表。

为了能访问您的 Nginx 站点，别忘记在本机的 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

继续读下去，您会学到如何链接到您的数据库。

日常使用​

通过 SSH 连接​

要通过 SSH 连接您的 Homestead 环境，在命令行执行 homestead ssh 即可。

连接您的数据库​

在 Homestead 封装包中，MySQL 与 Postgres 两套数据库都已预装其中。为了更简便，Laravel 的 local 环境下的数据库配置已经默认设置为 homestead 。

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

提示

您应该使用这些非标准的端口从外部来链接到虚拟机里的数据库, 而在虚拟机里面使用默认的端口连接本地的服务, 如 3306 and 5432 .

增加更多的站点​

一旦您的 Homestead 环境上架且运行后，您可能会需要为您的 Laravel 应用程序增加够多的 Nginx 站点。您可以在一台 Homestead 环境中运行非常多 Laravel 安装软件。可以通过如下两个方式：第一，可以在您的 Homestead.yaml 文件中增加站点然后执行 vagrant provision。

另外，您也可以使用放在您的 Homestead 环境中的 serve 命令。您需要 SSH 进入您的 Homestead 环境中，并执行下列命令：

serve domain.app /home/vagrant/Code/path/to/public/directory
提示

在执行 serve 命令过后，别忘记将新的站点加进您本机的 hosts 文件中。

连接端口​

以下的本地端口将会被重定向跳转至您的 Homestead 环境：

  • SSH: 2222 -> Forwards To 22
  • HTTP: 8000 -> Forwards To 80
  • MySQL: 33060 -> Forwards To 3306
  • Postgres: 54320 -> Forwards To 5432