composer install 成功但运行报 Class not found,因 Composer 默认仅校验 composer.json 显式声明的 PHP/扩展约束,不扫描代码实际调用的函数、类或 INI 配置;需用 composer check-platform-reqs(Composer 2.2+)检查全部依赖的平台要求,并结合 composer dump-autoload -v 排查自动加载失效。
Composer 本身不自动检测平台兼容性,
和
都是手动触发命令,不会在
或
时默认运行。
为什么
composer
install 成功了,但项目一跑就报 Class not found?
因为 Composer 默认只校验
中显式声明的
和
约束,不扫描代码实际调用的函数或类。常见漏检点:
已加载,但
这类 INI 配置缺失 →
不管 ini 设置
存在,但没编译 PNG 支持 → 扩展存在,功能残缺,
无法识别
某包在源码里用了
(PHP 8.1+),但
只写了
→ Composer 不做语法级扫描
用哪个命令检查最贴近真实运行环境?
优先用
(Composer 2.2+),它读取的是项目所有依赖(含传递依赖)的
字段,比
更准。注意区别:
只查 Composer 自身运行依赖(如
、
、
),不看项目 require 的
等
默认只检查顶层
,加
才递归检查全部依赖项的平台要求
会尝试解析整个依赖图并触发 autoloader 初始化逻辑,比纯静态检查更早暴露运行时问题
本地和 CI 环境检查结果不一致?先确认 PHP 二进制是否统一
报错说
缺失,但
能看到 —— 这几乎一定是 Composer 调用的 PHP CLI 和你手动执行的不是同一个二进制。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记(深入)
”;
运行
和
,确认 Composer 启动时用的是哪个
用完整路径验证:比如
或
macOS 上 Homebrew 安装的 PHP 常因 PATH 顺序导致 CLI 默认用系统旧版;Windows 用户注意 XAMPP、WAMP、独立 PHP 目录可能混用
Docker 场景下,
镜像不含 PHP,必须基于
这类基础镜像构建,否则
在构建阶段运行,而容器运行时 PHP 版本不同
怎么让检查真正起作用,而不是走个过场?
关键不是多跑几个命令,而是把检查嵌入到流程里,并避免配置干扰:
删掉
里的
段(除非 CI 明确需要“降级模拟”),否则
校验的是假定环境,不是真实 PHP
CI 中加一行:
,排除
干扰,聚焦生产环境约束
用自定义脚本兜底:
可检查
、
、INI 配置值等,
做不到的它都能补上
不要用
临时绕过——它跳过检查,但装上的包在运行时大概率崩,排查成本更高
最容易被忽略的一点:
文件里存了生成时的 PHP 版本信息,但它不会阻止你在更低版本上强行
。所以不能靠 lock 文件保兼容,每次切换 PHP 环境后,都得重新跑一遍
或
。
platform-checkcheck-platform-reqsinstallupdatecomposer.jsonphpext-*ext-redisredis.session.locking_enabledplatform-checkext-gdplatform-checkstr_contains()composer.json"php": "^7.4"composer check-platform-reqsrequirecomposer diagnosecomposer diagnosejsonmbstringcurlext-gdcomposer platform-checkrequire--with-dependenciescomposer install --dry-runext-zipphp -m | grep zipwhich phpcomposer config --global bin-dirphp/usr/bin/php -m | grep zip/opt/homebrew/bin/php -vcomposer:2php:8.1-clicheck-platform-reqscomposer.json"platform"check-platform-reqscomposer platform-check --no-devrequire-devbin/check-env.phpfunction_exists()defined()platform-check--ignore-platform-reqscomposer.lockinstallcheck-platform-reqsplatform-check