Zookeeper::create

(PECL zookeeper >= 0.1.0)

Zookeeper::create — Créer un nœud de manière synchrone

Description

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

Cette méthode crée un nœud dans ZooKeeper. Un nœud ne peut être créé que s'il n'existe pas déjà. Les drapeaux de création affectent la création des nœuds. Si le drapeau ZOO_EPHEMERAL est défini, le nœud sera automatiquement supprimé si la session client disparaît. Si le drapeau ZOO_SEQUENCE est défini, un numéro de séquence unique et croissant est ajouté au nom du chemin.

Liste de paramètres

path: Le nom du nœud. Exprimé sous la forme d'un nom de fichier avec des barres obliques séparant les ancêtres du nœud.
value: Les données à stocker dans le nœud.
acls: Les ACL initiales du nœud. L'ACL ne doit pas être nulle ou vide.
flags: Ce paramètre peut être défini sur 0 pour une création normale ou un OU des drapeaux de création.

Valeurs de retour

Renvoie le chemin du nouveau nœud (cela peut être différent du chemin fourni en raison du drapeau ZOO_SEQUENCE) en cas de succès, et false en cas d'échec.

Erreurs / Exceptions

Cette méthode émet une erreur/warning PHP lorsque le nombre de paramètres ou les types sont incorrects ou que la création du nœud a échoué.

Attention

Depuis la version 0.3.0, cette méthode émet ZookeeperException et ses dérivés.

Exemples

Exemple #1 Exemple de Zookeeper::create()

Créer un nouveau nœud.

<?php
$zookeeper = new Zookeeper('localhost: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';
?>

L'exemple ci-dessus va afficher :

/path/to/newnode

Voir aussi

Zookeeper::delete() - Enlève un nœud de manière synchrone
Zookeeper::getChildren() - Liste les enfants d'un nœud de manière synchrone
Permissions de ZooKeeper
ZookeeperException

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.