Sets the acl associated with a node synchronously

# Zookeeper::setAcl

(PECL zookeeper >= 0.1.0)

Zookeeper::setAcl — Sets the acl associated with a node synchronously

### 说明

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

### 参数

`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.

### 返回值

成功时返回 `true`， 或者在失败时返回 `false`。

### 错误／异常

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

警告

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

### 示例

示例 #1 Zookeeper::setAcl() example

Set ACL for a node.

    <?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';
    ?>

以上示例会输出：

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

### 参见

- Zookeeper::create() - Create a node synchronously
- Zookeeper::getAcl() - Gets the acl associated with a node synchronously
- ZooKeeper Permissions
- ZookeeperException

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open