PHP 日本會議 2024

Zookeeper::create

(PECL zookeeper >= 0.1.0)

Zookeeper::create同步建立節點

描述

public Zookeeper::create(
    string $path,
    string $value,
    array $acls,
    int $flags = null
): string

此方法將在 ZooKeeper 中建立節點。只有在節點不存在時才能建立。建立旗標會影響節點的建立。如果設定了 ZOO_EPHEMERAL 旗標,則當用戶端連線中斷時,節點會自動移除。如果設定了 ZOO_SEQUENCE 旗標,則會在路徑名稱後面附加一個唯一的單調遞增序號。

參數

path

節點的名稱。以斜線分隔節點祖先的檔案名稱表示。

value

要儲存在節點中的資料。

acls

節點的初始 ACL。ACL 不得為 null 或空。

flags

此參數可以設定為 0 以進行正常建立,或設定為建立旗標的 OR

傳回值

成功時傳回新節點的路徑(這可能與提供的路徑不同,因為 ZOO_SEQUENCE 旗標),失敗時傳回 false。

錯誤/例外

當參數計數或類型錯誤,或建立節點失敗時,此方法會發出 PHP 錯誤/警告。

注意

自 0.3.0 版起,此方法會發出 ZookeeperException 及其衍生類別。

範例

範例 #1 Zookeeper::create() 範例

建立一個新的節點。

<?php
$zookeeper
= new Zookeeper('locahost:2181');
$aclArray = array(
array(
'perms' => Zookeeper::PERM_ALL,
'scheme' => 'world',
'id' => 'anyone',
)
);
$path = '/path/to/newnode';
$realPath = $zookeeper->create($path, null, $aclArray);
if (
$realPath)
echo
$realPath;
else
echo
'ERR';
?>

以上範例會輸出

/path/to/newnode

參見

新增筆記

使用者貢獻的筆記

此頁面沒有使用者貢獻的筆記。
To Top