必须分别安装redis和memcached服务端及对应php扩展,漏任一环节会导致new redis()或new memcached()报错;redis需在软件商店装服务端再为php装扩展并重载配置;memcached推荐命令行安装服务端,再装php扩展、检查禁用函数、重载配置。

要在宝塔面板中为网站启用高性能内存缓存,必须分别安装Redis服务端、Memcached服务端,再为对应PHP版本安装配套的redis和memcached扩展——漏掉任一环节都会导致new Redis()或new Memcached()报错类未定义。
安装Redis服务端与PHP扩展
第一步:登录宝塔面板 → 左侧菜单点击「软件商店」→ 顶部切换到「全部软件」标签页 → 在搜索框输入redis → 找到官方提供的「Redis」(注意图标是红色R,非插件类扩展)→ 点击右侧「安装」按钮 → 等待状态变为「运行中」。
第二步:回到软件商店 → 点击顶部「PHP」标签页 → 找到当前站点所用的PHP版本(如PHP 8.1)→ 点击其右侧「设置」→ 切换到「安装扩展」选项卡 → 在列表中找到redis(名称不含下划线、不带版本号后缀)→ 点击「安装」→ 安装完成后务必点击右上角「重载配置」,否则phpinfo()中不会显示redis支持。
注意:如果安装后仍提示Class 'Redis' not found,请检查PHP版本是否与站点实际使用的一致;若使用多版本PHP,需为每个用到Redis的版本单独安装扩展。
安装Memcached服务端与PHP扩展
方法一:命令行安装(推荐,避免宝塔软件商店混淆)
SSH登录服务器 → 执行:
CentOS系统:yum install -y memcached
Ubuntu/Debian系统:apt install -y memcached
安装完成后执行systemctl start memcached && systemctl enable memcached → 再用netstat -tuln | grep :11211确认端口已监听。
方法二:宝塔软件商店安装(仅限宝塔8.0+且已开启服务端源)
软件商店 → 搜索「Memcached」→ 注意识别图标为蓝色M、类型为「服务端」的条目(非PHP扩展)→ 点击安装 → 安装完成状态必须为「运行中」。
【关键前提】必须先装服务端,再装PHP扩展;若先点PHP设置里的memcached扩展,会因缺少服务端而安装失败或假成功。
为PHP启用memcached扩展
① 进入软件商店 → PHP标签页 → 找到对应PHP版本 → 点击「设置」→ 切换至「安装扩展」选项卡。
② 在扩展列表中定位memcached(不是memcache,末尾无e,不带横杠)→ 点击安装。
③ 安装完毕后,立即切换到「禁用函数」选项卡 → 检查memcached_connect是否在禁用列表中 → 若存在,须手动删除该项,否则WordPress等程序连接会静默失败。
④ 最后点击页面右上角「重载配置」,强制刷新PHP运行时环境。
这一步操作起来很简单,但跳过「禁用函数」检查会导致缓存功能看似启用实则完全不工作,且无任何错误提示。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











