Laravel安装需要什么环境_Laravel环境要求配置方法【方法】-Laravel-PHP中文网

Laravel 10+ 要求 PHP ≥ 8.1.0 且 Composer ≥ 2.5.0，缺 mbstring、openssl、pdo 等扩展会导致 artisan serve 失败；Node.js 非必需但 Vite 构建前端需其支持。

laravel安装需要什么环境_laravel环境要求配置方法【方法】

PHP 版本必须 ≥ 8.1

Laravel 10+ 已彻底放弃对 PHP 7.x 的支持，php -v 输出低于 8.1.0 会直接报错：Composer could not find a composer.json file（实际是 Laravel 安装器因 PHP 版本不兼容静默失败）。别信某些教程说“8.0 勉强能跑”，Laravel 10.42 起已强制校验 version_compare(PHP_VERSION, '8.1.0', '>=')。

实操建议：

用 php -v 确认当前 CLI 使用的 PHP 版本，不是 Web Server（如 Apache）里那个
Mac 用户用 Homebrew 安装时，执行 brew install php@8.2 后记得运行 brew link --overwrite php@8.2
Linux（Ubuntu/Debian）推荐用 ondrej/php PPA 源，避免系统默认的过旧 PHP
Windows 用户别用 XAMPP 自带 PHP——它通常卡在 8.0.x，改用 phpbrew 或直接下载 php-8.2-nts-Win32-vs16-x64.zip 解压配置 PATH

Composer 必须 ≥ 2.5.0

Laravel 11 要求 Composer 2.5+，否则运行 composer create-project laravel/laravel 会卡在依赖解析阶段，报错信息像：[ErrorException] Undefined array key "name"——这其实是 Composer 内部解析 laravel/framework 的新式 composer.json schema 失败。

实操建议：

运行 composer --version，若低于 2.5.0，立刻升级：composer self-update --2
别用国内镜像源（如阿里云、腾讯云）的旧缓存包，加 -vvv 参数运行安装命令，观察是否卡在 Downloading https://packagist.org/packages.json
如果公司内网禁外网，需手动下载 https://getcomposer.org/installer 并用 php composer-setup.php --filename=composer --version=2.5.8

扩展缺一个，`artisan serve` 就起不来

常见现象：项目 create-project 成功，但一跑 php artisan serve 就崩，报错 Class 'PDO' not found 或 Call to undefined function mb_strlen()。这不是 Laravel 问题，是 PHP 缺扩展。

必须启用的扩展（CLI 模式下）：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

mbstring（字符串处理，非可选）
openssl（HTTPS 请求、JWT、Composer 下载）
pdo + 对应驱动（如 pdo_sqlite 或 pdo_mysql，哪怕你暂时只用 SQLite）
tokenizer（Tinker、Blade 编译必需）
xml（事件广播、部分包依赖）

验证方式：运行 php -m | grep -E 'mbstring|pdo|openssl'，没输出就说明没加载。Linux 下检查 /etc/php/*/cli/php.ini，Windows 下确认 php.ini 里有 extension=mbstring 这类行且前面没加分号。

Node.js 不是必须，但没它 vite 会报错

Laravel 默认用 Vite 构建前端资源，npm run dev 本质是启动 vite。没装 Node.js 或版本太低（node -v 18.0.0），运行时会直接报：Error: Cannot find module 'vite' 或更底层的 ERR_MODULE_NOT_FOUND。

实操建议：

最低要求 node -v ≥ 18.0.0（Laravel 10.39+ 强制），别用 16.x——Vite 4.5+ 已弃用
用 nvm（macOS/Linux）或 nvm-windows 管理多版本，避免全局污染
如果纯后端开发、不用前端资源编译，可删掉 resources/js 和 vite.config.js，再注释 app/Providers/AppServiceProvider.php 中的 Vite::useHotFile() 调用，跳过 Vite 初始化

环境变量、Web 服务器（Nginx/Apache）、数据库这些，反而是次要项——Laravel 开发服务器 artisan serve 自带 PHP 内置服务器，只要 PHP 扩展齐、Composer 版本够、Node.js 在路径里，就能跑通基础请求路由。最容易被忽略的是 CLI PHP 和 Web PHP 不是同一个二进制，以及 Composer 镜像源导致的依赖元数据损坏。