ubuntu thinkphp如何配置redis

ubuntu

小樊

2026-10-04 14:25:48

栏目: 云计算

在 Ubuntu 上使用 ThinkPHP 配置 Redis，一般分为 安装 Redis → 安装 PHP Redis 扩展 → 配置 ThinkPHP 三步。下面以 ThinkPHP 6 / 8 为例（5.1 类似）。

一、安装 Redis（Ubuntu）

sudo apt update
sudo apt install redis-server

启动并设置开机自启：

sudo systemctl start redis
sudo systemctl enable redis

测试 Redis：

redis-cli ping
# 返回 PONG 表示成功

二、安装 PHP Redis 扩展

1️⃣ 查看 PHP 版本

php -v

2️⃣ 安装 Redis 扩展

sudo apt install php-redis

如果是 PHP 8.x，通常是 php8.1-redis、php8.2-redis

重启 PHP：

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.1-fpm

验证：

php -m | grep redis

三、ThinkPHP 配置 Redis

方式一：作为缓存（最常用）

编辑配置文件：

config/cache.php

示例配置：

return [
    'default' => 'redis',

    'stores' => [
        'redis' => [
            'type'       => 'redis',
            'host'       => '127.0.0.1',
            'port'       => 6379,
            'password'   => '',
            'select'     => 0,
            'timeout'    => 0,
            'persistent' => false,
        ],
    ],
];

使用示例：

use think\facade\Cache;

Cache::set('name', 'thinkphp', 3600);
echo Cache::get('name');

方式二：作为 Session 存储

编辑：

config/session.php

return [
    'type'   => 'redis',
    'host'   => '127.0.0.1',
    'port'   => 6379,
    'password' => '',
    'select' => 1,
];

方式三：直接使用 Redis 对象

use think\facade\Cache;

$redis = Cache::store('redis')->handler();
$redis->set('test', 'hello');
echo $redis->get('test');

四、常见问题

❌ Redis 连不上

确认 redis-server 已启动
检查防火墙
确认 bind 127.0.0.1 没被改错

❌ Class not found

说明 PHP Redis 扩展没装好，重装扩展并重启 PHP。

如果你用的是 ThinkPHP 5.1 / 6 / 8，或者 Docker / LNMP，可以告诉我，我可以给你更精确配置。