phpEnv在Windows下需手动配置才能运行Laravel：Nginx须将root指向public目录并正确设置try_files；Apache需修改DocumentRoot和AllowOverride；.env中必须设APP_ENV=production、APP_DEBUG=false、APP_URL匹配访问地址；还需清缓存并确保storage与bootstrap/cache可写。
phpEnv 是 Windows 下轻量级 PHP 环境集成包，但它的 Nginx/Apache 配置默认不兼容 Laravel —— 直接放项目进去、开伪静态，90% 会报 404 或空白页。根本原因不是 Laravel 写错了，而是 phpEnv 的路径解析和重写规则没对齐 Laravel 的入口机制。
phpEnv 的 Nginx 配置必须手动改 root 和 try_files
phpEnv 自带的 Nginx 站点模板默认把 root 指向项目根目录（如 D:/phpenv/www/myapp），而 Laravel 要求必须指向 public 子目录。不改这一项，index.php 根本不会被加载。
- 打开 phpEnv 安装目录 →
nginx/conf/vhost/→ 编辑你的站点配置文件（如myapp.conf） - 把
root D:/phpenv/www/myapp;改成root D:/phpenv/www/myapp/public; - 在
location / { ... }块里，确认有这行：try_files $uri $uri/ /index.php?$query_string;（不能是/index.php?/$1或漏掉$query_string） - 删掉或注释掉任何试图匹配
.htaccess的配置 —— Nginx 不读这个文件
Apache 用户别碰 .htaccess 自动复制
phpEnv 的 Apache 模块默认启用 mod_rewrite，但如果你把 Laravel 项目整个丢进 www 目录，再依赖 public/.htaccess，大概率失败：因为 Apache 虚拟主机的 AllowOverride 默认是 None，.htaccess 被忽略。
- 直接编辑
apache/conf/extra/httpd-vhosts.conf，在对应<virtualhost></virtualhost>块内加配置： DocumentRoot "D:/phpenv/www/myapp/public"<directory> AllowOverride All Require all granted </directory>- 确保
LoadModule rewrite_module modules/mod_rewrite.so在httpd.conf中已取消注释
APP_URL 和环境变量必须手改，不能靠本地 .env
phpEnv 没有宝塔那种一键切换环境的功能。你上传的 .env 如果还留着 APP_URL=http://localhost 或 APP_DEBUG=true，页面会白屏，日志里只显示 “Whoops”，实际是 Laravel 拒绝渲染错误详情。
立即学习“PHP免费学习笔记（深入）”；
- 用记事本打开项目根目录下的
.env，强制修改三行： APP_ENV=productionAPP_DEBUG=false-
APP_URL=http://127.0.0.1:8080（或你实际访问的地址，比如http://myapp.test，且要和浏览器地址栏完全一致） - 改完后，在终端进入项目根目录，依次运行：
php artisan config:clear、php artisan cache:clear、php artisan view:clear - storage/ 和 bootstrap/cache/ 目录需设为可写（右键 → 属性 → 安全 → 给 Users 组“写入”权限）
伪静态生效但静态资源 404？检查 location 匹配顺序
phpEnv 的 Nginx 配置常把通用 location / 写在最前面，后面又加了 location ~ \.php$，但漏掉静态文件兜底规则。结果所有 .js、.css 请求都被 try_files 转发给了 index.php，返回 500 或空响应。
- 在
location /块之前，插入一段静态资源直出规则： location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ { expires 1y; add_header Cache-Control "public, immutable"; }- 注意：这段必须放在
location /之前，Nginx 按顺序匹配，否则会被前者拦截 - 如果用了 Laravel Mix，确保正则覆盖哈希文件，例如
\.js$能匹配app.abc123.js；不要写成\.js$后面加?这种无效语法
phpEnv 不是“装完就能跑”的傻瓜环境，它把底层控制权交给你 —— 每一次 404 或白屏，几乎都卡在 root 路径、APP_URL、缓存三者之一。别跳过 php artisan config:clear，也别信“我明明选了 Laravel 伪静态模板”，phpEnv 的模板只是占位符，不自动适配你的实际路径。
