Redis教程|ThinkPHP5L实战：一步步实现TP5L连接Redis的方法

Redis教程 | ThinkPHP5L实战：一步步实现TP5L连接Redis的方法

场景引入：当数据库查询成为性能瓶颈

"小王，这个商品列表页面怎么加载这么慢啊？"产品经理皱着眉头问道。

作为开发团队的新人，小王最近接手了电商平台的性能优化工作，他打开开发者工具一看，发现每次刷新页面都要执行几十条SQL查询，尤其是商品分类和热门推荐这些几乎不变的数据,也在反复查询数据库。

"这种情况，Redis就能派上用场了！"隔壁工位的老张探过头来说道。

确实，Redis作为内存数据库，读写速度极快，特别适合缓存频繁访问但很少变化的数据，今天我们就来聊聊如何在ThinkPHP5L框架中集成Redis,为你的应用提速。

第一步：环境准备与Redis安装

在开始之前,确保你的开发环境已经满足以下条件：

1. PHP版本7.1或更高（ThinkPHP5L的要求）
2. 已安装Redis服务器（本地或远程）
3. PHP已安装Redis扩展

安装Redis服务器（以Ubuntu为例）：

sudo apt update
sudo apt install redis-server
sudo systemctl enable redis-server
sudo systemctl start redis-server

检查Redis是否运行：

redis-cli ping
# 如果返回PONG，说明Redis已正常运行

安装PHP Redis扩展：

sudo apt install php-redis
sudo systemctl restart apache2  # 或你使用的Web服务器

第二步：ThinkPHP5L配置Redis

ThinkPHP5L已经内置了对Redis的支持,我们只需要进行简单配置即可。

1. 打开config/cache.php文件
2. 找到或添加Redis配置：

'redis' => [
    'type'   => 'redis',
    'host'   => '127.0.0.1',
    'port'   => 6379,
    'password' => '',    // 如果有设置密码
    'select' => 0,       // 数据库编号
    'timeout' => 0,
    'expire' => 0,
    'persistent' => false,
    'prefix' => 'tp5l_', // 缓存前缀
],

将默认缓存驱动改为Redis：

'default' => env('cache.driver', 'redis'),

第三步：基础使用示例

缓存数据

use think\facade\Cache;
// 缓存字符串
Cache::set('username', '张三', 3600); // 缓存1小时
// 缓存数组
$userInfo = ['name' => '李四', 'age' => 28];
Cache::set('user_info', $userInfo);
// 判断缓存是否存在
if (Cache::has('username')) {
    // 获取缓存
    $name = Cache::get('username');
    echo $name;
}

商品分类缓存示例

// 获取商品分类
public function getCategories()
{
    $cacheKey = 'product_categories';
    // 先尝试从缓存获取
    $categories = Cache::get($cacheKey);
    if (empty($categories)) {
        // 缓存不存在，从数据库查询
        $categories = Db::name('product_category')
                      ->where('status', 1)
                      ->order('sort_order', 'asc')
                      ->select();
        // 存入缓存，有效期1天
        Cache::set($cacheKey, $categories, 86400);
    }
    return $categories;
}

第四步：高级用法

Redis原生操作

ThinkPHP5L的Cache门面提供了基本操作,但有时我们需要直接使用Redis更丰富的功能：

$redis = Cache::store('redis')->handler();
// 使用Redis原生命令
$redis->hSet('user:1', 'name', '王五');
$redis->expire('user:1', 3600);
// 获取哈希表所有字段
$userData = $redis->hGetAll('user:1');

实现简单的分布式锁

/**
 * 获取分布式锁
 * @param string $lockKey 锁的键名
 * @param int $expire 锁的过期时间(秒)
 * @return bool 是否获取成功
 */
function acquireLock($lockKey, $expire = 10)
{
    $redis = Cache::store('redis')->handler();
    $identifier = uniqid();
    if ($redis->setnx($lockKey, $identifier)) {
        $redis->expire($lockKey, $expire);
        return $identifier;
    }
    return false;
}
/**
 * 释放分布式锁
 */
function releaseLock($lockKey, $identifier)
{
    $redis = Cache::store('redis')->handler();
    // 使用Lua脚本保证原子性
    $script = "
        if redis.call('get', KEYS[1]) == ARGV[1] then
            return redis.call('del', KEYS[1])
        else
            return 0
        end
    ";
    return $redis->eval($script, [$lockKey, $identifier], 1);
}

第五步：性能优化建议

1. 合理设置过期时间：根据数据更新频率设置合适的缓存时间，避免数据不一致

2. 使用批量操作：减少网络往返时间

   

   $redis->multi()
         ->set('key1', 'value1')
         ->set('key2', 'value2')
         ->exec();

3. 避免大Key：单个Key的Value不宜过大，建议控制在1MB以内

4. 使用管道(Pipeline)：当需要执行多个命令时

   $redis->pipeline(function($pipe) {
       $pipe->set('key1', 'val1');
       $pipe->get('key1');
   });

5. 监控内存使用：定期检查Redis内存占用，避免OOM

常见问题排查

Q1：连接Redis失败

• 检查Redis服务是否运行
• 检查配置中的host和port是否正确
• 检查防火墙设置

Q2：写入缓存成功但读取为空

• 检查缓存前缀是否冲突
• 检查是否有其他程序在删除你的key
• 检查Redis内存是否已满（使用info memory命令）

Q3：性能没有明显提升

• 确认瓶颈确实在数据库查询
• 检查缓存命中率（使用info stats命令查看keyspace_hits和keyspace_misses）
• 考虑是否适合使用缓存（频繁变化的数据可能不适合）

通过本文的步骤，你应该已经成功在ThinkPHP5L项目中集成了Redis，Redis虽好，但也不是银弹，合理使用缓存策略,才能为你的应用带来最佳的性能提升效果。

小王按照这个方法改造了商品分类和热门推荐模块后，页面加载时间从原来的2秒多降到了500毫秒以内,产品经理终于露出了满意的笑容。

"原来这就是Redis的魔力啊！"小王感叹道,你也快来试试吧！