Home/ Manual/ zookeeper / zookeeper/ Zookeeper::setAcl

Zookeeper::setAcl

PHP function Edit on GitHub ✎

(PECL zookeeper >= 0.1.0)

Sets the acl associated with a node synchronously

Description

Zookeeper::setAcl(string $path, int $version, array $acl): bool

Parameters

path: The name of the node. Expressed as a file name with slashes separating ancestors of the node.
version: The expected version of the path.
acl: The acl to be set on the path.

Return Values

Success

Errors/Exceptions

This method emits PHP error/warning when parameters count or types are wrong or fail to set ACL for a node.

Caution

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

Examples

Zookeeper::setAcl example

Set ACL for a node.

php

<?php
$zookeeper = new Zookeeper('localhost:2181');
$aclArray = array(
  array(
    'perms'  => Zookeeper::PERM_ALL,
    'scheme' => 'world',
    'id'     => 'anyone',
  )
);
$path = '/path/to/newnode';
$zookeeper->setAcl($path, $aclArray);

$r = $zookeeper->getAcl($path);
if ($r)
  var_dump($r);
else
  echo 'ERR';
?>

The above example will output:

output

array(1) {
  [0]=>
  array(3) {
    ["perms"]=>
    int(31)
    ["scheme"]=>
    string(5) "world"
    ["id"]=>
    string(6) "anyone"
  }
}