Composer install后需执行三道检查：composer check-platform-reqs验证PHP及扩展兼容性，composer validate --strict --check-lock校验配置与锁文件一致性，php -l vendor/autoload.php确认自动加载语法合法，缺一不可。
composer install 之后不等于万事大吉
项目启动时依赖检查失败，往往不是因为 composer install 没跑完，而是它压根没验证 PHP 版本、扩展、autoload 映射或 platform 配置是否真满足运行要求。比如 composer.json 写着 "php": "^8.2"，但实际环境是 8.1.27，install 成功了，php vendor/autoload.php 却直接 fatal error——这中间的 gap 必须靠额外命令补上。
启动前必须跑的三道检查
别只信 composer diagnose 的绿色 OK，它连 PHP 版本都不查。真正能暴露硬性兼容问题的是这三条：
-
composer check-platform-reqs：输出类似php: 8.1.27 does not satisfy php ^8.2的真实报错，直接告诉你哪条require或config.platform不匹配 -
composer validate --strict --check-lock：校验composer.json结构（比如require字段误写成字符串）、composer.lock是否过期，且不联网、秒级完成 -
php -l vendor/autoload.php：验证自动加载文件本身语法合法，且当前 PHP 版本能解析（避免高版本语法如箭头函数在低版本报错）
怎么集成到启动流程里
把检查塞进入口脚本最稳妥，比如 public/index.php 开头加：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
if (!file_exists(__DIR__ . '/../vendor/autoload.php')) {
die('Vendor not installed. Run "composer install".');
}
// 强制验证平台和 autoload
if (0 !== shell_exec('composer check-platform-reqs > /dev/null 2>&1; echo $?') ||
0 !== shell_exec('php -l vendor/autoload.php > /dev/null 2>&1; echo $?')) {
die('Dependency check failed. Check PHP version, extensions, or autoload syntax.');
}
CI/CD 中更推荐串起命令：composer diagnose && composer validate --strict --check-lock && composer check-platform-reqs，任一失败就中断构建。
容易被忽略的细节
很多团队把 composer audit 当作“启动检查”，但它只扫漏洞，不查运行环境；--dev 参数漏掉会导致开发依赖里的安全问题隐身；config.platform 写错小数点（比如 "8.2.0" 而非 "^8.2"）会让 check-platform-reqs 误判；vendor 目录权限不对时，diagnose 会报 not writable，但不会告诉你具体哪个子目录不可写——得靠 ls -ld vendor 手动确认。
