laravel在windows下安装与配置需三步:先确认php≥8.0并启用openssl、mbstring等扩展,再用composer create-project拉取项目并php artisan serve启动,最后通过composer require和php artisan vendor:publish发布laravel-admin配置,执行php artisan admin:install初始化后台。

在 Windows 环境下完成 Laravel 的安装与配置文件发布,核心是三步:装好 Composer、用它拉起 Laravel 项目、再把 laravel-admin 这类扩展的配置真正落地。整个过程不依赖图形界面,全靠命令行操作,但每一步都有明确的触发点和验证方式。
确认 PHP 和 Composer 已就绪
这是前置硬条件,跳过容易卡在后续任意环节:
- 打开 CMD 或 PowerShell,执行 php -v,确保输出 PHP 版本 ≥ 8.0(Laravel 9+ 要求);若报“不是内部命令”,说明 PHP 未加入系统环境变量 Path
- 执行 composer --version,看到版本号即表示 Composer 可用;若失败,检查是否安装了 Composer-Setup.exe(推荐方式),或手动将
composer.phar所在目录加进 Path - PHP 必需扩展需启用:打开
php.ini,确认以下行未被注释(去掉前面的分号):extension=opensslextension=mbstringextension=pdo_mysqlextension=xml
创建 Laravel 项目并验证运行
不推荐用 laravel new(需额外全局安装器),直接用 Composer 命令更可控:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 新建一个空文件夹,比如
D:\myapp,CMD 中进入该目录:cd /d D:\myapp - 执行安装命令(以 Laravel 10 为例):
composer create-project laravel/laravel . --prefer-dist
注意末尾的点(.),表示当前目录为项目根目录 - 安装完成后,启动内置服务器:
php artisan serve --host=127.0.0.1 --port=8000
浏览器访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a,看到 Laravel 欢迎页即成功
发布 laravel-admin 配置并完成初始化
laravel-admin 是常用后台扩展,它的“配置文件发布”是关键动作,不能跳过:
- 在项目根目录下执行:
composer require encore/laravel-admin:"^1.10"
(建议用 1.10+ 版本,兼容 Laravel 10) - 发布配置文件:
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"
执行后会在config/下生成admin.php,这是后续自定义菜单、权限等的基础 - 执行数据库迁移和安装脚本:
php artisan admin:install
该命令会自动创建数据表、生成默认管理员账号(用户名 admin,密码 admin) - 访问后台:https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a/admin,用 admin/admin 登录即可进入管理界面
镜像加速与常见问题处理
国内网络环境下,不配镜像大概率超时或失败:
- 全局切换阿里云镜像(推荐,一劳永逸):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果
php artisan admin:install报错 “Class 'Encore\Admin\Providers\AdminServiceProvider' not found”,说明服务提供者未注册,检查config/app.php中providers数组是否已自动添加该行(新版 laravel-admin 通常自动完成,如无则手动添加) - 访问
/admin出现 404,确认 Nginx/Apache 配置中 public 目录为根目录,或使用内置 server 启动(无需额外 Web 服务器)










