0

0

composer怎么安装Redis扩展依赖包_composer引入phpredis客户端库【方法】

穿越時空

穿越時空

发布时间:2026-01-12 15:22:14

|

609人浏览过

|

来源于php中文网

原创

composer require phpredis 不生效,因phpredis是C扩展而非PHP包;需先手动安装redis.so扩展,再用predis/predis等纯PHP客户端或配置框架切换驱动。

composer怎么安装redis扩展依赖包_composer引入phpredis客户端库【方法】

composer require phpredis 扩展包不生效?先确认 PHP 环境是否已装好 redis 扩展

直接运行 composer require phpredis 会失败,因为 phpredis 不是纯 PHP 包,而是 PHP 的 C 扩展(即 redis.so),composer 只能管理用户空间的类库,不能安装或启用底层扩展。

你真正需要的是两步:① 让 PHP 加载 redis 扩展;② 在项目中使用封装好的客户端(如 predis/predis 或适配器)。

  • phpredis 是 PHP 官方 C 扩展,性能高,但需编译安装,不通过 Composer 分发
  • predis/predis 是纯 PHP 实现的 Redis 客户端,可直接 composer require predis/predis
  • 很多框架(Laravel、Symfony)默认适配 predis,也支持切换为 phpredis 驱动

用 Composer 安装 Predis 客户端:composer require predis/predis

这是最常用、最省事的方式,尤其适合开发环境、Docker、共享主机等无法装 C 扩展的场景。

composer require predis/predis

安装后即可在代码中使用:

立即学习PHP免费学习笔记(深入)”;

$client = new Predis\Client([
    'scheme' => 'tcp',
    'host'   => '127.0.0.1',
    'port'   => 6379,
]);
$client->set('foo', 'bar');
echo $client->get('foo'); // bar
  • 无需额外配置 PHP 扩展,兼容 PHP 7.4–8.3
  • 支持连接池、集群、哨兵等高级模式(需显式配置)
  • 注意:生产环境高并发下,predisphpredis 略慢(约 10–20%),但多数业务无感

想用原生 phpredis 扩展?必须手动安装系统级扩展

如果你坚持要用 phpredis(比如 Laravel 配置 REDIS_CLIENT=phpredis),就必须让 PHP 进程加载 redis.so,这和 Composer 无关。

Brizy
Brizy

Brizy是一个面向机构和 SaaS 的白标网站生成器,可以在几分钟内创建网站页面。

下载
  • Ubuntu/Debian:sudo apt install php-redis(自动启用)
  • CentOS/RHEL:sudo yum install php-pecl-redisdnf install php-pecl-redis
  • macOS(Homebrew + PHP):pecl install redis,然后确认 extension=redis.sophp.ini 中已开启
  • Windows:下载对应 PHP 版本的 php_redis.dll,放入 ext/ 目录并修改 php.ini

验证是否成功:

php -m | grep redis

输出 redis 即表示扩展已加载。此时 Composer 不需要再装什么 —— 项目里直接 new \Redis() 就行。

Laravel 中切换 Redis 驱动:改配置比换包更重要

Laravel 默认用 predis,但你可以切到 phpredis 提升性能,关键不是 Composer 命令,而是两处配置:

  • 确保 PHP 已加载 redis 扩展(上一步已验证)
  • 修改 .envREDIS_CLIENT=phpredis
  • 检查 config/database.phpredis 配置块的 'client' => env('REDIS_CLIENT', 'predis')

不需要 composer require 任何新包 —— Laravel 自带对两种客户端的抽象支持。如果强行 composer require phpredis,只会报错 “Package phpredis not found”。

容易被忽略的一点:有些 Docker 镜像(如 php:8.2-cli)默认不含 redis 扩展,即使你 composer require predis/predis 成功,也得看实际运行时用的是哪个客户端 —— phpinfo()php -m 才是真相。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2431

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1557

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1456

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1414

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1305

2023.11.13

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

10

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号