Laravel在Windows需先配置PHP(x64 Thread Safe)和Composer:启用php_mbstring、php_openssl、php_zlib扩展,正确设置环境变量与php.ini路径;Composer安装推荐Setup.exe并配置镜像;创建项目优先用composer create-project指定版本;artisan serve需显式设host并放行防火墙,且同步修改.env中APP_URL。

Laravel 在 Windows 上能直接装,但必须先配好 PHP 和 Composer,缺一不可——单独装 Laravel 命令行工具(laravel/installer)或直接跑 composer create-project 都会失败,除非底层环境已就绪。
PHP 装不对,Composer 就根本起不来
Windows 上最常卡在 PHP 扩展没开、路径没加对、或者用了非 Thread Safe 版本。官方只支持 x64 Thread Safe 的 PHP(从 windows.php.net/download/ 下载),解压后必须手动改 php.ini:去掉 extension_dir = "ext" 和 extension=php_mbstring.dll 前的分号;还要确认 extension=php_openssl.dll 也已启用——否则 Composer 安装时会报 The openssl extension is required。
环境变量里只加 C:\php 不够,得确保 php.exe 和 php.ini 在同一级目录,且系统能通过 php -v 和 php -m | findstr mbstring 同时验证版本和扩展加载成功。
Composer 安装失败,90% 是权限或代理问题
用官网提供的 Composer-Setup.exe 最稳妥;如果手动安装,容易因 UAC 权限导致 composer global require laravel/installer 写不进 %APPDATA%\Composer\vendor\bin,结果 laravel -V 找不到命令。此时要检查:%APPDATA%\Composer\vendor\bin 是否已加入系统 Path,且该路径下确实存在 laravel.bat 文件。
若公司网络有代理或国内访问慢,建议提前配置镜像:
composer config -g repo.packagist composer https://packagist.phpcomposer.com
注意:2026 年主流镜像已切换为 https://packagist.org 直连或阿里云源,旧镜像地址可能失效。
创建项目别硬套 laravel new,优先用 create-project
laravel new myproject 本质是封装了 composer create-project --prefer-dist laravel/laravel myproject,但它依赖全局 laravel/installer,而后者更新滞后、偶尔不兼容新版 Laravel。更稳的方式是绕过它:
- 用
composer create-project laravel/laravel myproject "11.*"明确指定版本(Laravel 11 是当前 LTS) - 加
--no-interaction避免交互式提问打断自动化流程 - 若提示
zlib_decode(): data error,说明 ZIP 扩展未启用,需在php.ini中打开extension=php_zlib.dll
启动服务前,先确认 php artisan serve 不是万能钥匙
这个命令只是开发用的内置服务器,绑定在 http://127.0.0.1:8000,默认不监听局域网(localhost ≠ 0.0.0.0)。想让同事从另一台电脑访问,得显式指定 host:
php artisan serve --host=0.0.0.0 --port=8000
但 Windows 防火墙大概率会拦截,必须手动放行端口;更麻烦的是,一旦关掉 CMD 窗口服务就停——真要 LAN 可达,不如直接配 IIS 或 Nginx,或者用 Laragon 这类集成环境省去一堆权限和路由配置。
真正容易被忽略的点是:.env 文件里的 APP_URL 必须同步改成可访问的地址(比如 http://192.168.1.100:8000),否则前端资源路径、生成链接全错,页面看起来“空有 HTML 没样式”。










