函数名称:ldap_add()
适用版本:PHP 4, PHP 5, PHP 7
函数描述:ldap_add()函数用于将一个新的条目添加到LDAP目录中。
语法:bool ldap_add ( resource $link_identifier , string $dn , array $entry [, array $controls ] )
参数:
- $link_identifier:LDAP连接标识符,通过ldap_connect()函数获取。
- $dn:要添加的条目的唯一名称(Distinguished Name)。
- $entry:要添加的条目的属性和值的关联数组。
- $controls(可选):LDAP控制器数组,用于指定额外的操作和约束。
返回值:成功时返回true,失败时返回false。
示例:
// 连接到LDAP服务器
$ldapconn = ldap_connect("ldap://ldap.example.com") or die("无法连接到LDAP服务器");
// 绑定到LDAP服务器(使用管理员凭证)
$ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password") or die("无法绑定到LDAP服务器");
// 准备要添加的条目的属性和值
$entry = array();
$entry["cn"] = "John Doe";
$entry["sn"] = "Doe";
$entry["mail"] = "johndoe@example.com";
$entry["objectclass"] = "inetOrgPerson";
// 添加条目到LDAP目录
$dn = "cn=John Doe,ou=People,dc=example,dc=com";
$result = ldap_add($ldapconn, $dn, $entry);
// 检查添加结果
if ($result) {
echo "条目成功添加到LDAP目录";
} else {
echo "添加条目失败: " . ldap_error($ldapconn);
}
// 关闭LDAP连接
ldap_close($ldapconn);
上述示例演示了如何使用ldap_add()函数将一个新条目添加到LDAP目录中。首先,使用ldap_connect()函数建立与LDAP服务器的连接。然后,使用ldap_bind()函数进行身份验证。接下来,创建一个包含要添加的条目属性和值的关联数组。然后,指定要添加条目的唯一名称(Distinguished Name)。最后,调用ldap_add()函数将条目添加到LDAP目录中。如果添加成功,将显示一条成功消息,否则将显示错误消息。最后,使用ldap_close()函数关闭LDAP连接。