本文介绍在 lumen 框架中准确获取并打印当前安装版本号的两种主流方式：命令行终端调用（无需修改代码）和 php 代码内调用（适用于控制器、模型等），并说明其原理与注意事项。
本文介绍在 lumen 框架中准确获取并打印当前安装版本号的两种主流方式：命令行终端调用（无需修改代码）和 php 代码内调用（适用于控制器、模型等），并说明其原理与注意事项。
Lumen 并未内置类似 Laravel 的 php artisan --version 命令，但其核心 Application 类提供了原生支持的 version() 方法——这是获取精确框架版本最可靠、最轻量的方式。
✅ 方式一：在 PHP 代码中调用（推荐用于调试或日志记录）
Lumen 的 Illuminate\Contracts\Foundation\Application 实例（即 $app 或通过 app() 辅助函数获取的容器实例）公开了 version() 方法，直接返回字符串格式的语义化版本号（如 "8.3.4" 或 "9.2.0"）：
// 在控制器、中间件、命令类或任意可访问应用实例的位置使用
$version = app()->version();
echo $version; // 输出：例如 "9.2.0"
\Log::info("Lumen version: {$version}");? 提示：该方法读取的是 laravel/lumen-framework 包的 composer.json 中声明的 version 字段（由 Composer 安装时写入），因此结果严格反映当前加载的框架版本，不受 APP_VERSION 环境变量或自定义常量干扰。
✅ 方式二：通过 Artisan 命令行快速查看（开发/部署验证场景）
虽然 Lumen 默认不提供 --version 参数，但你可以轻松扩展 Artisan 命令来实现等效功能：
-
创建一个自定义命令（例如 App\Console\Commands\VersionCommand）：
php artisan make:command VersionCommand
-
编辑生成的命令类，修改 handle() 方法：
<?php
namespace App\Console\Commands;
use Illuminate\Console\Command;
class VersionCommand extends Command { protected $signature = 'lumen:version'; protected $description = 'Display the current Lumen framework version';
public function handle()
{
$this->line('<info>Lumen Framework Version:</info> ' . app()->version());
}}
3. 运行命令即可： ```bash php artisan lumen:version # 输出示例：Lumen Framework Version: 9.2.0
⚠️ 注意事项：
- 不要尝试使用 App::VERSION（Laravel 风格）——Lumen 的 Application 类没有静态 VERSION 常量，此写法会报错；
- 避免解析 composer.lock 或 vendor/laravel/lumen-framework/composer.json 文件——既低效又易受路径/权限限制；
- 若升级后 app()->version() 未更新，请确认已执行 composer update laravel/lumen-framework（而非仅 composer update），并检查 vendor/autoload.php 是否被正确重载（必要时清除 OPCache 或重启 PHP-FPM）。
综上，app()->version() 是 Lumen 官方支持、稳定可靠、零依赖的核心方案，建议在所有需要程序化获取框架版本的场景中优先采用。
