XAMPP运行Laravel需三步:启用mod_rewrite模块并设AllowOverride All;开启php.ini中pdo_mysql、openssl、mbstring、curl扩展;确保.env在项目根目录且为UTF-8无BOM格式,访问时必须加/public路径。

Apache 虚拟主机必须启用 mod_rewrite
默认 XAMPP 的 Apache 不开启重写模块,Laravel 的路由会直接 404 或返回原始 PHP 文件内容。不是 Laravel 安装问题,而是 Apache 拒绝处理 .htaccess 规则。
打开 XAMPP\apache\conf\httpd.conf,找到这行:
LoadModule rewrite_module modules/mod_rewrite.so
确保它前面没有 #;再找 块,把里面的 AllowOverride None 改成:
AllowOverride All
改完重启 Apache。如果仍无效,检查 Laravel 项目根目录下 .htaccess 是否存在且内容正确(Laravel 10+ 默认自带,勿手动删)。
php.ini 必须启用关键扩展
Laravel 启动时会报 Class 'PDO' not found 或 mbstring extension is required,说明 PHP 缺少基础扩展。XAMPP 自带的 PHP 配置是“最小化启用”,很多扩展默认注释掉。
编辑 XAMPP\php\php.ini,取消以下几行前的分号 ;:
-
;extension=php_pdo_mysql.dll→ 启用 MySQL PDO 支持 -
;extension=php_openssl.dll→ Composer 和 HTTPS 请求必需 -
;extension=php_mbstring.dll→ Laravel 字符串处理核心依赖 -
;extension=php_curl.dll→ HTTP 客户端、包管理器常用
改完保存,重启 Apache(仅重启 Apache 即可,PHP 配置由 Apache 加载)。
环境变量文件 .env 的位置和权限陷阱
Laravel 在 XAMPP 下常报 Application key not set 或数据库连接失败,90% 是因为 .env 文件没被读到——不是路径错,而是 Apache 用户没权限读取或文件被隐藏。
确保:
-
.env和.env.example都放在 Laravel 项目根目录(即含artisan的那层),不是public/下 - Windows 资源管理器默认隐藏以点开头的文件,需在“查看”→“显示”中勾选“隐藏的项目”才能确认它真实存在
- 不要用记事本另存为
.env:它会加 BOM 头导致php artisan config:cache报错,用 VS Code 或 Notepad++ 保存为 UTF-8 无 BOM 格式 - 运行
php artisan key:generate前,先确认APP_KEY在.env中为空(Laravel 会自动填入),否则命令不生效
访问路径不能直接敲 localhost/myapp
浏览器输 http://localhost/myapp 会进错目录——Apache 默认只认 htdocs 下的子目录,而 Laravel 的 Web 入口在 public/ 子目录,直接访问会导致路由失效、CSS/JS 404、甚至暴露敏感文件。
两个可靠方案:
-
推荐:配置 Apache 虚拟主机,把域名(如
myapp.test)指向项目根目录,然后在public/下启动服务(php -S localhost:8000 -t public只用于调试,非 Apache 场景) -
临时方案:访问
http://localhost/myapp/public——多打/public是最不容易出错的方式,尤其验证是否跑通第一屏
别指望 index.php 自动跳转,XAMPP + Laravel 没这种兜底逻辑;public/.htaccess 也只对 Apache 有效,对直接访问 localhost/myapp 的请求完全不触发。










