查询

Zookeeper::create()函数—用法及示例

「 创建一个新的ZooKeeper节点 」


函数名称:Zookeeper::create()

适用版本:PHP 5 >= 5.3.0, PHP 7

函数描述:Zookeeper::create() 函数用于创建一个新的ZooKeeper节点。

语法:string Zookeeper::create(string $path, string $value, array $acl, int $flags)

参数:

  • $path:字符串类型,表示要创建的节点路径。
  • $value:字符串类型,表示要设置的节点数据。
  • $acl:数组类型,表示节点的ACL(访问控制列表)。ACL 是一个包含多个元素的数组,每个元素包含一个访问控制权限和一个授权对象。
  • $flags:整数类型,表示节点的标志。可以使用 Zookeeper::EPHEMERAL 创建一个临时节点,使用 Zookeeper::SEQUENCE 创建一个顺序节点。

返回值:

  • 成功时,返回创建的节点路径(字符串类型)。
  • 失败时,返回 false。

示例:

// 创建一个新的 ZooKeeper 节点
$zk = new Zookeeper('localhost:2181');
$path = '/my_node';
$value = 'Hello, ZooKeeper!';
$acl = [
    ['perms' => Zookeeper::PERM_ALL, 'scheme' => 'world', 'id' => 'anyone'],
];
$flags = 0;
$result = $zk->create($path, $value, $acl, $flags);
if ($result !== false) {
    echo '节点创建成功,路径为:' . $result;
} else {
    echo '节点创建失败';
}

注意事项:

  • 在调用 Zookeeper::create() 函数之前,需要先创建一个 ZooKeeper 实例。
  • $acl 参数是一个包含多个元素的数组,每个元素都是一个关联数组,包含 'perms'、'scheme' 和 'id' 三个键。'perms' 表示权限,可以使用 Zookeeper::PERM_* 常量设置。'scheme' 表示授权方案,可以是 'world'、'auth'、'digest'、'ip' 或 'super'。'id' 表示授权对象,可以是 'anyone'、'auth'、'digest'、'ip' 或 'super'。
  • $flags 参数可以使用 Zookeeper::EPHEMERAL 创建一个临时节点,当与创建该节点的客户端断开连接时,该节点将被删除。可以使用 Zookeeper::SEQUENCE 创建一个顺序节点,节点路径将自动附加一个递增的序列号。
补充纠错
上一个函数: Zookeeper::delete()函数
下一个函数: Zookeeper::connect()函数
热门PHP函数
分享链接