Laravel Valet

简介

Valet 是一个专为 Mac 提供的极简主义开发环境，不需要 Vagrant，Apache，Nginx，也不需要 /etc/hosts 文件。你还可以通过本地隧道分享你的站点。Yeah, we like it too.

在 Mac 中，Laravel Valet 总是在后台运行 Caddy Web 服务器，然后通过 DnsMasq DNS转发器，Valet 将所有请求代理到你本地机器的 *.dev 域名站点。

换句话说，一个速度极快的 Laravel 开发环境仅仅需要占用 7MB 内存。 Valet 并不是想要替代 Vagrant 或者 Homestead，只是提供另外一种选择，更加灵活、方便、以及占用更小的内存。

开箱即用，Valet 为我们提供以下软件和工具支持，然而不仅限于此：


- Laravel
- Lumen
- Symfony
- Zend
- CakePHP 3
- WordPress
- Bedrock
- Craft
- Statamic
- Jigsaw
- Static HTML

当然，你还可以通过 自定义驱动 来扩展 Valet。

选择 Valet 还是 Homestead

正如你所知道的， Laravel 提供另外一个开发环境 Homestead 。 Homestead 和 Valet 不同之处在于两者的目标受众和本地开发方式。 Homestead 提供一个完整的包含自动化配置 Nginx 的 Ubuntu 虚拟机。如果你需要一个完整的虚拟化 Linux 开发环境或者是使用 Windows / Linux 操作系统，那么 Homestead 无疑是最佳选择。

Valet 只支持 Mac，并且要求本地安装 PHP 和数据库服务器，这可以通过使用 Homebrew 命令 brew install php70 和 brew install mariadb 轻松实现。Valet通过最小的资源消耗提供一个本地极速开发环境，如果你只需要 PHP / MySQL 而不是完整的虚拟化开发环境，那么 Valet 将是最好的选择。

Valet 和 Homestead 都是配置你本地 Laravel 开发环境的好帮手。选择使用哪一个取决于你的个人喜好和团队需求。

安装

Valet 要求 mac 操作系统和 Homebrew。安装之前，你需要确保没有其他程序如 Apache 或者 Nginx 占用你本地机器的 80 端口。 安装步骤如下：


- 安装或者更新 Homebrew 到最新版本，使用命令 brew update 。
- 使用 brew install homebrew/php/php70 命令安装 PHP 7.0 。
- 通过 Composer 安装 Valet 命令为 composer global require laravel/valet。 请确保 ~/.composer/vendor/bin 目录在系统环境变量 「PATH」 中。
- 运行 valet install 命令。 这将会配置并安装 Valet 和 DnsMasq，并注册 Valet 随你的系统启动。

一旦完成 Valet 安装，试着使用命令如 ping foobar.dev 在终端 ping 一些任意的*.dev 域名。如果 Valet 安装正确你会看到来自 127.0.0.1 的响应。

Valet 将会在每次系统启动时自动启动，而不需要你每次运行 valet start 或 valet install。

使用其他顶级域名

默认的，Valet 使用 .dev 顶级域名。如果你喜欢其他域名，可以使用 valet domain tld-name 命令。

例如，如果你想使用 .app 来替换 .dev，运行 valet domain app 然后 Valet 将会自动的使用 *.app 来为你的项目提供服务。

数据库

如果你需要一个数据库，可以使用 brew install mariadb 命令试一试 MariaDB 。你可以使用 host 为 127.0.0.1 ，用户名 root ， 密码为空进行数据库连接。

升级

你可以使用 composer global update 命令升级你的 Valet 程序，升级之后，最好使用 valet install 命令更新 Valet 的配置文件。

服务站点

一旦完成 Valet 安装，你就可以启动服务站点，Valet 提供两个命令帮助你启动你的 Laravel 站点： park 和 link。


park 命令


- 在你的 Mac 中创建一个新目录，例如 mkdir ~/Sites ，然后，使用 cd ~/Sites 并运行 valet park。这个命令将会将当前所在目录作为 Web 根目录， Valet 将会在这个目录中搜索站点。
- 接下来，在这个目录中创建一个新的 Laravel 站点：laravel new blog。
- 在浏览器中访问 http://blog.dev 。

这就是我们要做的全部工作 现在，所有在 Site 目录中的 Laravel 项目都可以通过 http://folder-name.dev 这种方式访问，是不是很方便。


link 命令

link 命令~可以~可以用于你的本地 Laravel 站点。这个命令在你想要在目录中提供单个站点是很有用。


- 要使用这个命令，在你的终端中切换到你的某个项目并运行 valet link app-name。 Valet 将会在 ~/.valet/Sites 中创建一个符号链接并指向当前工作目录。
- 运行完 link 命令, 你可以在浏览器中通过 http://app-name.dev 来访问站点。

