Symfony 4.4（PHP 8）环境下安装API Platform报错求助

问题背景 #

在Symfony 4.4 + PHP 8环境下安装API Platform时遇到以下问题：

• 执行composer require api命令直接触发依赖错误
• 添加--ignore-platform-reqs参数强制安装后，启动应用时出现服务定义错误：Service 'api_platform.error_listener': Parent definition 'exception_listener' does not exist

适配版本确定 #

根据版本兼容规则，API Platform 2.6.x是唯一完全适配Symfony 4.4 + PHP 8的稳定版本：

• 2.5.x及更早版本不支持PHP 8语法特性
• 2.7.x及以上版本要求Symfony 5.4或更高版本，无法适配Symfony 4.4

正确安装方式 #

直接指定兼容版本执行安装命令，避免Composer自动选择不兼容的最新版本：

composer require api-platform/core:^2.6

错误原因解析 #

1. 直接执行composer require api时，Composer会尝试拉取API Platform最新版，而新版依赖Symfony 5+，与当前Symfony 4.4环境冲突，导致平台依赖检查失败
2. 强制忽略平台要求安装后，API Platform高版本的服务配置依赖Symfony 5+新增的exception_listener服务，但Symfony 4.4中对应的服务名称为kernel.exception_listener，因此出现服务继承定义错误

后续注意事项 #

• 安装完成后，确保config/packages/api_platform.yaml配置文件使用Symfony 4.4兼容的格式
• 当前项目依赖的Doctrine ORM版本^2.7与API Platform 2.6完全兼容，无需额外调整

内容的提问来源于stack exchange，提问作者Dariusz Rup