LaravelValet基于PHP构建极速Mac本地开发环境【便捷】-php教程-PHP中文网

valet访问404是因为只响应.test域名且项目必须在valet park指定的根目录（如~/sites）下直接子目录，而非桌面或嵌套路径；需运行valet parked确认注册、用myapp.test访问、避免localhost端口，并注意dns缓存与php版本切换后扩展重装。

laravelvalet基于php构建极速mac本地开发环境【便捷】

不是 Valet 没跑起来，而是它默认只响应 *.test 域名，且项目目录必须在 ~/Sites（或你用 valet park 指定的根目录）下。常见错误是把项目放在桌面、Downloads 或任意子目录——Valet 不会递归扫描，只认“park 目录下的直接子目录”作为站点。

确认项目路径：运行 valet parked，看输出里有没有你的项目名（即目录名）
如果没出现，cd 到父目录（比如 ~/Sites），执行 valet park；再 cd 进项目目录，确保它只是 ~/Sites/myapp，而非 ~/Sites/projects/myapp
域名必须用 myapp.test，不能用 localhost:8000 或 127.0.0.1 —— Valet 是 DNS+HTTPS 代理，不走传统端口绑定
Mac 系统升级后偶尔 DNS 缓存异常，可试 sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder

Valet 自带 PHP 管理（valet use php@8.2），但它只改 CLI 和 FPM 的二进制链接，不自动重装扩展。比如你从 PHP 8.1 切到 8.2，pdo_mysql、redis 这些扩展还在旧版本里编译过，新 PHP 找不到。

切版本后务必执行 valet install —— 它会重新配置 PHP-FPM、重载 Nginx，并触发扩展重编译（前提是 Homebrew 已安装对应版本的扩展包，如 php@8.2-redis）
检查扩展是否启用：php -m | grep redis（CLI）和 php-fpm -m | grep redis（FPM），两者结果应一致
Homebrew 安装扩展时注意命名：PHP 8.2 对应 php@8.2-redis，不是 php-redis；漏掉版本号会导致装错位置

Valet 每次运行 valet install 或 valet restart 都会重写 /usr/local/etc/nginx/valet/valet.conf 和站点 conf 文件，手动改过的配置会被清空。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

不要直接编辑 valet.conf，改 ~/.valet/Nginx/ 下的同名文件（如 myapp.test），Valet 重启时会优先读这里
想全局加 header 或 rewrite，把规则写进 ~/.valet/Nginx/localhost（它会被包含进主配置）
修改后必须 valet restart，仅 brew services restart nginx 不生效 —— Valet 管理的是自己编译的 Nginx 实例，不是 Homebrew 默认的

Valet 只管 Web 服务（PHP+Nginx），MySQL、PostgreSQL、Redis 都得自己装、自己启。很多人以为 valet install 会配好全套，结果 Laravel DB_CONNECTION=mysql 报 Connection refused。

用 Homebrew 装 MySQL：brew install mysql，然后 brew services start mysql
首次启动后需初始化 root 密码：mysql_secure_installation，否则 Laravel 连接时提示 access denied
Laravel 的 .env 里 DB_HOST=127.0.0.1（不是 localhost），因为 macOS 上 localhost 会走 socket，而 Homebrew MySQL 默认监听 TCP
如果要用 localhost，得在 MySQL 配置里加 bind-address = 127.0.0.1 并确保 skip-networking 关闭