ldap_mod_add

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

ldap_mod_add — 現在の属性に属性を追加する

説明

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

指定した dn に属性を追加します。新しいオブジェクト全体を追加する用途については、 ldap_add() 関数を参照ください。

パラメータ

ldap: ldap_connect() が返す LDAP\Connection クラスのインスタンス。
dn: LDAP エンティティの識別名。
entry: 追加する属性値を一覧にした連想配列。属性が存在しない場合は追加されます。属性が存在する場合は、その属性が複数の値をサポートしている場合のみ追加できます。
controls: リクエストと一緒に送信する LDAP コントロールの配列

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン	説明
8.1.0	引数 `ldap` は、LDAP\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、有効な `ldap link` リソースを期待していました。
8.0.0	`controls` は、nullable になりました。これより前のバージョンでは、デフォルト値が `[]` でした。
7.3.0	`controls` のサポートが追加されました。

注意

注意: この関数はバイナリデータに対応しています。

参考

ldap_mod_add_ext() - 現在の属性に属性を追加する
ldap_mod_del() - 現在の属性から属性を削除する
ldap_mod_replace() - 属性を新規の値に置換する
ldap_modify_batch() - LDAP エントリの変更をまとめて実行する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 4 notes

down

theiderich AT laweekly dot com ¶

19 years ago

When adding/editing attributes for a user, the 'memberof' attribute is a special case.  The memberOf attribute is not an accessible attribute of the user schema. To add someone to a group, you have to add the user in the group, and not the group in the user. You can do this by accessing the group attribute 'member':

<?php

$group_name = "CN=MyGroup,OU=Groups,DC=example,DC=com";
$group_info['member'] = $dn; // User's DN is added to group's 'member' array
ldap_mod_add($connect,$group_name,$group_info);

?>

down

bart-holland at wedefo dot nl ¶

11 years ago

Adding a user to a group in Apple's OpenDirectory goes as follows: 

<?php

$dn = "cn=groupname,cn=groups,dc=example,dc=com";
$entry['memberuid'] = "username";

ldap_mod_add($connect, $dn, $entry);

?>

down

JoshuaStarr at aelana dot com ¶

23 years ago

To add a new attribute with a single value:



$entry[mail] = "newmail@aelana.com";

$results = ldap_mod_add($ldapConnID, $dn, $entry);



To add a new attribute with multiple values:



$entry[mail][] = "newmail@aelana.com";

$entry[mail][] = "altnewmail@aelana.com";

$results = ldap_mod_add($ldapConnID, $dn, $entry);

down

-5

Claudio Lente <nelchael at ig dot com dot br> ¶

21 years ago

Using PHP 4.2.3 with IIS 5 and Win2k Server. My confs are:

$ldap_srvr = 'servername' ;
$ldap_port = 389;
$ldap_con = ldap_connect($ldap_srvr, $ldap_port);
$ldap_rdn  = "username";
$ldap_pwd = "__password__"; 

$ldap_vbind = ldap_bind($ldap_con, $ldap_rdn, $ldap_pwd);

$base_dn= 'CN=username,CN=Users,DC=domain,DC=org,DC=us
' ;
$ldap_filter= 'objectClass=*';

$info['mail']='username@domain.org.us';

ldap_mod_add($ldap_con, $base_dn, $info);
ldap_add($ldap_con, $base_dn, $info);

this generate an error: 
- Warning: LDAP: modify operation could not be completed. in 

ldap_modify($ldap_con, $base_dn, $info);

this function corretly.

It?s all.

＋add a note