ldap_add

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_addAdd entries to LDAP directory

说明

ldap_add(
    LDAP\Connection $ldap,
    string $dn,
    array $entry,
    ?array $controls = null
): bool

Add entries in the LDAP directory.

参数

ldap

An LDAP\Connection instance, returned by ldap_connect().

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 The ldap parameter expects an LDAP\Connection instance now; previously, a 资源(resource) was expected.
8.0.0 controls is nullable now; previously, it defaulted to [].
7.3 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";
}
?>

注释

注意: 此函数可安全用于二进制对象。

参见