必须先配置XAMPP的PHP扩展(openssl、pdo_mysql、mbstring、tokenizer)并确保extension_dir路径正确,再安装Composer并指定XAMPP中php.exe路径,配置国内镜像源后,通过composer create-project在htdocs下创建项目,最后访问http://localhost/项目名/public/才能成功运行。

要在本地XAMPP环境下运行Laravel项目,必须让PHP、Composer和Laravel三者正确衔接,缺一不可——直接把Laravel文件丢进htdocs里会报错“Class 'Illuminate\Foundation\Application' not found”,因为自动加载机制根本没启动。
确认XAMPP已就绪并启用PHP扩展
打开XAMPP控制面板,启动Apache和MySQL;点击Apache右侧的“Config”→选择“PHP (php.ini)”,用记事本打开该文件。
搜索extension_dir,确认其值为绝对路径,例如:extension_dir = "D:\xampp\php\ext"(盘符和路径需与你实际安装位置完全一致,【路径中不能含中文或空格】)。
再依次取消以下四行前面的分号注释(若已被注释):
extension=openssl
extension=pdo_mysql
extension=mbstring
extension=tokenizer
保存php.ini后,重启Apache。这一步漏掉任一扩展,后续composer install或laravel启动都会失败。
安装并验证Composer
前往https://www.php.cn/link/594ca739e3609243a6b6a3dd8d871114下载Windows Installer(Composer-Setup.exe),双击运行。
安装过程中关键一步:当提示“Where is PHP installed?”时,【必须手动定位到XAMPP中的php.exe,例如 D:\xampp\php\php.exe】,不能用系统默认PHP或留空。
安装完成后,按Win+R输入cmd,在命令行中执行:composer -V
若返回类似Composer version 2.7.7的信息,说明安装成功;若提示“不是内部或外部命令”,则需将C:\ProgramData\ComposerSetup\bin加入系统环境变量Path。
配置国内镜像加速安装
执行以下命令切换Packagist源为中国镜像(避免超时或404):composer config -g repo.packagist composer https://packagist.phpcomposer.com
注意:该命令仅需运行一次,全局生效。不执行此步,create-project极大概率卡在“Loading composer repositories”阶段。
创建Laravel项目
第一步:打开命令行,进入XAMPP的htdocs目录:cd /d D:\xampp\htdocs
第二步:执行安装命令(以项目名myapp为例):composer create-project laravel/laravel myapp --prefer-dist
第三步:等待完成。整个过程通常耗时2–8分钟,终端会逐行输出依赖包解压日志。若中途报错如[RuntimeException] Could not load package...,大概率是镜像未生效或网络中断,重新执行上一步命令即可。
安装成功后,D:\xampp\htdocs\myapp目录下将生成完整Laravel结构,其中public文件夹即Web入口目录。
访问Laravel首页
浏览器中输入:http://localhost/myapp/public/
看到绿色Laravel徽标和“You have successfully installed Laravel!”文字,即表示运行成功。
注意:URL中必须包含/public/,否则会直接暴露app/等敏感目录,且Apache默认不支持index.php重写规则,【切勿省略public路径】。


















