ldap_exop_passwd
(PHP 7 >= 7.2.0)
ldap_exop_passwd — PASSWD extended operation helper
说明
ldap_exop_passwd (
resource
$link
[,
string $user
= "" [,
string $oldpw
= "" [,
string $newpw
= "" [,
array &$serverctrls
]]]] ) :
mixed
Performs a PASSWD extended operation.
参数
-
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.
返回值
Returns the generated password if newpw
is empty or omitted. Otherwise returns TRUE
on success and FALSE
on failure.
更新日志
版本 | 说明 |
---|---|
7.3 | Support for serverctrls added |
范例
Example #1 PASSWD extended operation
<?php
$ds = ldap_connect("localhost"); // assuming the LDAP server is on this host
if ($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";
}
?>
参见
- ldap_exop() - Performs an extended operation
- ldap_parse_exop() - Parse result object from an LDAP extended operation