必须先安装并配置好Composer和PHP环境，再执行composer require predis/predis；若报错command not found或vendor目录未生成，说明环境缺失或未在项目根目录操作；装完需引入vendor/autoload.php才能使用Predis\Client类；连接失败多因Redis服务未运行或配置不匹配，与Predis安装无关。
直接装 predis/predis 不需要单独装 Composer，但必须先确保系统里有可用的 Composer 可执行文件。
Composer 本身没装好，composer require predis/predis 会报错
常见错误是 command not found: composer 或 php: command not found。这不是 predis 的问题，而是环境没配好。
- 先确认 PHP 已安装且版本 ≥ 7.3（
predis6.x 要求）：运行php -v - 再确认 Composer 是否可用：运行
composer --version；如果报错，去 getcomposer.org/download/ 下载最新composer.phar，然后用php composer.phar --version测试 - 推荐把
composer.phar放进系统 PATH（比如 Linux/macOS 放到/usr/local/bin/composer，Windows 加入环境变量），否则每次都要敲php composer.phar
composer require predis/predis 执行后没生成 vendor 目录
说明当前目录不是 Composer 项目根目录——即没有 composer.json 文件，或它被误删了。
- 进入你自己的项目目录（比如
/var/www/myapp），不要在空文件夹或系统根目录下执行 - 如果目录下没有
composer.json，先运行composer init初始化一个（按提示填包名、描述等，可一路回车用默认值） - 再执行
composer require predis/predis，它会自动写入依赖并下载到vendor/ - 执行完检查：
ls vendor/predis/predis/src/Client.php存在才算真正装成功
装完 predis 却 new Predis\Client() 报类找不到
根本原因：PHP 没加载 Composer 的自动加载器。这不是扩展没启用，而是代码里漏了 require。
- 必须在使用前引入自动加载文件：
require 'vendor/autoload.php'; -
Predis\Client类名要完整写，不能只写Client（除非用了use声明） - 典型正确写法：
require 'vendor/autoload.php';
$client = new Predis\Client([
'scheme' => 'tcp',
'host' => '127.0.0.1',
'port' => 6379,
]);
如果连 vendor/autoload.php 都报“no such file”，说明前面两步（初始化 + require）没走对，别跳步骤。
装了 predis 但连接 Redis 失败，提示 Connection refused
这是最常被当成 predis 安装问题的真·环境问题。Predis 只负责发请求，不负责起 Redis 服务。
- 先确认 Redis 服务进程在运行：
redis-cli ping返回PONG才算通 - 如果
redis-cli都找不到，说明 Redis 没装或没启动（Linux 查ps aux | grep redis，Windows 看服务列表里 Redis 是否 Running） - Predis 默认连
127.0.0.1:6379，如果你改过 Redis 的bind或port，必须同步改 Predis 的配置数组 - 远程连接失败？检查 Redis 配置里
bind 0.0.0.0和protected-mode no是否已设（仅测试环境这么做）
路径、权限、防火墙、SELinux —— 这些都比 composer require 多得多，别让网络层问题反向污染对依赖管理的认知。
