Añade una entrada en un directorio LDAP

# ldap_add

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_add — Añade una entrada en un directorio LDAP

### Descripción

function ldap_add(
LDAP\Connection `$ldap`,
string `$dn`,
array `$entry`,
?array `$controls` = `null`
): bool

Añade una entrada en un directorio LDAP.

### Parámetros

`ldap`

  Una instancia de LDAP\Connection, devuelta por ldap_connect().

`dn`

  El nombre DN de la entrada LDAP.

`entry`

  Un array con la información sobre la nueva entrada. Estos valores están indexados individualmente. En caso de valores múltiples para un atributo, están indexados numéricamente, comenzando desde 0.

      <?php
      $entry["attribute1"] = "value";
      $entry["attribute2"][0] = "value1";
      $entry["attribute2"][1] = "value2";
      ?>

`controls`

  Array de Controles LDAP para enviar con la petición.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.1.0 | El parámetro `ldap` ahora espera una instancia de LDAP\Connection; anteriormente, se esperaba un resource `ldap link` válido.
8.0.0 | `controls` ahora acepta `null`; anteriormente, su valor predeterminado era `[]`.
7.3.0 | Se añadió soporte para `controls`.

### Ejemplos

Ejemplo #1 Ejemplo completo con identificación LDAP

    <?php
    $ds = ldap_connect("localhost");  // se asume que el servidor LDAP está en el servidor local

    if ($ds) {
        // Conexión con una identidad que permite modificaciones
        $r = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");

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

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

        ldap_close($ds);
    } else {
        echo "No es posible conectarse al servidor LDAP";
    }
    ?>

### Notas

> Nota: Esta función es segura para sistemas binarios.

### Ver también

- ldap_add_ext() - Añade una entrada en un directorio LDAP
- ldap_delete() - Elimina una entrada en un directorio

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