<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.zookeeper.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'zookeeper.addauth.php',
    1 => 'Zookeeper::addAuth',
    2 => 'Especifica la informaci&oacute;n de autenticaci&oacute;n de la aplicaci&oacute;n',
  ),
  'up' => 
  array (
    0 => 'class.zookeeper.php',
    1 => 'Zookeeper',
  ),
  'prev' => 
  array (
    0 => 'class.zookeeper.php',
    1 => 'Zookeeper',
  ),
  'next' => 
  array (
    0 => 'zookeeper.close.php',
    1 => 'Zookeeper::close',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/zookeeper/zookeeper/addauth.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="zookeeper.addauth" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">Zookeeper::addAuth</h1>
  <p class="verinfo">(PECL zookeeper &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">Zookeeper::addAuth</span> &mdash; <span class="dc-title">Especifica la información de autenticación de la aplicación</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-zookeeper.addauth-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span>
   <span class="methodname"><strong>Zookeeper::addAuth</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$scheme</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$cert</code></span>, <span class="methodparam"><span class="type"><a href="language.types.callable.php" class="type callable">callable</a></span> <code class="parameter">$completion_cb</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   La aplicación llama a esta función para especificar su información de autenticación. El servidor usará el proveedor de seguridad especificado por el parámetro scheme para autenticar la conexión del cliente. Si la solicitud de autenticación falla:
    - la conexión del servidor se abandona.
    - el observador es llamado con el valor ZOO_AUTH_FAILED_STATE como parámetro de estado.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-zookeeper.addauth-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">scheme</code></dt>
    <dd>
     <p class="para">
      El id del esquema de autenticación. Soportado nativamente: &quot;digest&quot; autenticación basada en contraseña.
     </p>
    </dd>
   
   
    <dt><code class="parameter">cert</code></dt>
    <dd>
     <p class="para">
      La información de autenticación de la aplicación. El valor real depende del esquema.
     </p>
    </dd>
   
   
    <dt><code class="parameter">completion_cb</code></dt>
    <dd>
     <p class="para">
      La rutina a invocar cuando la solicitud ha terminado. Uno de los siguientes códigos de resultado puede ser pasado a la función de devolución de llamada de finalización:
        - ZOK la operación se completó con éxito
        - ZAUTHFAILED la autenticación falló
     </p>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-zookeeper.addauth-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
  </p>
 </div>


 <div class="refsect1 errors" id="refsect1-zookeeper.addauth-errors">
  <h3 class="title">Errores/Excepciones</h3>
  <p class="para">
   Este método emite un error/advertencia PHP cuando el número de parámetros o los tipos son incorrectos o cuando la operación falla.
  </p>
  <div class="caution"><strong class="caution">Precaución</strong>
    <p class="para">
      Desde la versión 0.3.0, este método emite <span class="classname"><a href="class.zookeeperexception.php" class="classname">ZookeeperException</a></span> y sus derivados.
    </p>
  </div>
 </div>


 <div class="refsect1 examples" id="refsect1-zookeeper.addauth-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="zookeeper.addauth.example.basic">
   <p><strong>Ejemplo #1 Ejemplo de <span class="methodname"><strong>Zookeeper::addAuth()</strong></span></strong></p>
   <div class="example-contents"><p>
     Añade la autenticación antes de solicitar el valor del nodo.
   </p></div>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$zookeeper </span><span style="color: #007700">= new </span><span style="color: #0000BB">Zookeeper</span><span style="color: #007700">(</span><span style="color: #DD0000">'localhost:2181'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$path </span><span style="color: #007700">= </span><span style="color: #DD0000">'/path/to/node'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$value </span><span style="color: #007700">= </span><span style="color: #DD0000">'nodevalue'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$zookeeper</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">set</span><span style="color: #007700">(</span><span style="color: #0000BB">$path</span><span style="color: #007700">, </span><span style="color: #0000BB">$value</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$zookeeper</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">addAuth</span><span style="color: #007700">(</span><span style="color: #DD0000">'digest'</span><span style="color: #007700">, </span><span style="color: #DD0000">'user0:passwd0'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$r </span><span style="color: #007700">= </span><span style="color: #0000BB">$zookeeper</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">get</span><span style="color: #007700">(</span><span style="color: #0000BB">$path</span><span style="color: #007700">);<br />if (</span><span style="color: #0000BB">$r</span><span style="color: #007700">)<br />  echo </span><span style="color: #0000BB">$r</span><span style="color: #007700">;<br />else<br />  echo </span><span style="color: #DD0000">'ERR'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

   <div class="example-contents"><p>El ejemplo anterior mostrará:</p></div>
   <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">nodevalue</pre>
</div>
   </div>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-zookeeper.addauth-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="methodname"><a href="zookeeper.create.php" class="methodname" rel="rdfs-seeAlso">Zookeeper::create()</a> - Crear un nodo de forma sincr&oacute;nica</span></li>
   <li><span class="methodname"><a href="zookeeper.setacl.php" class="methodname" rel="rdfs-seeAlso">Zookeeper::setAcl()</a> - Establece la ACL asociada a un nodo de forma sincr&oacute;nica</span></li>
   <li><span class="methodname"><a href="zookeeper.getacl.php" class="methodname" rel="rdfs-seeAlso">Zookeeper::getAcl()</a> - Devuelve las ACL asociadas a un nodo de forma sincr&oacute;nica</span></li>
   <li><a href="class.zookeeper.php#zookeeper.constants.states" class="link">Estado de ZooKeeper</a></li>
   <li><span class="classname"><a href="class.zookeeperexception.php" class="classname">ZookeeperException</a></span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>