phpEnv安装Laravel 10及配置伪静态 phpEnv框架部署-php教程-PHP中文网

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及配置伪静态 phpenv框架部署

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/ last; 在 phpEnv 的 Nginx 版本（通常为 1.20+）下会导致 PATH_INFO 解析失败，Laravel 10 路由初始化直接报错。

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

进入站点设置 → “配置文件” → 切换到 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”。

仍在 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 错误页都出不来。