ldap_add
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_add — Add entries to LDAP directory
說明
Add entries in the LDAP directory.
參數
-
ldap
-
通過 ldap_connect() 返回的 LDAP\Connection 實例。
-
dn
-
The distinguished name of an LDAP entity.
-
entry
-
An array that specifies the information about the entry. The values in the entries are indexed by individual attributes. In case of multiple values for an attribute, they are indexed using integers starting with 0.
<?php
$entry["attribute1"] = "value";
$entry["attribute2"][0] = "value1";
$entry["attribute2"][1] = "value2";
?> -
controls
-
Array of LDAP Controls to send with the request.
返回值
成功時返回 true
, 或者在失敗時返回 false
。
更新日誌
版本 | 說明 |
---|---|
8.1.0 |
現在 ldap 參數接受 LDAP\Connection
實例,之前接受 資源(resource)。
|
8.0.0 |
controls is nullable now; previously, it defaulted to [] .
|
7.3.0 |
Support for controls added
|
範例
示例 #1 Complete example with authenticated bind
<?php
$ds = ldap_connect("localhost"); // assuming the LDAP server is on this host
if ($ds) {
// bind with appropriate dn to give update access
$r = ldap_bind($ds, "cn=root, o=My Company, c=US", "secret");
// prepare data
$info["cn"] = "John Jones";
$info["sn"] = "Jones";
$info["objectclass"] = "person";
// add data to directory
$r = ldap_add($ds, "cn=John Jones, o=My Company, c=US", $info);
ldap_close($ds);
} else {
echo "Unable to connect to LDAP server";
}
?>
註釋
注意: 此函式可安全用於二進制對象。