Redis 是一个开源的 NoSQL 数据库,以一个 key 对应一个 value 的方式并配合内存(RAM)来保存数据,性能要比关系数据库还要好很多,可以在许多编程语言上使用。Redis 的 value 除了字符串(string)型态之外,另外还有几种比较特殊的结构,包括 set、zset、list 和 hash,并提供了多种方式来操作这些字段。

安装 Redis

要在 Ubuntu Server 上安装 Redis 的服务器,可以直接在终端机中运行以下指令:

sudo apt install redis-server

以 apt 安装 redis-server

Redis 服务器预设使用的 TCP 连接端口为 6379,可以使用以下指令来查看 Redis 服务器是否有确实安装成功。

sudo ss -tlnp | grep redis

ss 指令可以显示出 Socket 相关的信息。-l 参数可以只显示正在监听中的连接。若使用 ss 指令时都没给任何参数的话,会忽略掉监听中的连接。-t 参数可以只显示 TCP 连接。-n 参数可以让连接端口数字直接被输出,而不是用一个名称代替。-p 参数可以显示占用连接的进程。

以 ss 确认 Redis 监听连接端口 6379

如上图,如果有看到 TCP 有在监听连接端口 6379,就表示 Redis 服务器安装成功了!

设置 Redis

Redis 服务器的设置档路径为 /etc/redis/redis.conf。它预设的模样长成这样:

/etc/redis/redis.conf 的预设内容

比较重要的设置项目有:

  • bind:若要远程连入 Redis 服务器,就会需要设置这个项目。参考这篇文章。
  • supervised:设置运行 Redis 的 init system。默认值是 no,虽然 no 好像也能正常运作,但最好改成 systemd,来让我们的 init system 能够正确追踪 Redis 是否还在正常运作。
  • databases:设置可用的数据库数量,在索引的时候是从 0 开始数,预设会使用索引值为 0 的数据库。这个项目的默认值是 16,表示这个 Redis 服务器可以使用 16 个数据库。
  • save:设置在一定的间隔时间内若数据库有发生一定程度的改变,就将内存中当下的数据存成文件(快照)。save 的撰写格式为 save <seconds> <changes>,save 60 10000 表示在 60 秒内至少有 10000 个 key 被改变则做一次快照。快照的预设保存路径为 /var/lib/redis/dump.rdb。
  • requirepass:设置客户端与 Redis 服务器连接时所需要的密码。预设没有设置,表示不激活密码验证功能。
  • maxclients:设置最大连接数。预设没有设置,当作 10000。
  • maxmemory:设置最大的内存使用量,如果内存用量达到限制,就会根据 maxmemory-policy 项目设置的策略来尝试移除 key,如果无法移除,就会使该次插入或修改的操作回传错误。预设没有设置,表示不限制。
  • maxmemory-policy:内存用量达到限制时采取的策略。预设没有设置,当作 noeviction,不移除 key。其它策略如下:
    • volatile-lru:根据 LRU 算法移除有设置过期时间的 key。
    • allkeys-lru:根据 LRU 算法移除 key。(不管有没有设置过期时间)
    • volatile-lfu:根据 LFU 算法移除有设置过期时间的 key。
    • allkeys-lfu:根据 LFU 算法移除 key。(不管有没有设置过期时间)
    • volatile-random:随机移除有设置过期时间的 key。
    • allkeys-random:随机移除 key。(不管有没有设置过期时间)
    • volatile-ttl:移除有设置过期时间的 key 中,TTL 最小的 key。

套用 Redis 的新设置

改写 Redis 设置档并存盘后,新设置并不会立即套用给正在运行中的 Redis 服务器。

要让 Redis 服务器重新读取设置档,最好先用以下指令检查设置档是否无误,避免 Redis 服务器因为设置档错误而中断服务。

redis-server /etc/redis/redis.conf

以 redis-server 检查设置档

接着再运行以下指令来重新加载 Redis 的设置档:

sudo systemctl restart redis

以 systemctl restart 重新启动 Redis

Redis 客户端与 Redis 命令的使用方式

redis-cli 是 Redis 的客户端指令工具。运行以下指令与 Redis 服务器进行连接:

redis-cli

以 redis-cli 连接 Redis

如果有设置 requirepass,要在 Redis 的 Shell 中使用 auth 指令来验证密码。例如密码为 foobared,就要输入以下指令。

auth foobared

以 auth 验证密码

接着就可以开始输入 Redis 的命令来操作 Redis 数据库。

例如以下命令,可以创建一组 key 为 foo、value 为 bar 的数据至预设的数据库 0。

set foo bar

而以下命令,可以取得 key 为 foo 的数据。

get foo

以 set 与 get 访问数据

以下命令可以查看所有数据库的 key 的数量。

info keyspace

