Composer不支持离线多版本扩展共存，需三层处理：对齐PHP CLI版本、保障扩展可用性、控制Composer行为；离线部署必须用目标环境PHP CLI执行composer install并确保扩展已加载。
Composer 本身不支持“离线多版本扩展共存”这个目标——它既不管理 PHP 扩展（如 ext-redis、ext-mbstring），也不提供扩展的多版本安装路径或运行时切换机制。你真正要解决的，是「在离线、多 PHP 版本共存环境下，让 Composer 安装的 PHP 包能正确适配对应版本的扩展依赖」。这需要分三层处理：PHP CLI 版本对齐、扩展可用性保障、Composer 行为可控。
为什么 composer install 在离线多 PHP 环境下总报扩展缺失？
错误不是来自 Composer 自身，而是它在安装阶段会检查 composer.json 中声明的 ext-xxx 依赖（如 "ext-redis": "*"），并调用当前 php -v 对应的 CLI 解释器执行 extension_loaded() 校验。如果终端里 php 指向的是 8.1，但你要部署到 8.3-FPM 环境，而该环境又没装 redis.so，就会直接失败。
- 常见报错：
The requested PHP extension ext-redis * is missing from your system - 即使目标服务器已启用
redis，只要 CLI 的php.ini没加载，校验就过不去 -
COMPOSER_DISABLE_NETWORK=1不跳过扩展校验，它只禁用远程元数据请求
离线前必须确保 PHP CLI 与目标环境一致
不能靠“改配置”绕过扩展检测，只能让 Composer 运行时看到真实可用的扩展。这意味着：你得用目标环境对应的 PHP CLI 来执行所有离线准备命令。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在联网机上，用完整路径调用目标 PHP：例如
/usr/bin/php8.3 composer install --no-plugins --no-scripts --no-autoloader - 确保该 PHP CLI 已加载全部必需扩展（
mbstring、openssl、zlib、ext-redis等），可通过/usr/bin/php8.3 -m | grep redis验证 - 不要设
"platform": {"php": "8.3.0"}来伪装——它骗得过版本检查，但骗不过扩展是否存在；而且生成的autoload_static.php仍按 CLI 当前扩展状态优化，离线运行时可能因扩展未加载而触发Class not found
离线部署时 vendor 目录不可跨 PHP 版本复用
即使你成功在 8.3 下生成了 vendor/，把它拷到另一台也装了 8.3 的机器上，仍可能出问题——因为 vendor/composer/autoload_static.php 是根据当时 PHP 的反射行为、语法支持、opcache 设置等静态生成的。两个 8.3 环境若启用了不同扩展（比如一个开了 opcache.enable_cli=1，另一个没开），加载顺序和类定义缓存就可能不一致。
- 最稳做法：离线部署前，在目标环境用相同 PHP CLI + 相同扩展集，重新执行
composer install --no-plugins --no-scripts - 前提是
vendor/目录为空或已清空；残留旧包会导致 autoload 映射错乱 - 若必须复用 vendor，请确认两环境的
php -i | grep -E "(version|opcache|extension_dir)"输出完全一致
扩展版本冲突只能靠系统层隔离，Composer 不参与
像 ext-redis v5.3.7 和 ext-memcached v3.2.0 同时依赖 hiredis 但要求不同主版本，这种冲突 Composer 完全无感——它只管 PHP 类文件，不管 .so 库怎么加载。这类问题必须在操作系统或容器层面解决：
- 用
phpbrew或asdf管理多 PHP 实例，每个实例编译时指定独立的--with-openssl=/opt/ssl83路径 - Docker 场景下，为不同 PHP 版本构建专用基础镜像，预装好匹配的扩展二进制包（如
php8.3-redisDebian 包） - 避免在同一个 PHP 安装中混装多个大版本扩展（如同时装
redis.sov4 和 v5），Linux 动态链接器不会报错，但运行时大概率Segmentation fault
真正容易被忽略的一点是：离线环境里，composer install 成功不代表项目能跑起来。它只保证类文件存在、自动加载能注册，但不保证 ext-redis 的 Redis::connect() 方法在目标 PHP 中真的可调用——那取决于 redis.so 是否被正确加载、其依赖的 libhiredis.so 是否在 LD_LIBRARY_PATH 中、以及是否与当前 PHP ABI 兼容。这些，都得在离线前手动验证。
