最直接有效的方式是运行 php artisan --version,输出形如“Laravel Framework 10.48.12”,即项目正在运行的确切版本;其次查 composer.json 中 "laravel/framework" 的版本约束;还可加路由 /ver 调用 app()->version() 返回纯版本号。

最直接有效的方式是运行 php artisan --version,输出形如 “Laravel Framework 10.48.12” —— 这个就是你项目正在运行的确切版本。
命令行快速确认(推荐首选)
进入项目根目录后,在终端执行:
- php artisan --version:显示完整框架名与精确版本号,含补丁号,准确度最高
- 若提示
command not found: php,说明 PHP 未加入系统环境变量;若提示artisan: command not found,请确认是否在 Laravel 项目根目录下操作
查看 composer.json 文件(适合离线或快速扫读)
打开项目根目录下的 composer.json,定位到 "require" 区块,找这一行:
-
"laravel/framework": "^10.0"→ 表示使用 10.x 系列的最新兼容版,但不等于当前实际安装版本(比如可能是 10.48.12) - 该写法反映的是“版本约束”,不是“已安装版本”,适合预判升级范围,不适合排查运行时行为
代码中动态获取(适合调试或开发辅助功能)
可在路由、控制器或 Blade 模板中调用:
-
app()->version()返回纯版本字符串,如"10.48.12" - 临时加个测试路由:
Route::get('/ver', fn() => app()->version());,浏览器访问/ver即可看到 - 注意:不要在生产环境长期保留此类调试路由,避免信息泄露
查文档前必须对齐版本(关键提醒)
打开 https://www.php.cn/link/b13245211331d16e2a04423665d4b3a8,右上角下拉菜单默认是最新版(如 11.x),务必手动切换为你项目实际版本(如 10.x)。因为:
- Laravel 9 和 10 的队列配置方式不同
- 中间件注册语法在 5.5、5.7、6.x、8.x、10.x 中多次调整
- 中文文档常滞后 1~3 个月,生产问题请以英文官网为准


















