Présentation de l'API PHP pour LDAP

Pour une installation de type Mdk 9.1, ces fonctions sont regroupées dans le paquetage php-ldap-4.3.0
Pour Debian 3.x : apt-get install php4-ldap

Documentation

Lire et s'inspirer des exemples inclus dans la documentation officielle
http://www.php.net/manual/fr/ref.ldap.php
Manuel de référence
http://www.php.net/manual/fr/ref.ldap.php

Présentation

Une référence globale en LDAP (équivalent d'une chemin dans une arborescence de fichiers) s'appelle un "dn" (="distinguished name"). Il s'agit d'une information de type feuille, dont le nom doit être suivi des branches successives menant à la racine de l'annuaire. La syntaxe est donc inversée par rapport à une notation pour désigner le chemin complet d'un fichier sur une arborescence (comme par exemple : /etc/apache/conf/httpd.conf).
Voici des exemples de dn :
```
dn: cn=Jules Toto, ou=eleves, dc=fctice, dc=fr
dn: cn=Jean Dupont, ou=profs, dc=fctice, dc=fr
```
Utiliser les fonctions LDAP de PHP
Pour utiliser ces fonctions, il est nécessaire de connaitre :
- Le nom ou l'adresse ip de la machine qui héberge le serveur LDAP
- Le dn de base (ici : dn="dc=fctice, dc=fr")
- Le mot de passe d'un compte ayant droit d'écriture dans l'annuaire (pour un accès non anonyme)
- La séquence LDAP typique d'une session de travail en PHP sur l'annuaire est :
```
  ldap_connect()    // établit une connexion au serveur
     |
  ldap_bind()       // type de liaison (anonyme ou identifiée)
     |
  envoi de requetes (recherches, modifications,..)
  affichage en php des résultats retournés
     |
  ldap_close()      // déconnexion
```

Exemple de code

Consultation
La plupart des fonctions se comprendront aisément (surtout si on connait l'API Php-Mysql). Pour connaitre précisément le type de tableau créé par ldap_get_entries voir l'annexe

/* /ldap/recherche.php
 *********************/
<?
echo "Connexion au serveur "
/* 1ère étape : essai de connexion à un serveur ldap
 * le paramètre doit être l'adresse IP du serveur LDAP, ici localhost
 */
$ds=ldap_connect("127.0.0.1");
// on teste : le serveur LDAP est-il trouvé ?
if ($ds)
 echo "Le résultat de connexion est ".$ds;
else
 die("connexion impossible au serveur LDAP");

/* 2ème étape : on effectue une liaison au serveur, ici de type "anonymous"
 * pour une recherche permise par un accès en lecture seule
 *
echo "Liaison ...";
$r=ldap_bind($ds);
// en cas de succès de la liaison, renvoie $r=1
if ($r)
  echo "Le résultat de connexion est $r";
else
  die("liaison impossible au serveur ldap ...");

/* 3ème étape : on effectue une recherche anonyme, avec le dn de base,
 * par exemple, sur tous les noms commençant par T
 */
echo "Recherche suivant le filtre (sn=T*)";
$dn="dc=fctice,dc=fr";
$filtre = "sn=T*";
$sr=ldap_search($ds, $dn, $filtre);
echo "Le résultat de la recherche est $sr";

echo "Le nombre d'entrées retournées est ".ldap_count_entries($ds,$sr)."."<p>";
echo "Lecture de ces entrées ...."<p>";
$info = ldap_get_entries($ds, $sr);
echo "Données pour ".$info["count"]." entrées:<p>";

for ($i=0; $i < $info["count"]; $i++) {
        echo "dn est : ". $info[$i]["dn"] ."<br>";
        echo "premiere entree cn : ". $info[$i]["cn"][0] ."<br>";
        echo "premier email : ". $info[$i]["mail"][0] ."<p>";
}
/* 4ème étape : cloture de la session
 */
echo "Fermeture de la connexion";
ldap_close($ds);
?>

Exemple d'ajout

<?php
// on suppose que le serveur LDAP se trouve sur le serveur local
$ds=ldap_connect("localhost");
if ($ds)
 echo "Le résultat de connexion est ".$ds."<p>";
else
 die("connexion impossible au serveur LDAP");

// Liaison avec un dn authentifié autorisant les modifications
$dn = "cn=admin, dc=fctice, dc=fr";
$r=ldap_bind($ds, $dn, "admin");

// construction d'un tableau contenant les données à ajouter
 $info["cn"]="Jean Dupont";
 $info["sn"]="Dupont";
 $info["email"]="jean.dupont@wanadoo.fr";
 $info["objectclass"]="person";

// Ajout des données au dossier
 $r=ldap_add($ds, "cn=Jean Dupont, dc=fctice, dc=fr", $info);
 ldap_close($ds);
?>

Modification d'une entrée
Elle s'effectue comme l'ajout d'une entrée complète, à la différence que la fonction à utiliser est ldap_modify.
Le tableau $info doit contenir toutes les nouvelles valeurs à remplacer (et seulement celles-là)
Syntaxe : $r=ldap_modify($ds, $dn, $info);

Principales fonctions

$ds=ldap_connect(hote)
établit une connexion avec un serveur LDAP, situé sur une machine connue par son nom d'hote ou une adresse IP, le port par défaut est 389. Renvoie un identifiant $ds de connexion (noté $ds)
$dn = "cn=admin, dc=fctice, dc=fr";
$cr=ldap_bind($ds, $dn, $mdp)
établit une liaison avec le serveur, avec l'authentification transmise ($dn/ $mdp) et retourne TRUE ou FALSE Si ces 2 paramètres optionnels sont omis, une tentative de connexion anonyme est tentée.
$sr=ldap_search($ds,$dn,$filtre)
Recherche sur le serveur LDAP avec le filtre $filtre et retourne un identifiant de résultat, ou bien FALSE en cas d'erreur.
$n=ldap_count_entries($ds, $sr)
Retourne le nombre d'entrées trouvées dans le résultat $sr pour la connexion $ds, ou FALSE en cas d'erreur.
ldap_count_entries(), sans paramètre, utilise la dernière recherche

$info=ldap_get_entries($ds, $sr)
Récupère toutes les entrées du résultat $sr pour la connexion $ds et retourne un tableau associatif multi-dimensionnel, noté ici $info, ou FALSE en cas d'erreur.
Voici le contenu de ce tableau associatif

$info["count"] = nombre d'entrées dans le résultat
$info[0] : sous-tableau renfermant les infos de la première entrée
$info[n]["dn"] : dn de la n-ième entrée du résultat
$info[n]["count"] : nombre d'attributs de la n-ième entrée
$info[n][m] : m-ième attribut de la i-ème entrée

$info[n]["attribut"]["count"] : nombre de valeur de cet attribut pour la i-ième entrée
$info[n]["attribut"][m] : m-ième valeur de l'attribut pour la n-ième entrée

$r=ldap_add($ds, $dn, $info)
ldap_add() sert à ajouter une entrée dans un dossier LDAP, $dn est l'identification complète de l'entrée à ajouter, et $info un tableau contenant les valeurs des attributs (en cas de valeurs multiples pour un attribut, elle sont indexées numériquement, à partir de 0).
$r=ldap_modify($ds, $dn, $info)
ldap_modify() modifie l'entrée identifiée par $dn, avec les valeurs fournies dans le tableau $info.