windows 10 安装 laravel 10 的关键是三步:确认 php≥8.0 并启用 openssl、mbstring 等扩展,用 composer create-project 拉起项目,再执行 php artisan serve 启动并访问 http://127.0.0.1:8000 验证欢迎页。

在 Windows 10 上安装 Laravel 10,关键不是“下载 Laravel”,而是用 Composer 在已配好的 PHP 环境中拉起一个标准项目。整个过程分三步走:确认底层环境就绪、创建项目、验证运行。跳过任一环节都可能卡住。
确保 PHP 和 Composer 已正确安装并可用
这是硬前提,90% 的失败发生在这一步:
- 打开 CMD 或 PowerShell,运行 php -v,必须看到 PHP 版本 ≥ 8.0(Laravel 10 要求);若提示“不是内部命令”,说明 php.exe 没进系统 Path —— 需把 PHP 安装目录(如 C:\php)加到环境变量 Path 中
- 运行 php -m | findstr "mbstring openssl pdo_mysql xml",确保这些扩展已启用;若缺失,打开 php.ini(通常和 php.exe 同级),去掉对应行前的分号,例如:
extension=mbstring
extension=openssl
extension=pdo_mysql
extension=xml - 运行 composer --version,有输出即表示 Composer 可用;推荐用官方 Composer-Setup.exe 安装,避免手动配置出错
用 create-project 命令创建 Laravel 10 项目
不建议用 laravel new(依赖全局安装器,易版本滞后),直接用 Composer 更可靠:
- 进入目标目录,例如:cd /d D:\myproject
- 执行命令:composer create-project laravel/laravel . --prefer-dist(注意末尾的点,表示当前目录为项目根)
- 如需指定 Laravel 10 的确切小版本,可加版本约束:
composer create-project laravel/laravel . "10.*" --prefer-dist - 安装过程中若卡住,加 -vvv 参数看详细日志:
composer create-project laravel/laravel . -vvv
启动服务并确认欢迎页显示
项目建好后,快速验证是否跑通:
- 在项目根目录下运行:php artisan serve --host=127.0.0.1 --port=8000
- 浏览器访问 http://127.0.0.1:8000,看到 Laravel 默认欢迎页面即成功
- 若提示 “Unable to load dynamic library 'php_openssl.dll'”,说明 php.ini 中 extension_dir 路径不对,需确认它指向正确的 ext 文件夹(如 extension_dir = "ext")
- 如使用防火墙或公司网络,确保 8000 端口未被拦截