要查看所有的链接目录，运行 valet links 命令。你也可以通过 valet unlink app-name 来删除符号链接。


使用 TLS 构建完全站点

默认的, Valet 提供简单的 HTTP Web 服务。然而，如果你想利用 HTTP/2 提供加密的 TLS ，你可以使用 secure 命令。例如，你有一个站点 laravel.dev ，可以使用以下命令让其更安全：

  1. valet secure laravel

想恢复一个站点到普通的 HTTP 使用 unsecure 命令，这个命令可以去除 secure 增加的安全加密:

  1. valet unsecure laravel

分享站点

Valet 还提供一个命令将本地站点分享给其他人，这不需要任何额外安装软件即可实现。

要分享站点，在你的终端中切换到站点目录使用 valet share 命令。这会生成一个可以公开访问的 URL 并插入你的剪切板，以便你直接粘贴到浏览器，就是这么简单。

要停止分享站点，使用 Control + C 快捷组合键即可。

查看日志

如果你想要实时地在终端显示所有站点的日志，运行 valet logs 命令，这会在终端显示新产生的日志。

自定义 Valet 驱动

你可以编写自定义的 Valet 「驱动」运行非原生支持的其他 PHP 框架或 CMS 。安装完 Valet 时会创建一个 ~/.valet/Drivers 目录，该目录中有一个 SampleValetDriver.php 文件。这个文件中简单演示如何编写自定义驱动。 编写驱动只需要实现三个方法： serves，isStaticFile 和 frontControllerPath。

这三个方法都接收 $sitePath ，$siteName 和 $uri 作为参数。$sitePath 表示站点的绝对路径，例如 /Users/Lisa/Sites/my-project 。 $siteName 表示站点的 “host” / “站点名称” 部分，如 (my-project) 。 $uri 则是输入的请求 URI，如 (/foo/bar) 。

编写好你的自定义 Valet 驱动，将其放到 ~/.valet/Drivers 目录并遵循 FrameworkValetDriver.php 这种命名规范。例如，如果编写一个自定义的 WordPress 驱动，对应的文件名称应是 WordPressValetDriver.php 。

下面我们来具体讨论并演示自定义 Valet 驱动需要实现的三个方法。

serves 方法

如果自定义驱动要继续处理进入请求， serves 方法应该返回 true ， 否则该方法返回 false 。 因此，这个方法应该判断给定的 $sitePath 是否是包含你服务项目的类型。

例如，假设我们编写的是 WordPressValetDriver。那么对应的 serves 方法如下：

  1. /**
  2.  * 判断驱动服务请求。
  3.  *
  4.  * @param  string  $sitePath
  5.  * @param  string  $siteName
  6.  * @param  string  $uri
  7.  * @return void
  8.  */
  9. public function serves($sitePath, $siteName, $uri)
  10. {
  11.     return is_dir($sitePath.'/wp-admin');
  12. }

isStaticFile 方法

isStaticFile 应该判断进入的请求是否是静态文件，例如图片或者样式文件，如果文件是静态的，该方法会返回磁盘上的绝对路径，否则返回 false:

  1. /**
  2.  * 判断请求内容是否是静态文件。
  3.  *
  4.  * @param  string  $sitePath
  5.  * @param  string  $siteName
  6.  * @param  string  $uri
  7.  * @return string|false
  8.  */
  9. public function isStaticFile($sitePath, $siteName, $uri)
  10. {
  11.     if (file_exists($staticFilePath = $sitePath.'/public/'.$uri)) {
  12.         return $staticFilePath;
  13.     }
  15.     return false;
  16. }

{note} isStaticFile 方法只有在 serves 方法返回 true 并且请求 URI 不是 / 才会被调用。

frontControllerPath 方法

frontControllerPath 方法应该返回「前端控制器」的绝对路径，通常是你的 「index.php」文件:

  1. /**
  2.  * 获取应用前端控制器绝对路径。
  3.  *
  4.  * @param  string  $sitePath
  5.  * @param  string  $siteName
  6.  * @param  string  $uri
  7.  * @return string
  8.  */
  9. public function frontControllerPath($sitePath, $siteName, $uri)
  10. {
  11.     return $sitePath.'/public/index.php';
  12. }

其他 Valet 命令

命令 描述
valet forget 在某个站点根路径运行该命令可在根目录列表中移除该目录
valet paths 查看所有站点根路径
valet restart 重启.
valet start 启动.
valet stop 停止.
valet uninstall 卸载.

译者署名

用户名 头像 职能 签名
@麦索 Valet - 图1 翻译 程序界的小学生，目前生活在北京，希望能够多结交大牛。Follow me @dongm2ez at Github

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

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

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