composer报ext-redis未找到不是其自身问题，而是php环境未启用该c扩展；需通过php -m验证、apt或pecl安装对应版本扩展、修改php.ini启用，并重启服务后重新执行composer require。
composer require 报 ext-redis 未找到，不是 Composer 的错
Composer 本身不装 C 扩展，只检查它是否存在。当你执行 composer require predis/predis 或 composer require illuminate/redis 时，如果项目声明了 "ext-redis": "*"（常见于 Laravel 10+ 或某些包的 composer.json 中），而你的 PHP 环境没启用 redis 扩展，就会直接报错：Package ext-redis is required and cannot be found。
这不是依赖写错了，也不是网络问题，而是底层缺失。此时 composer require 会中止，连 vendor/ 目录都不会生成。
- 先运行
php -m | grep redis，没输出就说明扩展没加载 - 别急着重装 PHP 或删 vendor，先确认扩展是否已安装但未启用
- 检查
php --ini输出的配置文件路径，再打开对应php.ini，确认是否有extension=redis.so（Linux/macOS）或extension=php_redis.dll（Windows）
Ubuntu/Debian 上装 redis.so，用 apt 最稳
系统级 C 扩展首选包管理器安装，省去编译环境、头文件、PHP dev 版本匹配等麻烦。Ubuntu 22.04+ 和 Debian 12+ 已把扩展按 PHP 版本分包，比如 PHP 8.3 就得装 php8.3-redis，而不是笼统的 php-redis。
执行前先确认当前 CLI 使用的 PHP 版本：php -v，再选对应包：
sudo apt update-
sudo apt install php8.3-redis（替换成你实际的 PHP 主版本号） - 装完不用手动改
php.ini，apt 会自动在/etc/php/8.3/cli/conf.d/redis.ini里写好extension=redis.so - 验证：
php -m | grep redis应有输出；php -i | grep "redis version"可看具体版本
pecl install redis 在没 apt 包时才考虑
CentOS Stream / Rocky Linux / Alpine 或自编译 PHP 的场景下，pecl install 是备选方案，但它要求你已有完整的编译工具链和 PHP 头文件（php-devel 或 php-dev）。漏掉任一依赖，就会卡在 configure: error: Cannot find php-config 或 make: *** [Makefile:193: redis.lo] Error 1。
以 Alpine 为例（Docker 常见）：
-
apk add php83-dev autoconf automake g++ make（注意 PHP 版本后缀） pecl install redis- 装完需手动加
extension=redis.so到php.ini，Alpine 默认无该文件，常放/etc/php83/php.ini或通过echo "extension=redis.so" > /etc/php83/conf.d/redis.ini - 重启 PHP-FPM 或 Web 服务才能生效，CLI 模式可能立即可用，但 Web 请求仍走旧进程
装完 C 扩展后，composer require 才真正开始干活
C 扩展启用后，composer require 不会重试失败步骤，必须重新执行命令。但要注意：它只负责 PHP 类库部分，不碰扩展本身。
- 确保当前 shell 的
php命令指向你要用的 PHP 版本（比如/usr/bin/php8.3而非/usr/bin/php），否则composer require可能用错 CLI 环境检测 - 若项目用了
platform配置（如"config": {"platform": {"php": "8.2.0"}}），而你装的是 8.3 的扩展，Composer 仍会报错——它按配置模拟环境，不读真实 PHP - 装完扩展后首次运行
composer require，仍可能因 autoload 冲突报Class not found，这时要跑composer dump-autoload刷新映射，尤其当包含自定义 autoloader 或修改过composer.json的autoload段
C 扩展和 Composer 是两层事：一层在 PHP 解释器里，一层在 PHP 代码里。很多人卡在中间，以为是 composer 命令的问题，其实只是 php.ini 少了一行，或者 php -m 没刷出来。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
