直接运行 composer require predis/predis 即可安装最新稳定版，它支持 PHP 8.1+ 和 Redis 7，启用连接池与管道优化；老项目需 PHP 7.2/Redis 5 以下才指定 ^1.1。
用 Composer 安装 predis/predis 的正确命令
直接运行 composer require predis/predis 就行，不需要加版本号——除非你明确要锁定旧版。Predis 当前稳定版（如 v2.2+）已全面支持 PHP 8.1+ 和 Redis 7，新版默认启用连接池和管道优化，老项目若还卡在 PHP 7.2 或 Redis 5 以下，才需要指定 ^1.1。
常见错误现象：Class 'Predis\Client' not found，大概率是没执行 composer install 或自动加载没刷新，别急着重装，先跑一遍 composer dump-autoload。
- 如果项目已有
autoload配置（比如自定义了 PSR-4），确认没覆盖掉 vendor 目录的自动加载逻辑 - CI/CD 环境中记得加
--no-dev参数避免 dev 依赖干扰，但本地开发建议保留 - 国内服务器如果卡在下载，换源比改镜像配置更直接：临时加
-vvv看卡在哪，然后手动改composer.json的repositories字段为阿里云或腾讯云源
Predis\Client 初始化时必须注意的连接参数
不是所有 Redis 配置项都能直接传进 Predis\Client 构造函数。比如 timeout、read_write_timeout 必须写成小写键名，而 scheme、host、port 才是标准字段；填错会静默回退到默认值（如 timeout=0，导致请求卡死）。
典型使用场景：Laravel 外的原生 PHP 项目、Swoole 长连接服务、CLI 脚本批量操作缓存。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 密码带特殊字符（如
@、/）必须 URL 编码，否则解析 URL 时提前截断 —— 用rawurlencode()包一层再拼 DSN - 集群模式不能只写一个节点地址，得用
['tcp://127.0.0.1:7000', 'tcp://127.0.0.1:7001']数组形式传入，且必须开启replication或cluster选项 - 高并发下不设
retry_interval可能触发密集重连，建议设为0.1（秒）起步
为什么 $client->get() 返回 null 却没报错
null 是正常返回值，不代表连接失败或命令异常——它只表示 key 不存在。真正该检查的是底层连接状态和命令是否被 Redis 拒绝执行。
容易踩的坑：把 null 当作错误处理，结果掩盖了真实的网络超时或认证失败问题。
- 先调
$client->ping()确认连通性，返回+PONG才继续；否则捕获Predis\Connection\ConnectionException - 用
MONITOR命令在 Redis 侧看实际收到的指令，避免客户端拼错 key 名（比如多空格、大小写混淆） - 如果启用了 pipeline，
get()返回的是数组中的某个位置，不是直接值，得按顺序取索引
PHP-FPM 下长连接复用失效的真相
Predis 默认每次 new Predis\Client 都新建 TCP 连接，PHP-FPM 的每个 worker 进程里不会自动复用上一次的 socket。这不是 bug，是设计使然——它避免跨请求污染连接状态，但也带来开销。
性能影响明显：单次请求增减 2–5ms 网络延迟，在 QPS > 500 的接口里就是瓶颈。
- 不要试图在全局变量里存 client 实例，FPM 进程间不共享内存，反而可能引发连接泄漏
- 真要复用，得结合 Swoole 或 RoadRunner 这类常驻内存环境；或者用连接池组件（如
spiral/roadrunner-http+predis/predis自定义 pool） - 最简单有效的折中：把 client 实例存在
static属性里，限制 scope 在单个请求生命周期内，至少省掉重复解析配置的时间
