# ldap_parse_result

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

ldap_parse_result — Extrait des informations d'un résultat

### Description

ldap_parse_result(
LDAP\Connection `$ldap`,
LDAP\Result `$result`,
int `&$error_code`,
string `&$matched_dn` = `null`,
string `&$error_message` = `null`,
array `&$referrals` = `null`,
array `&$controls` = `null`
): bool

Analyse un résultat de recherche LDAP.

### Liste de paramètres

`ldap`

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

`result`

  Une instance LDAP\Result, retourné par ldap_list() ou ldap_search().

`error_code`

  Une référence vers une variable qui sera valorisée du code erreur LDAP dans le résultat, ou par `0` si aucune erreur n'est survenue.

`matched_dn`

  Une référence vers une variable qui sera valorisée du DN correspondant s'il a été reconnu dans la requête, sinon, vaudra `null`.

`error_message`

  Une référence vers une variable qui sera valorisée du message d'erreur LDAP dans le résultat, ou d'une chaîne vide si aucune erreur n'est survenue.

`referrals`

  Une référence vers une variable qui sera valorisée d'un jeu de tableaux contenant les chaînes de référence dans le résultat, ou un tableau vide si aucune référence n'est retournée.

`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.1.0 | Le paramètre `result` attend désormais une instance de LDAP\Result ; auparavant, une resource `ldap result` était attendue.
7.3.0 | Support pour `controls` a été ajouté.

### Exemples

Exemple #1 Exemple avec ldap_parse_result()

`<?php
$result = ldap_search($ldap, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
$errcode = $dn = $errmsg = $refs = null;
if (ldap_parse_result($ldap, $result, $errcode, $dn, $errmsg, $refs)) {
// faîtes quelques choses avec $errcode, $dn, $errmsg et $refs
}
?>`