ldap_add

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

ldap_addAñ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

An LDAP\Connection instance, returned by 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

Devuelve true en caso de éxito o false en caso de error.

Historial de cambios

Versión Descripción
8.1.0 The ldap parameter expects an LDAP\Connection instance now; previously, a valid ldap link recurso was expected.
8.0.0 controls is nullable now; previously, it defaulted to [].
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 binariamente.

Ver también