Composer报“PHP extension xxx is missing”错误，是因为它在安装前校验运行时必需的扩展是否已加载且版本匹配，而非负责安装扩展；需手动安装、启用并验证生效，三步缺一不可。
Composer 不会编译、安装或配置任何 C 语言扩展，它只检查这些扩展是否已在 PHP 环境中加载且版本匹配。你看到的 ext-redis 或 ext-swoole 声明，只是运行时守门员，不是安装工。
为什么 composer install 会报 “PHP extension xxx is missing”
这是 Composer 在依赖解析完成后、写入 vendor/ 前做的最后一道环境校验。它读取 composer.json 中 require 下所有 ext-* 条目，然后调用 extension_loaded() 和 phpversion() 检查。
- 报错不意味着 Composer 能帮你装——它连
pecl都不会调用 - 即使你本地
php -m | grep redis有输出，但 CLI 和 FPM 使用不同php.ini，也可能只在其中一个环境下通过 -
composer install --ignore-platform-req=ext-redis可临时跳过，但运行时仍会Fatal error - 错误信息里写的扩展名（如
redis）必须和php -m输出的完全一致，大小写敏感，不带ext-前缀
如何让 C 扩展真正可用：三步缺一不可
手动安装 ≠ 启用 ≠ 生效。常见断点就卡在这三步中的某一个。
-
安装：用系统包管理器（
apt install php-redis）、pecl install redis，或源码编译（phpize && ./configure && make && sudo make install） -
启用：确认
.so文件路径正确（php -i | grep extension_dir），并在对应php.ini（CLI/FPM 分开）中添加extension=redis.so -
生效：重启 PHP-FPM 或 Web 服务器；验证用
php -r "echo extension_loaded('redis') ? 'yes' : 'no';"，别只信php -m
CI/CD 和 Docker 中最容易漏掉的点
本地能跑，CI 报错，90% 是因为没在构建阶段显式安装扩展，或用了错的 PHP SAPI 配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“C语言免费学习笔记（深入）”；
- Dockerfile 中不能只写
RUN apt-get install -y php-redis，还要确认该包是否真把.so放进当前 PHP 版本的extension_dir（不同 PHP 小版本路径可能不同） - GitHub Actions 或 GitLab CI 里，
php -v和php --ini必须作为调试第一步执行，否则你根本不知道用的是哪个php.ini - Alpine 镜像要用
apk add php83-redis（注意 PHP 主版本号后缀），而不是通用php-redis - 如果用
docker-compose up启动多个服务，确保 PHP 容器启动前，扩展已就位——有些镜像（如php:8.3-cli）默认不带任何扩展
platform 配置只影响依赖解析，不解决运行时缺失
"config": {"platform": {"ext-redis": "5.3.7"}} 的作用，是在 composer update 时假装这个扩展存在，从而让依赖解析器能继续往下算——但它不会阻止 composer install 实际运行时的检查，也不会让扩展真的出现。
- 这个配置对私有包或未声明
ext-redis依赖的上游包无效 - 它常被误用于“绕过 CI 报错”，结果上线后立刻崩，因为生产环境真没装
- 真正该用
platform的场景是：你在 PHP 8.4 开发，但目标服务器只有 PHP 8.1，想提前锁死兼容版本——它管的是“选哪个包”，不是“装哪个扩展”
最常被忽略的是：同一个扩展名（如 redis）在不同 PHP 版本下，.so 文件名、php.ini 加载方式、甚至扩展 API 都可能变化。别假设本地装过一次，就能跨版本复用。
