Php/docs/function.ldap-exop-passwd

From Get docs

ldap_exop_passwd

(PHP 7 >= 7.2.0)

ldap_exop_passwdPASSWD extended operation helper


Description

ldap_exop_passwd ( resource $link [, string $user = "" [, string $oldpw = "" [, string $newpw = "" [, array &$serverctrls ]]]] ) : mixed

Performs a PASSWD extended operation.


Parameters

link
An LDAP link identifier, returned by ldap_connect().
user
dn of the user to change the password of.
oldpw
The old password of this user. May be ommited depending of server configuration.
newpw
The new password for this user. May be omitted or empty to have a generated password.
serverctrls
If provided, a password policy request control is send with the request and this is filled with an array of LDAP Controls returned with the request.


Return Values

Returns the generated password if newpw is empty or omitted. Otherwise returns TRUE on success and FALSE on failure.


Changelog

Version Description
7.3 Support for serverctrls added


Examples

Example #1 PASSWD extended operation

<?php$ds = ldap_connect("localhost");  // assuming the LDAP server is on this hostif ($ds) {    // bind with appropriate dn to give update access    $bind = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");    if (!$bind) {      echo "Unable to bind to LDAP server";      exit;    }    // use PASSWD EXOP to change the user password for a generated one    $genpw = ldap_exop_passwd($ds, "cn=root, o=My Company, c=US", "secret");    if ($genpw) {      // use the generated password to bind      $bind = ldap_bind($ds, "cn=root, o=My Company, c=US", $genpw);    }    // set the password back to "secret"    ldap_exop_passwd($ds, "cn=root, o=My Company, c=US", $genpw, "secret");    ldap_close($ds);} else {    echo "Unable to connect to LDAP server";}?>

See Also