# ldap_add

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

ldap_add — Ajoute une entrée dans un dossier LDAP

### Description

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

Ajoute une entrée dans un dossier LDAP.

### Liste de paramètres

`ldap`

  Une instance LDAP\Connection, retourné par ldap_connect().

`dn`

  Le nom DN de l'entrée LDAP.

`entry`

  Un tableau avec les informations sur la nouvelle entrée. Ces valeurs sont indexées individuellement. En cas de valeurs multiples pour un attribut, elles sont indexées numériquement, à partir de 0.

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

  Tableau de Contrôles LDAP à envoyer avec la requête.

### Valeurs de retour

Cette fonction retourne `true` en cas de succès ou `false` si une erreur survient.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `ldap` attend désormais une instance de LDAP\Connection ; auparavant, une resource `ldap link` était attendue.
8.0.0 | `controls` est désormais nullable ; auparavant, sa valeur par défaut était `[]`.
7.3.0 | Support pour `controls` a été ajouté.

### Exemples

Exemple #1 Exemple complet avec identification LDAP

`<?php
$ds = ldap_connect("localhost"); // on suppose que le serveur LDAP est sur le serveur local
if ($ds) {
// Connexion avec une identité qui permet les modifications
$r = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");
// Prépare les données
$info["cn"] = "John Jones";
$info["sn"] = "Jones";
$info["objectclass"] = "person";
// Ajoute les données au dossier
$r = ldap_add($ds, "cn=John Jones, o=My Company, c=US", $info);
ldap_close($ds);
} else {
echo "Impossible de se connecter au serveur LDAP";
}
?>`

### Notes

> Note: Cette fonction gère les chaînes binaires.

### Voir aussi

- ldap_add_ext() - Ajoute une entrée dans un dossier LDAP
- ldap_delete() - Efface une entrée dans un dossier