Symfony组件非框架绑定品，是可单独安装、按需引入的独立包；用composer require symfony/console symfony/http-foundation即可快速搭建CLI工具或轻量API，无需完整框架。
symfony/console 和 symfony/http-foundation 这类组件在 PHP 8.2+（当前最新稳定版）中完全可用，无需降级或特殊适配；关键不是“PHP 版本能不能用”，而是“怎么装、怎么引、怎么避坑”。
composer require 的时候别拉整个框架
很多人搜“PHP 最新版 Symfony 导入”，第一反应是 composer create-project symfony/skeleton，结果装了一整套框架——但你可能只想要一个 CLI 命令或一个请求解析器。
直接运行：composer require symfony/console symfony/http-foundation
就够了。Composer 会自动选兼容 PHP 8.2+ 的最新小版本（如 symfony/console v7.2），不带任何框架绑定逻辑。
注意：
- 不要加 --dev（除非你确定只在开发时用）
- 如果项目已存在 composer.json，确认 "minimum-stability" 没设成 dev，否则可能意外拉到 alpha 版
- vendor/autoload.php 必须在入口文件里 require，漏掉这句，use SymfonyComponentConsoleCommandCommand 就会报错 Class not found
PHP 8.2+ 下 Command 类的构造函数注入写法
PHP 8.2 支持属性提升（property promotion），但 Command 子类的构造函数必须调用 parent::__construct()，否则 $defaultName 不生效、命令注册失败。
正确写法是：public function __construct(private UserRepository $userRepository) { parent::__construct(); }
常见错误：
- 忘了 parent::__construct() → php bin/console list 看不到命令
- 把依赖声明写在 execute() 里 → 类型错误或 TypeError 报错
- 用 #[SymfonyContractsServiceAttributeRequired] 注解 → 这个注解在独立组件场景下无效，Application 不扫描它，只认构造函数参数
- 在构造函数里做耗时操作（比如连接数据库）→ CLI 启动就卡住，应延迟到 execute() 中
HttpFoundation 的 Request::createFromGlobals() 在 PHP 8.2+ 的三个失效场景
这个方法在 PHP 8.2 上没变，但环境稍有不对就静默返回空请求对象：
- Nginx + PHP-FPM 下，fastcgi_param REQUEST_METHOD $request_method 没传 → createFromGlobals() 初始化失败，抛 UnexpectedValueException
- 请求是 application/json，却还去读 $request->request->get('foo') → 它只处理 urlencoded 和 multipart，JSON 得自己读 php://input
- 在 CLI 脚本里误调（比如测试时写了 php test.php）→ $_SERVER 缺少 REQUEST_URI 等字段，直接崩溃
安全做法：
- CLI 环境下别碰 createFromGlobals()，改用 new Request($_GET, $_POST, [], $_COOKIE, $_FILES, $_SERVER)（手动补全）
- Web 环境下，先检查 PHP_SAPI === 'cli' 再决定走哪条路
- JSON 请求统一加判断：if (str_contains($request->headers->get('Content-Type') ?? '', 'json')) { $data = json_decode(file_get_contents('php://input'), true); }
立即学习“PHP免费学习笔记（深入）”；
为什么 bin/console run 后提示 “Command ‘app:xxx’ is not defined”
这不是 PHP 版本问题，是注册链断了。PHP 8.2 对语法更严格，但这里出错几乎全是路径/加载顺序问题：
- bin/console 里 require 的命令类路径错了，比如写成 src/Commands/ImportCommand.php，但实际类在 src/Command/ImportCommand.php（注意是 Command 不是 Commands）
- 类名没以 Command 结尾，比如叫 ImportUsers → Application 默认跳过，不报错也不加载
- $application->add(new ImportCommand()) 写在 if (false) { } 里，或者被条件判断包住了，根本没执行
- 使用了 glob('src/Command/*.php') 批量加载，但某个文件里有 PHP 8.2 不兼容语法（比如废弃的 create_function），导致 require 失败，后续文件全跳过
最稳的调试方式：
- 在 bin/console 顶部加 var_dump(class_exists(AppCommandImportCommand::class));
- 如果是 false，说明 autoloader 没扫到，检查 composer.json 的 "autoload" 是否包含 "psr-4": { "App\": "src/" }
复杂点往往不在 PHP 版本，而在 bin/console 文件里那几行注册代码有没有被执行、有没有被覆盖、有没有被静默忽略。
