普贤教程 › 包参考

redis 包

Redis 客户端（RESP 协议）

纯 .px 实现 RESP（REdis Serialization Protocol），双模式一致。

项	值
包名	`redis`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`redis.px`
分类	`数据库`
文件数 / 行数	`1 / 365`

安装与引入

bash

pxpkg init          # 首次
pxpkg add redis@0.2.0
pxpkg install

import redis

所属分类教程：数据库

公开接口

函数	参数
`redis_connect`	`host, port, opts={}`
`redis_cmd`	`conn, args`
`redis_ping`	`conn`
`redis_set`	`conn, key, val`
`redis_get`	`conn, key`
`redis_del`	`conn, keys`
`redis_incr`	`conn, key`
`redis_ttl`	`conn, key`
`redis_select`	`conn, db`
`redis_close`	`conn`

其余 48 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`rd_recv_n`	`fd, n`
`rd_recv_line`	`fd`
`rd_read_reply`	`fd`
`rd_encode`	`args`
`redis_expire`	`conn, key, seconds`
`redis_exists`	`conn, key`
`redis_keys`	`conn, pattern`
`redis_type`	`conn, key`
`redis_decr`	`conn, key`
`redis_incrby`	`conn, key, amount`
`redis_mset`	`conn, pairs`
`redis_mget`	`conn, keys`
`redis_hset`	`conn, key, field, value`
`redis_hget`	`conn, key, field`
`redis_hdel`	`conn, key, field`
`redis_hexists`	`conn, key, field`
`redis_hgetall`	`conn, key`
`redis_hkeys`	`conn, key`
`redis_hvals`	`conn, key`
`redis_hlen`	`conn, key`
`redis_lpush`	`conn, key, value`
`redis_rpush`	`conn, key, value`
`redis_lpop`	`conn, key`
`redis_rpop`	`conn, key`
`redis_lrange`	`conn, key, start, stop`
`redis_llen`	`conn, key`
`redis_sadd`	`conn, key, member`
`redis_srem`	`conn, key, member`
`redis_smembers`	`conn, key`
`redis_sismember`	`conn, key, member`
`redis_scard`	`conn, key`
`redis_zadd`	`conn, key, score, member`
`redis_zrange`	`conn, key, start, stop`
`redis_zscore`	`conn, key, member`
`redis_zrem`	`conn, key, member`
`redis_publish`	`conn, channel, message`
`redis_subscribe`	`conn, channel`
`redis_unsubscribe`	`conn, channel`
`redis_scan`	`conn, cursor, pattern=""`
`redis_multi`	`conn`
`redis_exec`	`conn`
`redis_discard`	`conn`
`redis_set_ex`	`conn, key, val, seconds`
`redis_set_nx`	`conn, key, val`
`redis_set_xx`	`conn, key, val`
`redis_getset`	`conn, key, val`
`redis_append`	`conn, key, val`
`redis_strlen`	`conn, key`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/redis —— Redis 客户端（RESP 协议）
------------------------------------------------------------
纯 .px 实现 RESP（REdis Serialization Protocol），双模式一致。
redis_connect(host, port[, opts]) → Ok(conn dict) | Err
redis_cmd(conn, args) → Ok(reply) | Err   通用命令（回复按 RESP 类型映射）
redis_ping(conn) / redis_set / redis_get / redis_del / redis_incr /
redis_ttl / redis_select / redis_close
回复类型映射：+ 简单串→str；- 错误→Err；: 整数→int；$ 块→str；$-1→null；
* 数组→list（元素递归映射）；*-1→null。
依赖 runtime native：tcp_connect_ex / tcp_send_ex / tcp_recv_ex / is_int_str。
============================================================