首先安装symfony/platform-check插件，再通过ext-*在composer.json中声明PHP扩展依赖，如ext-json、ext-pdo等，确保环境一致性；platform-check会在运行时检测缺失扩展并告警，避免部署问题。
在现代PHP项目中，依赖管理离不开 Composer。除了安装常规的 PHP 包之外，Composer 还支持对 PHP 扩展和平台环境进行检查与约束，其中 phpstan/phpstan、symfony/flex 等工具广泛使用了 platform-check 和 ext-* 依赖配置。本文将详细介绍如何使用 Composer 安装 platform-check，以及如何正确配置 ext-* 类型的扩展依赖。
什么是 platform-check？
Composer 并不会自动检测系统是否缺少某些必需的 PHP 扩展或平台功能（如特定 PHP 版本、函数禁用等）。platform-check 是一个由 Symfony 团队维护的 Composer 插件，用于在项目运行时检查当前环境是否满足 composer.json 中声明的依赖要求。
它会在执行 composer install 或 update 后生成一个检查脚本，在应用启动时提醒开发者缺少必要的扩展或配置错误，避免运行时报错。
如何安装 platform-check
要启用 platform-check 功能，只需通过 Composer 安装对应的包：
立即学习“PHP免费学习笔记（深入）”；
composer require --dev symfony/platform-check
安装后，Composer 会自动注册该插件。下次运行 composer install 或 update 时，它会分析你的 composer.json 文件中的依赖，并生成一个运行时检查机制。
如果你使用的是 Symfony 项目，默认已包含此组件。非 Symfony 项目也可安全引入，不会产生额外负担。
ext-* 依赖的作用与配置方法
在 composer.json 中，你可以通过 ext- 前缀来声明项目所依赖的 PHP 扩展。例如：
{
"require": {
"php": "^8.1",
"ext-json": "*",
"ext-pdo": "*",
"ext-gd": "^3.0"
}
}
-
ext-json：声明需要 PHP 的 JSON 扩展，
*表示任意版本即可。 - ext-pdo：数据库抽象层支持。
- ext-gd：图像处理扩展，指定版本号可限制最低要求。
当运行 composer install 时，Composer 会检查当前环境中这些扩展是否存在且版本匹配。若不满足，会提示错误并中断安装流程。
注意：ext- 只能用于已编译进 PHP 或通过 php.ini 加载的扩展，不能用于 PECL 动态安装但未启用的情况。
常见问题与最佳实践
- 确保生产环境与开发环境的扩展一致性。可以使用
php -m查看已加载的扩展列表。 - 对于可选扩展，应使用 suggest 字段提示用户，而不是强制依赖。例如：
"suggest": { "ext-redis": "Required for Redis cache support." } - 结合
platform-check使用时，即使跳过了 Composer 安装阶段的问题，运行时仍会收到警告，有助于提前发现配置遗漏。 - 不要滥用
ext-依赖。只有真正关键的功能才应设为硬性依赖。
基本上就这些。合理使用 platform-check 和 ext-* 配置，能让 PHP 项目的环境兼容性更清晰，减少“在我机器上能跑”的尴尬情况。
