ldap_compare
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_compareNO puede ser utilizado para comparar valores binarios.