ldap_modify()函式—用法及示例

函式名：ldap_modify()

適用版本：PHP 4, PHP 5, PHP 7

用法：ldap_modify()函式用於修改LDAP目錄中的條目。它透過LDAP協議與LDAP伺服器進行通訊，將指定的修改應用於目標條目。

語法：bool ldap_modify ( resource $link_identifier , string $dn , array $entry )

引數：

• $link_identifier：LDAP連線識別符號，由ldap_connect()函式返回。
• $dn：要修改的目標條目的唯一名稱（Distinguished Name）。
• $entry：包含要應用於目標條目的修改的陣列。陣列中的每個元素都是一個關聯陣列，其中包含修改操作的型別（add、replace或delete）和相應的屬性名和值。

返回值：如果成功修改條目，則返回true；否則返回false。

示例：

$ldapconn = ldap_connect("ldap.example.com") or die("無法連線至LDAP伺服器");

ldap_set_option($ldapconn, LDAP_OPT_PROTOCOL_VERSION, 3); // 設定LDAP協議版本

if ($ldapconn) {
    // 繫結到LDAP伺服器（使用合適的使用者名稱和密碼）
    $ldapbind = ldap_bind($ldapconn, "cn=admin,dc=example,dc=com", "password");

    if ($ldapbind) {
        // 定義要修改的條目的DN
        $dn = "cn=John Doe,ou=users,dc=example,dc=com";

        // 定義要應用的修改
        $entry["givenName"] = "John";
        $entry["sn"] = "Doe";
        $entry["mail"] = "[email protected]";

        // 執行修改操作
        $result = ldap_modify($ldapconn, $dn, $entry);

        if ($result) {
            echo "條目修改成功";
        } else {
            echo "條目修改失敗";
        }
    } else {
        echo "LDAP繫結失敗";
    }
}

// 關閉LDAP連線
ldap_close($ldapconn);

此示例首先透過ldap_connect()函式建立與LDAP伺服器的連線。然後使用ldap_bind()函式繫結到伺服器，以便進行修改操作。接下來，定義要修改的目標條目的DN，並在$entry陣列中指定要應用的修改。最後，使用ldap_modify()函式執行修改操作，並根據返回值判斷修改是否成功。