在Windows上可原生安装运行Laravel项目,需配置PHP 8.0+(如phpStudy/XAMPP/WAMP)、启用openssl/pdo_mysql/mbstring/xml扩展、全局安装Composer;再用composer create-project创建项目,php artisan key:generate生成密钥,配置.env文件,最后通过php artisan serve或Apache/Nginx部署访问。

在 Windows 上安装并运行 Laravel 项目,核心是配齐 PHP 环境、Composer 工具和 Web 服务器,再按标准流程初始化项目。整个过程不依赖虚拟机或 Linux 子系统,纯原生 Windows 即可完成。
准备基础环境
确保以下三项已就绪:
- PHP 8.0+(推荐使用 phpStudy V8.1、XAMPP 8.1.25 或 WAMP Server,它们自带 Apache/Nginx + MySQL + PHP,且支持多版本切换)
-
开启必要扩展:检查 php.ini 中
extension=openssl、extension=pdo_mysql、extension=mbstring、extension=xml均已取消注释 -
Composer 已全局安装:从 getcomposer.org 下载
Composer-Setup.exe,安装时指定正确的php.exe路径;安装后在 CMD 输入composer -V验证
创建并初始化 Laravel 项目
打开命令行(CMD 或 PowerShell),执行以下步骤:
- 切换到你希望存放项目的目录,例如:
cd E:\projects - 运行命令创建新项目(以 Laravel 11 为例):
composer create-project laravel/laravel myapp - 进入项目目录:
cd myapp - 生成应用密钥:
php artisan key:generate - 复制并编辑环境配置:
copy .env.example .env,然后用记事本打开.env,按需修改数据库连接(DB_DATABASE、DB_USERNAME等)
启动服务访问项目
有两种常用方式,按需选择:
-
内置开发服务器(适合快速验证):
在项目根目录下运行php artisan serve,默认监听http://127.0.0.1:8000,浏览器打开即可看到 Laravel 欢迎页 -
通过 Apache/Nginx 正式部署(推荐用于开发调试):
将 Web 服务器的根目录(DocumentRoot)指向项目内的public/文件夹(如 XAMPP 中修改httpd.conf的DocumentRoot和<Directory>路径为E:/projects/myapp/public);同时确保AllowOverride All已启用,以便支持 Laravel 的路由重写
常见问题提醒
遇到报错时优先检查这几项:
- 命令行中运行
php -v和composer -V是否都正常输出 —— 排除环境变量未生效 -
.env文件必须存在且命名准确(不是.env.example),否则会提示 “Application key not set” - 如果页面报 404 或路由失效,确认 Apache 的
mod_rewrite已启用,且AllowOverride All已配置 - 国内用户建议设置 Composer 镜像加速:
composer config -g repo.packagist composer https://packagist.phpcomposer.com


