以 info keyspace 查看 key 的数量

在 PHP 程序中访问 Redis 数据库

如果您不知道如何在 Ubuntu Server 运行 PHP 程序,可以先参考这篇文章:

要在 PHP 程序中访问 Redis 数据库,需要有 Redis 相关模块的支持。利用以下指令可以查看目前 PHP 环境中有的模块:

php -m

以 php -m 查看 PHP 模块

如上图,并没有看到有 Redis 相关模块的存在,所以要使用以下指令来安装:

sudo apt install php-redis

以 apt 安装 php-redis

安装完后,就可以透过 php -m 指令看到 Redis 相关模块了。

安装后出现 Redis 相关模块

Redis 在 PHP 中的用法如下:

<?php    
    $redis = new Redis();
    $redis->connect('127.0.0.1', 6379);
            
    $redis->set("foo", "bar");
    echo $redis->get("foo");                                                         
?>

API 文档:

phpRedisAdmin

phpRedisAdmin 是使用 PHP+Redis 环境时经常会使用的管理后台,不过并不是必要项目。如果您不需要,可以略过这部份的内容。

安装 php-mbstring

phpRedisAdmin 会用到 php-mbstring 模块,所以要先用以下指令来安装:

sudo apt install php-mbstring

以 apt 安装 php-mbstring

安装 phpRedisAdmin

在终端机运行以下指令,来取得 Composer:

curl -fsSL http://getcomposer.org/installer | php

以 curl 下载 Composer

接着运行以下指令,将 phpRedisAdmin 安装至 /usr/local/share/phpredisadmin 目录中。

sudo php composer.phar create-project -s dev erik-dubbelboer/php-redis-admin /usr/local/share/phpredisadmin

以 Composer 安装 phpRedisAdmin

运行以下指令拷贝 phpRedisAdmin 的设置档范本。

sudo cp /usr/local/share/phpredisadmin/includes/config.sample.inc.php /usr/local/share/phpredisadmin/includes/config.inc.php

拷贝 phpRedisAdmin 的设置档范本

/usr/local/share/phpredisadmin/includes/config.inc.php 文件就是 phpRedisAdmin 的设置档啦!它预设的模样长成这样:

config.inc.php 的预设内容

如果 phpRedisAdmin 和 Redis 服务器是运行在同一个操作系统内,建议可以将设置档中 scheme 字段的值改成 unix。如果 Redis 服务器有设置 requirepass,要去修改设置档中的 auth 字段。

设置 Nginx

phpRedisAdmin 的 PHP 程序放置在 /usr/local/share/phpredisadmin 目录中,我们可以利用 Nginx 设置档的 root 命令来制作一个 phpRedisAdmin 的 location 区块。设置方式如下:

server {
    index index.html index.php;

    set $php_uds unix:/run/php/php7.4-fpm.sock;

    location ~ \.php$ {
        fastcgi_pass $php_uds;
        include fastcgi.conf;
    }

    location = /phpredisadmin {
        return 301 /phpredisadmin/;
    }

    location ^~ /phpredisadmin/ {
        root /usr/local/share;
       
        allow 127.0.0.1;
        deny all;
       
        if ($uri ~ \.php$) {
            fastcgi_pass $php_uds;
        }   
       
        include fastcgi.conf;
    }
}

如此一来就可以在同一台主机透过 HTTP 协定发送路径前缀为 /phpredisadmin/ 的请求来打开 phpRedisAdmin。如下图:

phpRedisAdmin 的管理界面

加上 allow 和 deny 命令是为了要避免 phpRedisAdmin 被有心人士攻击。如果要在别台主机使用 phpRedisAdmin,可以加上更多的 allow 命令,或者干脆改用 HTTP 基本认证(帐密认证)。

事实上 phpRedisAdmin 本身就有提供帐密认证的功能,可以在设置档中找到相关的设置字段,但笔者会建议透过 Nginx 来统一设置帐密认证。

套用 Nginx 的新设置

改写 Nginx 设置档并存盘后,新设置并不会立即套用给正在运行中的 Nginx 服务器。

要让 Nginx 服务器重新读取设置档,最好先用以下指令检查设置档是否无误,避免 Nginx 服务器因为设置档错误而中断服务。

sudo nginx -t

以 nginx -t 检查设置档

接着再运行以下指令来重新加载 Nginx 的设置档:

sudo nginx -s reload

以 nginx -s reload 重新加载设置

phpRedisAdmin 和 Redis 服务器不在同一个操作系统上

若要让 phpRedisAdmin 连到其它操作系统或是其它主机上的 Redis 服务器,就要去修改 phpRedisAdmin 的 /usr/local/share/phpredisadmin/includes/config.inc.php 设置档中的 host 和 port 字段,以及将 scheme 字段的值设为 tcp。