composer 不安装 php 扩展，仅校验其是否启用；需在 composer.json 中以 ext-xxx 格式声明平台依赖，如 "ext-json": "*"，并在系统层面通过 apt、brew、dockerfile 或 php.ini 启用对应扩展。
Composer 本身不安装或启用 PHP 扩展，但它能检查当前环境是否满足扩展依赖，并在不满足时明确报错。处理 ext-json 这类扩展依赖的关键在于正确声明、理解其作用，以及配合部署流程确保环境就绪。
在 composer.json 中声明扩展依赖
PHP 扩展属于“平台依赖”（platform requirements），需在 composer.json 的 require 或 require-dev 中以 ext-xxx 格式声明：
-
"ext-json": "*"表示需要任意版本的 json 扩展（PHP 7.2+ 默认内置，无需单独安装） -
"ext-mbstring": "^1.0"可指定最低版本（但多数扩展无语义化版本号，用*更常见） - 若项目必须使用特定 PHP 版本 + 扩展组合，也可在
config.platform.php中锁定 PHP 版本，间接影响扩展可用性
Composer 如何验证扩展是否可用
运行 composer install 或 composer update 时，Composer 会自动调用 extension_loaded('json') 类似逻辑检测已启用的扩展。如果缺失：
- 会中止安装并提示类似：
The requested PHP extension ext-json is missing from your system. - 错误信息清晰，便于定位环境问题（如 Docker 容器未启用扩展、共享主机禁用了某些扩展）
- 该检查发生在依赖解析之后、包下载之前，属于“平台兼容性校验”环节
常见误区与应对建议
很多人误以为声明 ext-json 就能让 Composer 自动安装它——其实不能。PHP 扩展必须由系统或 PHP 环境本身提供：
立即学习“PHP免费学习笔记（深入）”；
- linux（apt）：
sudo apt install php-json（debian/ubuntu）或php74-php-json（centos/RHEL） - macos（Homebrew）：
brew install php@8.2（通常自带 json）；若自编译 PHP，需确认 configure 时含--enable-json - Docker：在
Dockerfile中显式启用，例如RUN docker-php-ext-enable json（前提是已存在）或apk add php82-json（Alpine） - windows（XAMPP/WAMP）：检查
php.ini中是否取消了;extension=json的注释
可选：用 platform-config 模拟环境做本地开发兼容性测试
如果你在高版本 PHP 开发，但目标服务器是旧版且缺少某些扩展，可通过 config.platform 强制 Composer 按低配环境解析依赖（避免装入不兼容的包）：
"config": { "platform": { "php": "7.4.33", "ext-json": "7.4.33", "ext-mbstring": "7.4.33" } }
注意：这不会跳过真实扩展检查，只是让 Composer 在依赖分析阶段“假装”这些扩展存在，适用于 CI 或跨环境开发场景。
基本上就这些。扩展依赖不是 Composer 能解决的问题，而是它帮你守住的一道门——门后的事，得靠运维、Dockerfile 或 php.ini 来完成。