# Zookeeper::addAuth

(PECL zookeeper >= 0.1.0)

Zookeeper::addAuth — Spécifie les informations d'authentification de l'application

### Description

public Zookeeper::addAuth(string `$scheme`, string `$cert`, callable `$completion_cb` = `null`): bool

L'application appelle cette fonction pour spécifier ses informations d'authentification. Le serveur utilisera le fournisseur de sécurité spécifié par le paramètre scheme pour authentifier la connexion du client. Si la demande d'authentification a échoué : - la connexion du serveur est abandonnée. - l'observateur est appelé avec la valeur ZOO_AUTH_FAILED_STATE comme paramètre d'état.

### Liste de paramètres

`scheme`

  L'id du schéma d'authentification. Pris en charge nativement : "digest" authentification basée sur le mot de passe

`cert`

  Les informations d'authentification de l'application. La valeur réelle dépend du schéma.

`completion_cb`

  La routine à invoquer lorsque la demande est terminée. L'un des codes de résultat suivants peut être passé à la fonction de rappel de fin : - ZOK l'opération s'est terminée avec succès - ZAUTHFAILED l'authentification a échoué

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Erreurs / Exceptions

Cette méthode émet une erreur PHP/avertissement lorsque le nombre de paramètres ou les types sont incorrects ou lorsque l'opération échoue.

Attention

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

### Exemples

Exemple #1 Exemple de Zookeeper::addAuth()

Ajoute l'authentification avant de demander la valeur du nœud.

`<?php
$zookeeper = new Zookeeper('locahost:2181');
$path = '/path/to/node';
$value = 'nodevalue';
$zookeeper->set($path, $value);
$zookeeper->addAuth('digest', 'user0:passwd0');
$r = $zookeeper->get($path);
if ($r)
echo $r;
else
echo 'ERR';
?>`

L'exemple ci-dessus va afficher :

    nodevalue

### Voir aussi

- Zookeeper::create() - Créer un nœud de manière synchrone
- Zookeeper::setAcl() - Définit l'ACL associé à un nœud de manière synchrone
- Zookeeper::getAcl() - Renvoie les ACL associées à un nœud de manière synchrone
- Etat de ZooKeeper
- ZookeeperException