ldap-add.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 204bc2974d707bed4017414b13242171d719cb7c Maintainer: edwincartagenah Status: ready -->
<refentry xml:id="function.ldap-add" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ldap_add</refname>
  <refpurpose>Agregar entradas al directorio de LDAP</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>ldap_add</methodname>
   <methodparam><type>resource</type><parameter>link_identifier</parameter></methodparam>
   <methodparam><type>string</type><parameter>dn</parameter></methodparam>
   <methodparam><type>array</type><parameter>entry</parameter></methodparam>
  </methodsynopsis>
  <para>
   Agregar entradas en el directorio de LDAP. 
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>link_identifier</parameter></term>
     <listitem>
      <para>
       Un identificador de enlace de LDAP, devuelto por <function>ldap_connect</function>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>dn</parameter></term>
     <listitem>
      <para>
       El nombre distinguido de una entidad de LDAP.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>entry</parameter></term>
     <listitem>
      <para>
       Un array que especifica la información acerca de la entrada. Los valores en
       las entradas están indexados por atributos individuales.
       En el caso de valores múltiples para un atributo, estos se indexan utilizando
       números enteros comenzando desde 0.
       <informalexample>
        <programlisting role="php">
     <![CDATA[
<?php
$entry["attribute1"] = "valor";
$entry["attribute2"][0] = "valor1";
$entry["attribute2"][1] = "valor2";
?>
     ]]>
        </programlisting>
       </informalexample>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo completo con enlace autenticado</title>
    <programlisting role="php">
<![CDATA[
<?php
$ds = ldap_connect("localhost");  // Asumiendo que el servidor de LDAP está en el mismo host

if ($ds) {
    // Asociar con el dn apropiado para dar acceso de actualización
    $r = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");

    // Preparar los datos
    $info["cn"] = "John Jones";
    $info["sn"] = "Jones";
    $info["objectclass"] = "person";

    // Agregar datos al directorio
    $r = ldap_add($ds, "cn=John Jones, o=My Company, c=US", $info);

    ldap_close($ds);
} else {
    echo "No se pudo conectar al servidor LDAP";
}
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  &note.bin-safe;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>ldap_delete</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->