Doxygen无法识别Symfony项目Inquiry.php类生成文档问题

核心原因是你当前使用的Doxygen 1.9.3版本对PHP新版本语法的适配存在缺陷：

1. 该版本发布时PHP 8.1刚推出readonly属性特性，Doxygen的PHP解析器无法识别readonly关键字，遇到该关键字时会触发静默解析失败，不会提取后续的类结构信息。
2. 该版本同时不支持PHP 7.3引入的带缩进结束标记的heredoc/nowdoc语法，这类语法也可能干扰方法内部的解析逻辑。

两个文件的差异刚好命中了这个兼容问题：FormController.php全程没有使用readonly关键字，也没有缩进式heredoc写法，因此可以被正常识别生成文档；Inquiry.php的构造函数使用了PHP 8构造器属性提升语法，四个依赖参数全部声明为private readonly，解析器读到这里就中断了类结构提取，虽然日志显示文件被读取、进入解析流程，但实际上Inquiry类没有被正确识别，最终不会生成对应文档。

按优先级选择以下任意一种方案即可：

• 升级Doxygen到1.9.4或更高版本。从1.9.4版本开始官方已经适配了PHP 8.1readonly特性、缩进式heredoc语法，不需要修改任何业务代码或配置，重新运行即可正常生成两个类的完整文档。
• 如果暂时无法升级Doxygen，可以在现有Doxyfile中添加一行预处理配置，让解析器自动忽略readonly关键字：

  PREDEFINED = readonly=
  

  该配置会在解析阶段把所有readonly关键字替换为空字符串，不会触发语法解析错误，绝大多数场景下可以解决类识别失败的问题。
• 如果添加上述配置后仍有解析异常（由缩进式heredoc导致），只需要把sendOfficeEmail()方法中heredoc的结束标记END;调整为顶格书写，移除前面的所有缩进，即可适配旧版Doxygen的解析规则。
• 若需要彻底规避所有新语法兼容问题，可以把构造函数中的属性提升写法改为传统PHP写法：所有属性在类体内显式声明，构造函数参数去掉访问修饰符和readonly关键字，在函数体内完成属性赋值，这种写法对所有版本的Doxygen都兼容。

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