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。
正如你所知道的, 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
。
这就是我们要做的全部工作 现在,所有在 Site 目录中的 Laravel 项目都可以通过 http://folder-name.dev
这种方式访问,是不是很方便。
link
命令可以可以用于你的本地 Laravel 站点。这个命令在你想要在目录中提供单个站点是很有用。
要查看所有的链接目录,运行 valet links
命令。你也可以通过 valet unlink app-name
来删除符号链接。
默认的, 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 「驱动」运行非原生支持的其他 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
方法应该返回 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
应该判断进入的请求是否是静态文件,例如图片或者样式文件,如果文件是静态的,该方法会返回磁盘上的绝对路径,否则返回 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
方法应该返回「前端控制器」的绝对路径,通常是你的 「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 forget |
在某个站点根路径运行该命令可在根目录列表中移除该目录 |
valet paths |
查看所有站点根路径 |
valet restart |
重启. |
valet start |
启动. |
valet stop |
停止. |
valet uninstall |
卸载. |
用户名 | 头像 | 职能 | 签名 |
---|---|---|---|
@麦索 | 翻译 | 程序界的小学生,目前生活在北京,希望能够多结交大牛。Follow me @dongm2ez at Github |