Laravel Valet

• 简介
  • 选择 Valet 还是 Homestead
• 安装
  • 升级
• 服务站点
  • 「Park」 命令
  • 「Link」命令
  • 使用 TLS 构建完全站点
• 分享站点
• 查看日志
• 自定义 Valet 驱动
• 其他 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 为我们提供以下软件和工具支持，然而不仅限于此：

当然，你还可以通过 自定义驱动 来扩展 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 端口。 安装步骤如下：

一旦完成 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 命令

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

link 命令

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

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

使用 TLS 构建完全站点

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

valet secure laravel

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

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 方法如下：

/**
 * 判断驱动服务请求。
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return void
 */
public function serves($sitePath, $siteName, $uri)
{
    return is_dir($sitePath.'/wp-admin');
}

isStaticFile 方法

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

/**
 * 判断请求内容是否是静态文件。
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return string|false
 */
public function isStaticFile($sitePath, $siteName, $uri)
{
    if (file_exists($staticFilePath = $sitePath.'/public/'.$uri)) {
        return $staticFilePath;
    }

    return false;
}

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

frontControllerPath 方法

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

/**
 * 获取应用前端控制器绝对路径。
 *
 * @param  string  $sitePath
 * @param  string  $siteName
 * @param  string  $uri
 * @return string
 */
public function frontControllerPath($sitePath, $siteName, $uri)
{
    return $sitePath.'/public/index.php';
}

其他 Valet 命令

译者署名

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

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

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

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