FrankenPHP 1.0 内置 PHP 版本需通过 frankenphp run 日志首行(如“PHP 8.3.12”)或 frankenphp php-cli -m 验证,而非 php -v 或 frankenphp --version;扩展检查须用后者,phpinfo() 可选佐证。

FrankenPHP 1.0 的 PHP 版本不是独立可替换的组件,而是硬编译进二进制文件里的。所以验证“内置 PHP 版本”,关键不是查命令行别名或系统 PHP,而是确认 frankenphp run 启动时实际加载的 PHP 内核版本。
看 frankenphp run 日志第一行
这是最直接、最权威的方式。FrankenPHP 启动时会在控制台第一行明确打印它所携带的 PHP 版本:
- 运行
frankenphp run - 观察输出的第一行,类似:
PHP 8.3.12 (cli) (built: Sep 15 2026 10:22:41) - 这一行中的
8.3.12就是 FrankenPHP 1.0 二进制内嵌的真实 PHP 源码版本
用 frankenphp php-cli -m 查扩展清单
这个命令调用的是 FrankenPHP 自带的 PHP CLI SAPI,和上面日志版本完全一致,能验证扩展是否按预期启用:
- 执行
frankenphp php-cli -m - 检查输出中是否有你项目必需的扩展,比如
pdo_mysql、redis(注意:需用php8.3-franken-redis兼容包)、opcache、mbstring - 若
apcu出现在列表里,说明该 FrankenPHP 构建启用了它(默认不支持)
别信 php -v 和 frankenphp --version
这两个命令容易误导:
立即学习“PHP免费学习笔记(深入)”;
-
php -v查的是系统 PATH 下的 PHP,和 FrankenPHP 无关 -
frankenphp --version只显示 FrankenPHP 自身版本号(如v1.0.0),不包含其打包的 PHP 版本 - 必须用
frankenphp run或frankenphp php-cli这类子命令触发真实 PHP 环境
进阶:验证 phpinfo() 输出(可选)
如果项目已启动,可在路由中临时加一段:
<?php phpinfo(); ?>- 访问该路由,查看页面顶部 “PHP Version” 字段
- 向下滚动找 “Configure Command”,确认
--with-php-build=...路径指向的确实是 FrankenPHP 发布包源



















