Zookeeper::set

(PECL zookeeper >= 0.1.0)

Zookeeper::set — Sets the data associated with a node

説明

public function Zookeeper::set(
    string $path,
    string $value,
    int $version = -1,
    array &$stat = null
): bool

パラメータ

path: The name of the node. Expressed as a file name with slashes separating ancestors of the node.
value: The data to be stored in the node.
version: The expected version of the node. The function will fail if the actual version of the node does not match the expected version. If -1 is used the version check will not take place.
stat: If not NULL, will hold the value of stat for the path on return.

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

This method emits PHP error/warning when parameters count or types are wrong or fail to save value to node.

警告

Since version 0.3.0, this method emits ZookeeperException and its derivatives.

例

例1 Zookeeper::set() example

Save value to node.

<?php
$zookeeper = new Zookeeper('localhost:2181');
$path = '/path/to/node';
$value = 'nodevalue';
$r = $zookeeper->set($path, $value);
if ($r)
  echo 'SUCCESS';
else
  echo 'ERR';
?>

上の例の出力は以下となります。

SUCCESS

参考

Zookeeper::create() - Create a node synchronously
Zookeeper::get() - Gets the data associated with a node synchronously
ZookeeperException

関連キーワード:

node Zookeeper path associated Sets zookeeper stat expected fail method emits ZookeeperException synchronously isRecoverable setAcl Expressed slashes separating ancestors stored actual match used check take