如何在 Composer 中处理 PHP 扩展（extensions）的依赖，如 ext-json？

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免费学习笔记（深入）”；

AISEO AI Content Detector

AISEO推出的AI内容检测器

82

查看详情

• 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 来完成。

以上就是如何在 Composer 中处理 PHP 扩展（extensions）的依赖，如 ext-json？的详细内容，更多请关注php中文网其它相关文章！