Laravel在phpEnv中默认配置必然失败，因PHP版本常低于8.1且缺失mbstring、pdo等核心扩展，须终端验证并补全；网站根目录必须设为public，否则403/404；.env须置于根目录，禁用php artisan serve用于正式测试。
phpEnv 能跑 Laravel，但默认配置几乎必然失败——它自带的 PHP 版本（常为 7.4 或 8.0）和扩展缺失是硬伤，必须手动升级并补全扩展，否则 composer install 直接卡死或报 Class 'Illuminate\Foundation\Application' not found。
确认 phpEnv 中 PHP 版本与关键扩展是否达标
Laravel 10+ 强制要求 PHP ≥ 8.1，Laravel 11 已要求 PHP ≥ 8.2；仅靠 phpEnv 面板里“已安装 PHP”字样不可信，必须终端验证：
- 打开 phpEnv 自带终端或 Windows PowerShell 进入其 PHP bin 目录（如
C:\phpenv\php\php-8.2.12\），执行php -v确认 CLI 版本 - 执行
php -m | findstr /i "mbstring pdo openssl tokenizer xml ctype json"（Windows）或php -m | grep -E "mbstring|pdo|openssl|tokenizer|xml|ctype|json"（若支持 Linux 子系统），缺任一模块都会导致composer install失败或路由加载异常 - phpEnv 默认不启用
opcache和bcmath，而 Laravel 11 的symfony/polyfill-mbstring等包在无原生mbstring时会静默降级，引发后续加密/Session 异常
用 phpEnv 启动 Laravel 必须改 public/ 为网站根目录
phpEnv 的 Apache/Nginx 模块默认把整个项目文件夹当 DocumentRoot，这会导致所有请求绕过 public/index.php 入口，结果就是 403（禁止访问 .env）、404（路由失效）或 500（vendor/autoload.php 路径错误）。
- 在 phpEnv 控制面板中，找到对应站点 → “网站设置” → 将“网站根目录”明确指向项目内
public文件夹（例如C:\phpenv\www\myapp\public），不是项目根目录 - Apache 用户：确认
httpd.conf或虚拟主机配置中含AllowOverride All，否则.htaccess重写规则不生效，API 和非首页路由全部 404 - Nginx 用户：phpEnv 内置 Nginx 通常无 Laravel 伪静态模板，需手动在 server 块中加入：
try_files $uri $uri/ /index.php?$query_string;
运行 composer install 前必须设对环境变量
phpEnv 下的 Composer 常因内存限制或镜像问题卡在 Downloading packages.json，且本地生成的 vendor/ 直接复制到 phpEnv 会因路径硬编码失效。
立即学习“PHP免费学习笔记（深入）”；
- 在 phpEnv 终端中进入项目根目录后，先执行：
set COMPOSER_MEMORY_LIMIT=-1（Windows）或export COMPOSER_MEMORY_LIMIT=-1（WSL），防 OOM 中断 - 避免国内镜像同步延迟：临时切回官方源，执行
composer config -g repo.packagist composer https://packagist.org - 务必加
--no-dev --optimize-autoloader：线上不需要phpunit、pest等，且未优化的 autoloader 会让首次请求慢 300ms+ -
.env必须放在项目根目录（public的上一级），且不能被 Web 服务器直接访问；若误放public/.env，APP_KEY读取失败，Session 和密码重置将完全瘫痪
php artisan serve 在 phpEnv 中是个陷阱
它只适合调试，不能用于实际访问：绑定 127.0.0.1:8000，外部无法访问；无 HTTPS、无并发处理、无静态资源缓存，且会绕过 phpEnv 配置的扩展与 ini 设置。
- 开发阶段可临时用：
php artisan serve --host=0.0.0.0 --port=8000，但需确保防火墙放行该端口 - 正式测试必须走 phpEnv 的 Apache/Nginx：启动服务后访问
http://localhost或你配的域名，才能真实反映重写、权限、扩展加载等全流程 - 若页面空白但无报错，立刻检查
storage/logs/laravel.log—— phpEnv 默认不显示 PHP 错误，日志是唯一线索
最易被忽略的是：phpEnv 中 Apache 和 CLI 使用的 php.ini 往往不是同一份，php -m 显示有 mbstring，但 Apache 模块可能根本没加载。务必用 phpinfo() 页面确认 Web 环境实际加载的扩展和配置路径。
