Lit/écrit la valeur courante d'une option

# ldap_get_option

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

ldap_get_option — Lit/écrit la valeur courante d'une option

### Description

ldap_get_option ( resource `$link_identifier` , int `$option` , mixed `&$retval` ) : bool

Définit la valeur `retval` à l'option spécifié.

### Liste de paramètres

`link_identifier`

  Un identifiant de lien LDAP, retourné par la fonction ldap_connect().

`option`

  Le paramètre `option` peut prendre l'une des valeurs suivantes :

  Option | Type | Disponible depuis
  --- | --- | ---
  `LDAP_OPT_DEREF` | entier |
  `LDAP_OPT_SIZELIMIT` | entier |
  `LDAP_OPT_TIMELIMIT` | entier |
  `LDAP_OPT_NETWORK_TIMEOUT` | entier |
  `LDAP_OPT_PROTOCOL_VERSION` | entier |
  `LDAP_OPT_ERROR_NUMBER` | entier |
  `LDAP_OPT_DIAGNOSTIC_MESSAGE` | entier |
  `LDAP_OPT_REFERRALS` | booléen |
  `LDAP_OPT_RESTART` | booléen |
  `LDAP_OPT_HOST_NAME` | chaîne de caractères |
  `LDAP_OPT_ERROR_STRING` | chaîne de caractères |
  `LDAP_OPT_MATCHED_DN` | chaîne de caractères |
  `LDAP_OPT_SERVER_CONTROLS` | tableau |
  `LDAP_OPT_CLIENT_CONTROLS` | tableau |
  `LDAP_OPT_X_KEEPALIVE_IDLE` | entier | 7.1
  `LDAP_OPT_X_KEEPALIVE_PROBES` | entier | 7.1
  `LDAP_OPT_X_KEEPALIVE_INTERVAL` | entier | 7.1
  `LDAP_OPT_X_TLS_CACERTDIR` | string | 7.1
  `LDAP_OPT_X_TLS_CACERTFILE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_CERTFILE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_CIPHER_SUITE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_CRLCHECK` | entier | 7.1
  `LDAP_OPT_X_TLS_CRL_NONE` | entier | 7.1
  `LDAP_OPT_X_TLS_CRL_PEER` | entier | 7.1
  `LDAP_OPT_X_TLS_CRL_ALL` | entier | 7.1
  `LDAP_OPT_X_TLS_CRLFILE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_DHFILE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_KEYILE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_PACKAGE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_PROTOCOL_MIN` | entier | 7.1
  `LDAP_OPT_X_TLS_RANDOM_FILE` | chaîne de caractères | 7.1
  `LDAP_OPT_X_TLS_REQUIRE_CERT` | entier |

`retval`

  Valeur à définir pour l'option.

### Valeurs de retour

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

### Exemples

Exemple #1 Vérification de la version du protocole

`<?php
// $ds doit être une ressource de connexion valide
if (ldap_get_option($ds, LDAP_OPT_PROTOCOL_VERSION, $version)) {
echo "Nous utilisons le protocole version $version\n";
} else {
echo "Impossible de déterminer la version du protocole.\n";
}
?>`

### Notes

> Note:

> Cette fonction n'est disponible qu'avec OpenLDAP 2.x.x OU Netscape Directory SDK x.x, et a été ajoutée en PHP 4.0.4.

### Voir aussi

- ldap_set_option() - Modifie la valeur d'une option LDAP