Redis 是一个高性能的键值数据库，常用于缓存加速、会话存储等场景。在使用宝塔面板搭建网站时，如果项目需要连接 Redis 数据库，除了安装 Redis 服务外，还需要在 PHP 中安装 Redis 扩展，以便 PHP 可以与 Redis 进行通信。
安装步骤
| 步骤 |
操作说明 |
| 1 |
登录宝塔面板，进入【软件商店】 |
| 2 |
找到已安装的 PHP 版本（如 PHP-7.4），点击【设置】 |
| 3 |
切换到【安装扩展】选项卡 |
| 4 |
在搜索框中输入 “redis” |
| 5 |
点击【安装】按钮开始安装 Redis 扩展 |
| 6 |
安装完成后，在【禁用函数】中检查是否有 exec、popen 等被禁用，部分 Redis 扩展依赖这些函数 |
安装 Redis 服务（可选）
如果你的服务器尚未安装 Redis 服务，可通过以下方式安装：
| 步骤 |
操作说明 |
| 1 |
回到【软件商店】，搜索“Redis” |
| 2 |
点击【安装】按钮安装 Redis 服务 |
| 3 |
安装完成后，可在【服务】中启动 Redis，并设置开机自启 |
| 4 |
如需远程访问 Redis，请修改 /www/server/redis/redis.conf 中的 bind 127.0.0.1 为 0.0.0.0 并重启 Redis |
常见问题及解决办法
| 问题描述 |
解决办法 |
| 安装 Redis 扩展时报错 |
确保系统已安装宝塔推荐的编译环境（如 GCC、make 等），或尝试更换 PHP 版本 |
| PHP无法连接 Redis |
检查 Redis 是否启动；确认连接地址和端口是否正确（默认 6379） |
| 提示 Class 'Redis' not found |
确认 Redis 扩展已安装并启用，重启 PHP 服务后生效 |
| Redis 服务启动失败 |
查看 Redis 日志，检查是否端口冲突或配置文件错误 |
总结
通过宝塔面板可以快速安装 Redis 扩展和 Redis 服务，提升开发效率。安装过程中应注意 PHP 版本兼容性、服务启动状态以及防火墙规则。建议在生产环境中关闭 Redis 的远程访问或设置密码保护，以提高安全性。
标签：宝塔面板- Redis扩展- PHP扩展- Redis安装- 服务器配置
更新时间：2025-05-15 12:27:12
上一篇：宝塔面板开启SSL后经常无法访问该如何解决？有哪些常见处理办法？
下一篇：CentOS7 安装 PHP 8.1 报错：BROTIL libs and/or directories were not found where specified，如何解决？
转载请注明原文链接：https://www.muzicopy.com/suibi/12339.html
