FrankenPHP环境下不能直接用php bin/console运行，因其常驻进程模型依赖自身内置PHP运行时（含预编译扩展、环境隔离及.env加载逻辑），而系统php CLI版本、扩展、配置均不一致，易导致类未找到、环境变量失效或容器构建错误；正确方式是使用frankenphp console命令，复用同一运行时确保Web与CLI环境完全一致。
FrankenPHP 环境下 bin/console 不能直接用 php bin/console 运行 —— 因为 FrankenPHP 是常驻进程模型，不走传统 PHP CLI 解释器路径，php 命令默认调用的是系统自带的 PHP CLI（可能版本不对、扩展缺失、或未加载 Symfony 所需的环境变量），导致命令报错、依赖注入失败、或 APP_ENV 被忽略。
为什么 php bin/console 在 FrankenPHP 项目里会出问题
FrankenPHP 启动时会加载自己的 PHP 运行时（含内置 SAPI、扩展预编译、环境隔离），但它的 CLI 模式并未自动接管系统 php 命令。你本地装的 PHP CLI 和 FrankenPHP 内置的 PHP 往往不是同一套：扩展（如 intl、mbstring）可能缺失，$_ENV 或 .env 加载逻辑也可能不一致。常见错误包括：
-
Class "Symfony\Component\Console\Command\Command" not found（autoload 失败） -
Warning: Failed to load config file ".env"（dotenv 未触发） -
ServiceNotFoundException（容器未按APP_ENV=dev正确构建）
正确启动方式：用 FrankenPHP 自带的 frankenphp 二进制执行 console
FrankenPHP 提供了与自身运行时完全一致的 CLI 入口：frankenphp 二进制本身支持 console 子命令，它会复用相同的 PHP 配置、扩展和环境初始化流程。
操作步骤如下：
立即学习“PHP免费学习笔记（深入）”；
- 确认已下载并可执行
frankenphp二进制（通常放在项目根目录或/usr/local/bin/） - 确保项目根目录下有
frankenphp.yaml或.frankenphp.yaml（哪怕为空，用于触发环境识别） - 在项目根目录运行：
./frankenphp console
（若全局安装则直接frankenphp console） - 传参方式与原生一致：
frankenphp console app:user:import --dry-run
该方式会自动加载 .env、触发 Dotenv::bootEnv()、使用正确的 AppKernel 或 Kernel 实例，且服务容器与 Web 请求共享同一配置栈。
如果必须用 php 命令：绕过 FrankenPHP 的唯一安全做法
仅当无法使用 frankenphp console（例如 CI 环境未部署 FrankenPHP 二进制）时，才退而求其次。此时必须显式复现 FrankenPHP 的 CLI 环境：
- 手动指定 PHP INI 文件：
php -c /path/to/frankenphp/php.ini bin/console（路径见frankenphp info输出） - 强制加载 dotenv：
APP_ENV=dev APP_DEBUG=1 php bin/console（不能依赖.env自动读取） - 禁用 opcache CLI 缓存（FrankenPHP 默认关闭，但系统 PHP CLI 可能开启）：
php -d opcache.enable_cli=0 bin/console - 检查扩展是否齐备：
php -m | grep -E "(mbstring|xml|curl|intl)"，缺一不可
注意：frankenphp console 是唯一被官方测试覆盖的方式；手动拼凑 php 命令极易因扩展版本或 ini 差异导致 Doctrine 类型映射失败、Twig 编译异常等隐性故障。
FrankenPHP 的核心优势在于“一致性”——Web 请求和 CLI 命令跑在完全相同的运行时上。一旦你开始混用 php 和 frankenphp，就等于主动撕开这个一致性边界。最常被忽略的点是：即使命令看起来跑通了，var/cache/dev/ 下生成的代理类可能和 Web 请求用的不是同一套，后续清缓存或改配置时突然崩掉。
