很多开发者在 安装、升级、部署 Laravel 12 时，都会踩版本兼容、扩展缺失的坑。本文整理官方最新规范，一次性讲清 Laravel 12 对应的 PHP 版本、兼容区间、必填扩展、Composer 配置及版本差异对比，适配本地开发与线上生产环境，新手也能直接照抄配置。
一、Laravel 12 官方 PHP 版本要求
Laravel 12 对 PHP 版本做了严格限制，彻底放弃老旧版本，聚焦新特性与安全性，官方标准适配区间如下：
- 最低支持版本：PHP 8.2.0（8.1 及以下版本完全不兼容，无法安装运行）
- 全兼容版本：PHP 8.2、8.3、8.4、8.5
- 生产环境推荐：PHP 8.3（综合稳定性、性能、JIT 优化、安全更新最优，是企业部署首选）
截止2026年，PHP 8.2 逐步进入维护末期，长期项目建议直接升级 PHP 8.3，规避后续版本迭代兼容问题。
二、标准 Composer 版本约束配置
新建项目或升级旧项目至 Laravel 12，直接在 composer.json 写入以下规范配置，可完美适配所有兼容 PHP 版本：
{
"require": {
"php": "^8.2",
"laravel/framework": "^12.0"
}
}配置说明：^8.2 代表兼容 8.2 及以上、9.0 以下的所有 PHP 稳定版本，完全匹配 Laravel 12 官方适配规则。
三、必须开启的 PHP 扩展（缺一不可）
Laravel 12 运行依赖多项核心扩展，未开启会直接报错、安装失败或运行异常，部署前务必全部开启，完整必填列表如下：
- BCMath、Ctype、cURL、DOM
- Fileinfo、Filter、Hash、Mbstring
- OpenSSL、PCRE、PDO、Session
- Tokenizer、XML
快速检测命令（Linux/Mac）：可直接终端运行，检查扩展是否全部安装
php -m四、Laravel 12 与相邻版本 PHP 要求对比
清晰区分各版本适配标准，避免升级混淆，对比核心差异如下：
- Laravel 10：最低 PHP 8.1，兼容 8.1–8.3
- Laravel 11：最低 PHP 8.2，兼容 8.2–8.4
- Laravel 12：最低 PHP 8.2，兼容 8.2–8.5
- Laravel 13（新版）：最低 PHP 8.3，兼容 8.3–8.5
可以看出，Laravel 12 是过渡性稳定版本，向下兼容 PHP 8.2，向上支持最新 8.5，适配性极强，适合中长期项目迭代。
五、部署 & 升级避坑建议
- 禁止使用 PHP 8.1 及以下版本，强行安装会直接依赖报错、框架无法启动
- 生产优先 PHP 8.3，相比 8.2 性能提升明显，且安全更新周期更长
- 升级项目前，先检查服务器/容器 PHP 版本与扩展，再执行
composer update - Laravel 12 彻底废弃 Carbon 2，强制使用 Carbon 3，升级时需同步适配日期代码
总结
Laravel 12 核心环境标准：PHP ≥8.2、推荐8.3、配齐全部核心扩展。作为兼顾稳定性与新特性的过渡版本，无论是新项目搭建、旧项目升级还是线上部署，按照本文配置均可一次性规避环境兼容问题，适配2026年主流开发部署规范。
码字不易，欢迎点赞收藏，后续持续更新 Laravel 12 升级教程、性能优化、部署实战干货！
正文完
可以使用微信扫码关注公众号（ID：xzluomor）
