ldap_add

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

ldap_add — Añade una entrada en un directorio LDAP

Descripción

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