Documentación offline PHP master

ldap_compare

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

ldap_compare

Comparar una entrada con valores de atributos

Descripción#

ldap_compare(LDAP\Connection $ldap, string $dn, string $attribute, string $value, [array $controls]): bool
```php

Permite comparar el valor `value` del atributo `attribute` con el valor del mismo atributo de la entrada `dn`.

## Parámetros

`ldap`  
Una instancia de `LDAP\Connection`, devuelta por `ldap_connect`.

`dn`  
El DN de la entrada LDAP.

`attribute`  
El nombre del atributo.

`value`  
El valor a comparar.

`controls`  
Array de [Controles LDAP](#ldap.controls) a enviar con la petición.

## Valores devueltos

Devuelve `true` si el valor `value` coincide, de lo contrario, devuelve `false`. Devuelve -1 si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `ldap` ahora espera una instancia de `LDAP\Connection` ; anteriormente, se esperaba un `resource` `ldap link` válido. |
| 8.0.0 | `controls` ahora acepta `null`; anteriormente, su valor predeterminado era `[]`. |
| 7.3.0 | Se añadió soporte para `controls`. |

## Ejemplos

El siguiente ejemplo muestra cómo verificar que dos contraseñas coinciden, siendo una de ellas la de una entrada del servidor LDAP.

Ejemplo completo de verificación de contraseña con LDAP

```php

Notas#

[!WARNING] ldap_compare NO puede ser utilizado para comparar valores binarios.