Laravel 10在phpEnv中部署必须手动配置：1. root指向public目录；2. location /中用try_files $uri $uri/ /index.php?$query_string；3. PHP区块追加fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name等三行；4. APP_URL须与访问域名完全一致。
phpEnv 下部署 Laravel 10 必须手动配置伪静态，它不自动识别 Laravel 框架，也不会帮你改 root 或加 try_files —— 直接套用 Apache 的 .htaccess 或宝塔“Laravel 5”模板会失效。
phpEnv 的 Nginx 配置必须指向 public 目录
phpEnv 默认新建站点时 root 指向的是项目根目录（如 D:\phpenv\www\myapp），但 Laravel 10 入口是 public/index.php。若不改，所有请求都找不到 index.php，直接 404 或下载 PHP 文件。
- 打开 phpEnv 控制面板 → 网站管理 → 找到你的站点 → 点击“设置”
- 在“网站目录”中，把根目录从
D:\phpenv\www\myapp改为D:\phpenv\www\myapp\public - 保存后点击“重载 Nginx”，不重启服务也能生效
- 验证：访问
http://localhost应显示 Laravel 欢迎页；若提示 “No input file specified”，说明 root 还没切对
伪静态规则只能手写 try_files，不能用 rewrite
phpEnv 内置的“伪静态”下拉菜单里没有 Laravel 选项，且它不支持宝塔那种模板一键导入。网上抄来的 rewrite ^/(.*)$ /index.php/$1 last; 在 phpEnv 的 Nginx 版本（通常为 1.20+）下会导致 PATH_INFO 解析失败，Laravel 10 路由初始化直接报错。
- 进入站点设置 → “配置文件” → 切换到
nginx.conf标签页 - 找到
location / { ... }块，在里面替换为：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
- 确保这段在
location ~ \.php$块之前（Nginx 匹配顺序敏感） - 删掉任何形如
rewrite、if (!-e $request_filename)的旧规则，它们和 try_files 冲突 - 保存后点“重载 Nginx”，不要只点“保存”
PHP-FPM 参数漏了 SCRIPT_FILENAME 就会路由白屏
phpEnv 的默认 PHP-FPM 配置不带 $realpath_root，导致 $_SERVER['SCRIPT_FILENAME'] 是空或错路径，Laravel 10 的 RouteServiceProvider 初始化失败，页面空白或报 “Target class [RouteServiceProvider] does not exist”。
立即学习“PHP免费学习笔记（深入）”；
- 仍在 nginx.conf 中，找到
location ~ \.php$块 - 在
include fastcgi_params;后面追加三行：
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_param REQUEST_URI $request_uri;
- 别用
$document_root—— phpEnv 常用符号链接或路径别名，$realpath_root才能解析真实路径 - 改完重载 Nginx，再清一次 Laravel 缓存：
php artisan config:clear && php artisan cache:clear
APP_URL 错误会导致 asset() 和邮件链接全带 index.php
phpEnv 是本地环境，很多人留着 APP_URL=http://localhost，但 Laravel 10 的 asset() 函数在生成 URL 时会严格比对当前请求 host 和 APP_URL。若不一致，就 fallback 到带 index.php 的绝对路径，CSS/JS 全 404，密码重置邮件里的链接也打不开。
- 编辑
.env文件，设为：
APP_URL=http://localhost
- 如果用了端口（如
http://localhost:8080），APP_URL 必须完全一致，末尾不加/ - 检查
config/app.php中'url' => env('APP_URL', 'http://localhost')没被硬编码改掉 - 若通过 hosts 绑定域名（如
127.0.0.1 myapp.test），APP_URL 和 Nginx 的server_name都得同步改成myapp.test
最易忽略的是：phpEnv 修改配置后不重载 Nginx 就以为生效了，或者改了 root 却忘了改 fastcgi_param —— 这两个点一错，整个路由链就断在入口前，连 Whoops 错误页都出不来。
