PHP中ldap_add 什么意思？如何使用？

摘要

ldap_add() 是 PHP 中 LDAP 扩展的一个函数，用于在 LDAP 目录中添加一个新条目。它根据指定 distinguished name (DN) 和属性值创建一个新的目录条目。

详细说明

语法

bool ldap_add(LDAPConnection $link, string $dn, array $entry)

参数

• $link: LDAP 连接标识符
• $dn: 新条目的 distinguished name (DN)
• $entry: 一个关联数组，其中键是属性名称，值是该属性的值

返回值

成功时返回 TRUE，失败时返回 FALSE。

如何使用

要使用 ldap_add() 函数，请按照以下步骤操作：

1. 使用 ldap_connect() 或 ldap_connect_ext() 函数建立与 LDAP 服务器的连接。
2. 绑定到 LDAP 服务器。
3. 使用以下语法调用 ldap_add() 函数：

$entry = [
    "cn" => "John Doe",
    "sn" => "Doe",
    "mail" => "john.doe@example.com",
];

ldap_add($link, "cn=John Doe,dc=example,dc=com", $entry);

在这个示例中，我们添加了一个名为 "John Doe" 的新条目，DN 为 "cn=John Doe,dc=example,dc=com"，属性值为：

• cn: John Doe
• sn: Doe
• mail: john.doe@example.com

示例

以下是一个完整的示例，演示如何使用 ldap_add() 函数：

<?php

// 建立与 LDAP 服务器的连接
$link = ldap_connect("ldap.example.com");

// 绑定到 LDAP 服务器
ldap_bind($link, "cn=admin,dc=example,dc=com", "secret");

// 创建要添加的新条目
$entry = [
    "cn" => "John Doe",
    "sn" => "Doe",
    "mail" => "john.doe@example.com",
];

// 添加新条目
if (ldap_add($link, "cn=John Doe,dc=example,dc=com", $entry)) {
    echo "用户 "John Doe" 已成功添加到 LDAP 目录中。";
} else {
    echo "添加用户时出错。";
}

// 关闭 LDAP 连接
ldap_close($link);

附加说明

• ldap_add() 函数是创建一个新条目的原子操作。如果 DN 已经存在，则 LDAP 操作将失败。
• 如果要添加的属性包含特殊字符，则需要对其进行转义，以符合 LDAP 语法。
• 还可以使用 ldap_modify_batch() 函数批量添加多个新条目。

以上就是PHP中ldap_add 什么意思？如何使用？的详细内容，更多请关注编程网其它相关文章！