用途:在开始处理陌生或刚克隆的 Symfony 项目时,检查项目配置是否完整可用;也用于应用无法启动、容器无法编译或路由缺失的排查,以及在改动前核对 .env、config/packages/*、Doctrine、API Platform 或 Messenger 配置。
主要能力与默认流程:确认 .env 存在并定义 APP_SECRET、DATABASE_URL 及各个 bundle 所需变量;确认 vendor/ 已安装且 bin/console about 可运行;编译容器(cache:clear)并列出服务与路由;检查数据库连接及 schema 是否与映射一致;检查可选栈,如 API Platform 资源、Messenger 传输。
使用方式与限制:该检查为只读,只报告缺失项,不在检查过程中重写配置;不得打印 .env 或 vault 中的密钥值;缓存权限问题优先使用 ACL 或正确用户,而非 chmod 777;Doctrine 检查只针对开发数据库,绝不用于生产。输出为逐项通过或失败的清单、每个失败项的确切修复方式(命令或需修改的文件),以及未检查的内容和原因。深入实现细节可查阅 reference.md。