PHP 连接示例

pecl install redis

extension=redis.so

php -m | grep redis

<?php
// 连接参数
$host = "192.xx.xx.2";       // 实例 VIP 地址
$port = 6379;                 // 实例端口
$password = "crs-xxxx:密码";  // 默认账号密码格式：实例ID:密码

// 创建连接
$redis = new Redis();

// 连接实例，设置超时时间为 2 秒
$redis->connect($host, $port, 2.0);

// 认证
$redis->auth($password);

// 选择数据库（代理模式支持多 DB）
$redis->select(0);

// 写入数据
$redis->set("name", "腾讯云分布式缓存数据库");

// 读取数据
$value = $redis->get("name");
echo "get name: " . $value . "\\n";

// 设置带过期时间的 Key
$redis->setex("session:user123", 3600, "session_data");

// 哈希操作
$redis->hSet("user:1001", "name", "张三");
$redis->hSet("user:1001", "age", "28");
$userInfo = $redis->hGetAll("user:1001");
echo "user info: ";
print_r($userInfo);

// 关闭连接
$redis->close();
?>

<?php
$host = "192.xx.xx.2";
$port = 6379;
$username = "myuser";
$password = "myuser@MyPassword";  // 代理模式自定义账号：用户名@密码整体作为密码传入（区别于直连模式 ACL 的账号名/密码分离传参）

$redis = new Redis();
$redis->connect($host, $port, 2.0);
$redis->auth($password);

$redis->set("key", "value");
echo $redis->get("key") . "\\n";

$redis->close();
?>

<?php
$host = "192.xx.xx.2";
$port = 6379;
$password = "crs-xxxx:密码";

// 使用持久连接，第四个参数为持久连接标识
$redis = new Redis();
$redis->pconnect($host, $port, 2.0, "persistent_id_01");
$redis->auth($password);

// 设置读写超时
$redis->setOption(Redis::OPT_READ_TIMEOUT, 2);

// 业务操作
$redis->set("counter", 0);
$redis->incr("counter");
$count = $redis->get("counter");
echo "counter: " . $count . "\\n";

// 持久连接不需要显式关闭，由 PHP 生命周期管理
?>

<?php
$host = "192.xx.xx.2";
$port = 6379;
$password = "crs-xxxx:密码";
$caCertPath = "/path/to/ca.pem";  // CA 证书文件路径

$redis = new Redis();

// 配置 TLS/SSL 参数
$redis->connect("tls://" . $host, $port, 2.0, null, 0, 0, [
    'stream' => [
        'verify_peer' => true,
        'verify_peer_name' => false,
        'cafile' => $caCertPath,
    ]
]);

$redis->auth($password);

$redis->set("ssl_test", "encrypted_connection");
echo $redis->get("ssl_test") . "\\n";

$redis->close();
?>

<?php
// 直连模式下各分片节点地址
$seeds = [
    "192.xx.xx.2:6379",
    "192.xx.xx.3:6379",
    "192.xx.xx.4:6379"
];

$password = "password";  // 直连模式默认账号仅传密码，不带实例 ID 前缀

// 创建 RedisCluster 连接
// 参数说明：名称, 节点数组, 连接超时, 读取超时, 是否持久连接, 密码
$cluster = new RedisCluster(
    null,           // 集群名称，传 null 使用 seeds 方式
    $seeds,         // 分片节点地址列表
    2.0,            // 连接超时（秒）
    2.0,            // 读取超时（秒）
    false,          // 是否持久连接
    $password       // 认证密码
);

// 写入数据（客户端自动路由到正确的分片）
$cluster->set("cluster:key1", "value1");
$cluster->set("cluster:key2", "value2");
$cluster->set("cluster:key3", "value3");

// 读取数据
echo "key1: " . $cluster->get("cluster:key1") . "\\n";
echo "key2: " . $cluster->get("cluster:key2") . "\\n";
echo "key3: " . $cluster->get("cluster:key3") . "\\n";

// 哈希操作
$cluster->hSet("user:{1001}", "name", "张三");
$cluster->hSet("user:{1001}", "age", "28");
$userInfo = $cluster->hGetAll("user:{1001}");
echo "user info: ";
print_r($userInfo);

// 使用 Hash Tag 确保相关 Key 路由到同一分片
$cluster->set("{order:1001}:status", "paid");
$cluster->set("{order:1001}:amount", "99.00");
$cluster->set("{order:1001}:time", "2025-01-01 10:00:00");

echo "order status: " . $cluster->get("{order:1001}:status") . "\\n";

// 关闭连接
$cluster->close();
?>

<?php
$seeds = [
    "192.xx.xx.2:6379",
    "192.xx.xx.3:6379",
    "192.xx.xx.4:6379"
];

$password = "password";  // 直连模式默认账号仅传密码，不带实例 ID 前缀

// 使用持久连接的 RedisCluster
$cluster = new RedisCluster(
    null,
    $seeds,
    2.0,            // 连接超时
    2.0,            // 读取超时
    true,           // 开启持久连接
    $password
);

// 设置序列化方式（推荐 PHP 序列化或 JSON）
$cluster->setOption(RedisCluster::OPT_SERIALIZER, Redis::SERIALIZER_JSON);

// 存储复杂数据结构
$data = [
    "id" => 1001,
    "name" => "产品A",
    "price" => 99.99,
    "tags" => ["热门", "推荐"]
];
$cluster->set("product:1001", $data);

// 读取并自动反序列化
$product = $cluster->get("product:1001");
print_r($product);
?>

<?php
$seeds = [
    "192.xx.xx.2:6379",
    "192.xx.xx.3:6379",
    "192.xx.xx.4:6379"
];

// ===== ACL 认证机制：账号名与密码是两个独立字段 =====
// 直连模式的多账号能力基于 Redis 原生 ACL：控制台创建的每个自定义账号
// 都是一个独立的 ACL user，认证时客户端向节点发送 AUTH <account> <password>。
// phpredis 的 RedisCluster 以 [账号名, 密码] 数组形式传入（等价于执行 AUTH account password），
// 不要写成代理模式的 "myuser@MyPassword" 拼接格式。
$cluster = new RedisCluster(
    null,                       // 集群名称，传 null 使用 seeds 方式
    $seeds,                     // 分片节点地址列表
    2.0,                        // 连接超时（秒）
    2.0,                        // 读取超时（秒）
    false,                      // 是否持久连接
    ["myuser", "MyPassword"]    // ACL 账号：[账号名 → AUTH account, 密码 → AUTH password]（纯密码，无需拼接）
);

$cluster->set("key", "value");
echo $cluster->get("key") . "\\n";

$cluster->close();
?>