Valet是专为Mac系统设计的轻量级PHP开发环境,无需配置Nginx或Apache,就能快速搭建本地开发服务,特别适合Laravel项目开发。它占用系统资源少,启动速度快,是很多PHP开发者的首选本地环境工具。

Valet配置前提条件
在安装配置Valet之前,需要确认系统满足以下要求:
- 系统是macOS系统,版本建议在10.13及以上
- 已经安装Homebrew包管理工具
- 已经安装PHP 7.4及以上版本,且PHP已加入系统环境变量
- 已经安装Composer依赖管理工具
Valet基础安装与配置步骤
1. 安装Valet
首先通过Composer全局安装Valet,执行以下命令:
composer global require laravel/valet
安装完成后,需要将Composer的全局bin目录添加到系统PATH中,执行以下命令:
export PATH="$HOME/.composer/vendor/bin:$PATH"
如果是zsh终端,可以将上述命令添加到~/.zshrc文件中,bash终端则添加到~/.bash_profile文件中,之后执行source命令让配置生效。
2. 初始化Valet
执行以下命令初始化Valet,会自动配置DNS解析和本地服务:
valet install
初始化完成后,Valet会默认将~/.config/valet目录作为配置目录,同时会启动后台服务。
3. 配置站点目录
进入你存放Laravel项目的目录,执行valet park命令,Valet会自动将该目录下的所有子目录识别为站点,访问时直接使用子目录名加.test后缀即可。例如项目目录是~/sites,其中有一个blog项目,那么访问地址就是http://blog.test。
如果只想将单个项目加入Valet管理,可以进入项目目录执行valet link 项目别名,例如:
cd ~/sites/blog valet link myblog
之后就可以通过http://myblog.test访问该项目。
Laravel项目专属配置技巧
1. 配置Nginx伪静态规则
Laravel项目需要伪静态支持,Valet默认已经内置了Laravel的伪静态规则,如果遇到路由无法访问的问题,可以执行以下命令重新生成配置:
valet restart
2. 配置HTTPS访问
Valet支持为站点配置HTTPS,执行以下命令即可为指定站点开启HTTPS:
valet secure myblog
如果要关闭HTTPS,执行:
valet unsecure myblog
3. 配置PHP版本切换
如果不同Laravel项目需要不同的PHP版本,可以执行以下命令切换当前目录使用的PHP版本:
valet use php@8.1
也可以为单个项目指定PHP版本,在项目根目录创建.valetrc文件,内容如下:
php=php@8.1
4. 配置数据库链接
Laravel项目的.env文件中,数据库配置可以按照以下方式设置,Valet默认使用MySQL的话,配置示例如下:
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=blog_db DB_USERNAME=root DB_PASSWORD=
常见问题与解决方法
| 问题描述 | 解决方法 |
|---|---|
| 访问站点提示404 | 检查是否执行了valet park或valet link,确认站点目录正确,执行valet restart重启服务 |
| PHP命令无法识别 | 检查PHP是否安装,确认PHP路径已加入系统PATH,执行php -v验证 |
| 站点无法使用HTTPS | 执行valet secure 站点别名重新生成证书,或者检查证书是否过期 |
实用优化技巧
- 使用
valet logs命令可以查看Valet的运行日志,方便排查问题 - 使用
valet share命令可以将本地站点临时分享到公网,方便测试回调接口 - 定期执行
valet update更新Valet到最新版本,获取新功能和bug修复 - 如果不需要某个站点,进入目录执行
valet unlink 项目别名即可移除