Laravel Valet
1、简介
Valet是为Mac提供的极简主义开发环境,没有Vagrant、Apache、Nginx,也没有/etc/hosts
文件,甚至可以使用本地隧道公开共享你的站点。
在你启动Mac后,Laravel Valet会在后台静默运行Caddy,然后通过使用DnsMasq,Valet将所有请求代理到*.dev
域名并指向本地安装的站点目录。这样一个极速的Laravel开发环境只需要占用7M内存。
Valet并不是想要替代Vagrant或者Homestead,只是提供了另外一种选择,更加灵活、极速、以及占用更小的内存空间。
Valet为我们支持但不限于以下软件和工具:
当然,你还可以通过自定义驱动扩展Valet。Valet Or 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开发环境的好帮手,选择使用哪一个取决于你个人的喜好或团队的需求。
2、安装
Valet要求Mac操作系统和Homebrew。安装之前,需要确保没有其他程序如Apache或Nginx绑定到本地的80端口。安装步骤如下:
- 使用
brew update
安装或更新Homebrew到最新版本 - 通过运行
brew services list
确保brew services
有效并且能获取到正确的输出,如果无效,则需要添加。 - 通过Homebrew安装PHP 7.0:
brew install homebrew/php/php70
。 - 通过Composer安装Valet:
composer global require laravel/valet
(确保~/.composer/vendor/bin
在系统路径中) - 运行
valet install
命令,这将会配置并安装Valet和DnsMasq,然后注册Valet后台随机启动。
安装完Valet后,尝试使用命令如 ping foobar.dev
在终端ping一下任意*.dev
域名,如果Valet安装正确就会看到来自127.0.0.1
的响应:
PING foobar.dev (127.0.0.1): 56 data bytes 64 bytes from 127.0.0.1: icmp_seq=0 ttl=64 time=0.069 ms 64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.077 ms 64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.072 ms 64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.082 ms
每次系统启动的时候Valet后台会自动启动,而不需要再次手动运行valet start
或valet install
。
使用其他域名
默认情况下,Valet使用.dev域名后缀,如果你想要使用其他域名,可以使用 valet domain tld-name 命令。例如,你想使用.app域名后缀取代.dev,运行 valet domain app ,Valet将会自动将站点域名后缀改为*.app。
数据库
如果你需要数据库,可以在命令行通过 brew install mariadb
安装MariaDB,安装完成后就可以在本机通过用户名root
和一个空密码连接到数据库。
3、服务站点
Valet安装完成后,就可以启动服务站点,Valet为此提供了两个命令:park
和link
park命令
- 在Mac中创建一个新目录,例如
mkdir ~/Sites
,然后进入这个目录并运行valet park
。这个命令会将当前所在目录作为web根目录。 - 接下来,在新建的目录中创建一个新的Laravel站点:
laravel new blog
。 - 在浏览器中访问
http://blog.dev
。
页面截图如下:
这就是我们要做的全部工作。现在,所有在Sites
目录中创建的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协议,如果你想要使用HTTP/2通过加密的TLS为站点提供服务,可以使用 secure
命令。例如,如果你的站点域名是 laravel.dev
,可以使用如下命令:
valet secure laravel
要回到原生HTTP,使用 unsecure
命令。和 secure
命令一样,该命令接收主机名作为参数:
valet unsecure laravel
4、分享站点
Valet还提供了一个命令用于将本地站点共享给其他人,这不需要任何额外工具即可实现。
要共享站点,切换到站点所在目录并运行 valet share
,这会生成一个可以公开访问的URL并插入剪贴板,以便你直接复制到浏览器地址栏,就是这么简单。
要停止共享站点,使用 Control + C
即可。
5、查看日志
如果你想要在终端显示所有站点的日志,可以运行valet logs
命令,这会在终端显示新的日志。
6、自定义Valet驱动
你还可以编写自定义的Valet驱动为运行于非Valet原生支持的PHP应用提供服务。安装完Valet时会创建一个~/.valet/Drivers
目录,该目录中有一个 SampleValetDriver.php
文件,这个文件中有一个演示如何编写自定义驱动的示例。编写一个驱动只需要实现三个方法:serves
、isStaticFile
和frontControllerPath
。
这三个方法接收$sitePath
、$siteName
和$uri
值作为参数,其中$sitePath
表示站点目录,如/Users/Lisa/Sites/my-project
,$siteName
表示主域名部分,如my-project
,而$uri
则是输入的请求地址,如/foo/bar。
编写好自定义的Valet驱动后,将其放到 ~/.valet/Drivers
目录并遵循 FrameworkValetDriver.php
这种命名方式,举个例子,如果你是在为Wordpress编写自定义的valet驱动,对应的文件名称为 WordPressValetDriver.php
。
下面我们来具体讨论并演示自定义Valet驱动需要实现的三个方法。
serves方法
如果自定义驱动需要继续处理输入请求,serves
方法会返回true
,否则该方法返回false
。因此,在这个方法中应该判断给定的 $sitePath
是否包含你服务类型的项目。
例如,假设我们编写的是WordPressValetDriver
,那么对应serves
方法如下:
/** * Determine if the driver serves the request. * * @param string $sitePath * @param string $siteName * @param string $uri * @return void * @translator laravelacademy.org */ public function serves($sitePath, $siteName, $uri) { return is_dir($sitePath.'/wp-admin'); }
isStaticFile方法
isStaticFile
方法会判断输入请求是否是静态文件,例如图片或样式文件,如果文件是静态的,该方法会返回磁盘上的完整路径,如果输入请求不是请求静态文件,则返回false
:
/** * Determine if the incoming request is for a static file. * * @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; }
注:isStaticFile
方法只有在serves
方法返回true
并且请求URI不是/
的时候才会被调用。
frontControllerPath方法
frontControllerPath
方法会返回前端控制器的完整路径,通常是index.php
:
/** * Get the fully resolved path to the application's front controller. * * @param string $sitePath * @param string $siteName * @param string $uri * @return string */ public function frontControllerPath($sitePath, $siteName, $uri) { return $sitePath.'/public/index.php'; }
7、其他Valet命令
命令 | 描述 |
---|---|
valet forget |
从”parked”目录运行该命令以便从parked目录列表中移除该目录 |
valet paths |
查看你的”parked”路径 |
valet restart |
重启Valet |
valet start |
启动Valet |
valet stop |
关闭Valet |
valet uninstall |
卸载Valet |
9 Comments