LaravelValet环境搭建教程_php配置指南

今天golang学习网给大家带来了《Laravel Valet建环境教程_php环境搭建》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

Laravel Valet 仅支持 macOS，通过 dnsmasq + nginx 实现轻量本地开发，需 Homebrew 管理 PHP（≥8.1），valet park 后须确保项目含 server.php 或 public/index.php，切换 PHP 版本需 brew unlink/link 配合 valet use。

用 Laravel Valet 搭建 PHP 开发环境，只适合 macOS 且本地开发场景；它不是 Docker，也不跑 Apache/Nginx 全量服务，而是靠 dnsmasq + nginx 轻量代理，把每个项目目录直接变成 http://xxx.test。

Valet 只支持 macOS，Windows/Linux 用户别折腾

Valet 依赖 macOS 的 launchd、dnsmasq 和系统级网络配置，官方明确不支持 Windows 或 Linux。想在非 macOS 上获得类似体验，得换方案：docker-compose + nginx 配置，或用 php -S 临时跑单项目——但那就不是 Valet 了。

• 装之前先确认系统：运行 sw_vers 看是否输出 ProductName: macOS
• Homebrew 必须已安装，Valet 通过它装 nginx、php、dnsmasq
• 别用 sudo pecl 或手动编译 PHP —— Valet 要求 PHP 由 Homebrew 管理，版本需 ≥ 8.1（Laravel 10+ 推荐）

装完 valet park 后访问 404？检查这三处

valet park 是核心命令，但它只是告诉 Valet “这个文件夹里的所有子目录都可被路由”，并不自动启用 PHP 或写配置。常见 404 多因路径、权限或 PHP 模块缺失。

• 确保当前目录是父级工作区，比如 ~/Sites，执行 valet park 后，~/Sites/myapp 才能响应 http://myapp.test
• PHP 需启用 opcache 和 mbstring：运行 php -m | grep -E '^(opcache|mbstring)$'，缺哪个就 brew reinstall php 再试
• 如果项目根目录没有 server.php（Laravel 默认有），Valet 会 fallback 到静态文件逻辑，导致 Laravel 路由不生效 —— 此时访问 / 返回 404 是正常现象，要确保 public/ 是 Web 根，且 index.php 存在

valet use php@8.2 不生效？别跳过 brew unlink

Valet 切换 PHP 版本本质是让 Homebrew 切换 symlink，但旧版 PHP 可能仍被系统缓存或未完全卸载。

brew unlink php@8.1
brew install php@8.2
brew link --force php@8.2
valet use php@8.2

漏掉 brew unlink 或没加 --force，会导致 valet use 显示成功，但 php -v 仍是旧版。验证方式不是看 Valet 输出，而是直接跑：

• which php 应返回 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel）
• php -v 和 valet status 里显示的 PHP 版本必须一致
• Laravel 项目中 phpinfo() 页面也要匹配，否则 .env 里 APP_DEBUG=true 报错可能被误判为框架问题

Valet 的“便捷”建立在约定之上：目录结构、PHP 管理方式、DNS 解析逻辑都不可绕过。一旦项目需要多 PHP 版本共存、HTTPS 自签名以外的证书、或跨团队统一环境，它反而比写几行 docker-compose.yml 更难维护。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~