Composer无法锁定PHP扩展版本，因ext-xxx仅声明运行时依赖、不参与安装；其版本校验需结合config.platform模拟、运行时extension_loaded()强校验及CI显式安装三重保障。

Composer 无法直接锁定 PHP 扩展的版本，composer.json 中的 ext-xxx 只是声明依赖要求，不参与版本解析或安装——它只校验当前环境是否满足，不下载、不编译、不降级扩展。

为什么 ext-mbstring: "^1.0" 这类写法无效

PHP 扩展（如 mbstring、gd、redis）不是 Composer 包，没有版本号发布在 Packagist 上。它们由 PHP 自身或第三方编译提供，版本信息来自 php -m 或 extension_loaded() 运行时判断，而非 Composer 的依赖图谱。

常见错误现象：

• 写 "ext-redis": "^5.3" 后 composer install 仍通过，哪怕当前 phpredis 是 4.3.0
• CI 环境报 ext-igbinary: ^3.2 不满足，但本地 php --ri igbinary 显示 3.2.12 —— 实际是扩展未启用（extension=igbinary.so 没加载）

真正有效的环境兼容控制方式

靠声明 + 脚本 + CI 配置三重保障，不是单靠 composer.json：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

立即学习“PHP免费学习笔记（深入）”；

• composer.json 中用 config.platform.ext-xxx 模拟目标环境（仅影响依赖解析，不校验真实扩展）：

  "config": {
    "platform": {
      "ext-gd": "8.1.0",
      "ext-mbstring": "8.1.0"
    }
  }

• 运行时强校验：在 public/index.php 或 bootstrap.php 开头加

  if (!extension_loaded('redis') || version_compare(phpversion('redis'), '5.3.7', '<')) {
      throw new RuntimeException('ext-redis >= 5.3.7 required');
  }

• CI 中显式安装指定扩展版本（如 GitHub Actions）：

  - name: Install phpredis 5.3.7
    run: |
      pecl install redis-5.3.7
      echo "extension=redis.so" >> $PHP_INI_DIR/conf.d/redis.ini

常见扩展版本获取与兼容陷阱

不同扩展的版本号来源不一致，容易误判：

• mbstring、json、curl 等内置扩展：版本 = PHP 主版本（如 PHP 8.1 → ext-mbstring 版本通常标为 8.1.0），不能单独升级
• redis、mongodb、grpc：由 PECL 发布，phpversion('redis') 返回真实扩展版本（如 5.3.7）
• igbinary、msgpack：有独立版本，但和 redis 或 memcached 扩展存在 ABI 兼容要求（例如 redis 5.3.7 要求 igbinary >= 3.2.1）
• Docker 用户注意：FROM php:8.1-cli 不等于自带所有扩展；docker-php-ext-install 编译出的扩展无版本号字段，phpversion('xxx') 可能返回空字符串

最易被忽略的一点：扩展是否启用，比版本号更重要。很多“版本冲突”实际是 extension=xxx.so 没写进 php.ini，或路径错误导致加载失败——先跑 php -m | grep redis 和 php --ri redis 确认基础状态，再谈版本。