LDAP　搜尋測試

";

if　($ds)　{　
　　　　echo　"Binding　...";　
　　　　$r=ldap_bind($ds);　　　　　　　　　　//　匿名的　bind，為唯讀屬性
　　　　echo　"Bind　傳回　".$r."

";
　　　　echo　"Searching　for　(sn=S*)　...";　　//　找尋　S　開頭的姓氏
　　　　$sr=ldap_search($ds,"o=My　Company,　c=US",　"sn=S*");　　
　　　　echo　"Search　傳回　".$sr."

";
　　　　echo　"S　開頭的姓氏有　".ldap_count_entries($ds,$sr)."　個

";
　　　　echo　"取回姓氏資料　...

";
　　　　$info　=　ldap_get_entries($ds,　$sr);
　　　　echo　"資料傳回　".$info["count"]."　筆:

";
　　　　for　($i=0;　$i<$info["count"];　$i++)　{
　　　　　　　　echo　"dn　為:　".　$info[$i]["dn"]　."
";
　　　　　　　　echo　"cn　為:　".　$info[$i]["cn"][0]　."
";
　　　　　　　　echo　"email　為:　".　$info[$i]["mail"][0]　."

";
　　　　}
　　　　echo　"關閉連結";
　　　　ldap_close($ds);
}　else　{
　　　　echo　"

無法連接到　LDAP　伺服器

\n";
for　($i=0;　$i<$attrs["count"];　$i++)　{
　　echo　$attrs[$i]."
";
}
?>　

　
　
參考　


ldap_first_attribute()　　ldap_next_attribute()　　


--------------------------------------------------------------------------------
　函式:ldap_get_dn()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_get_dn
取得　DN　值。

語法:　string　ldap_get_dn(int　handle,　int　result_entry_identifier);

傳回值:　字串

函式種類:　網路系統


　
　
內容說明　


本函式用來取得　LDAP　的顯名　(DN,　distinguished　name)字串值。參數　handle　為開啟　LDAP　的代號。參數　result_identifier　為　ldap_search()　所傳回的搜尋代號。若有錯誤則傳回　false。

　

--------------------------------------------------------------------------------
　函式:ldap_get_entries()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_get_entries
取得全部傳回資料。

語法:　array　ldap_get_entries(int　handle,　int　result_identifier);

傳回值:　陣列

函式種類:　網路系統


　
　
內容說明　


本函式用來取得　LDAP　的全部傳回資料。參數　handle　為開啟　LDAP　的代號。傳回值為陣列資料，例如

return_value["count"]　:　傳回資料筆數
return_value[0]　:　第一筆傳回資料
return_value[i]["dn"]　:　第　i+1　筆資料的　DN
return_value[i]["count"]　:　第　i+1　筆資料的數目
return_value[i][j]　:　第　i+1　筆資料的第　j　值
return_value[i]["attribute"]["count"]　:　第　i+1　筆資料的屬性數
return_value[i]["attribute"][j]　:　第　i+1　筆資料的第　j　個屬性


　
　
參考　


ldap_first_entry()　　ldap_next_entry()　　
　

--------------------------------------------------------------------------------
　函式:ldap_get_values()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_get_values
取得全部傳回值。

語法:　array　ldap_get_values(int　handle,　int　result_entry_identifier,　string　attribute);

傳回值:　陣列

函式種類:　網路系統


　
　
內容說明　


本函式用來取得　LDAP　的全部傳回資料值。參數　handle　為開啟　LDAP　的代號。參數　attribute　有　surname　及　mail　二種。傳回值為陣列資料值，例如

return_value["count"]　:　屬性值總數
return_value[0]　:　第一個屬性值
return_value[i]　:　第　i+1　個屬性值


　
　
使用范例　


下例為片段程式

$values　=　ldap_get_values($ds,　$entry,　"mail");
echo　$values["count"]."　筆電子郵件地址:　

\n";
for　($i=0;　$i　<　$values["count"];　$i++)　{
　　echo　$values[$i]."
";
}
?>　

--------------------------------------------------------------------------------
　函式:ldap_list()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_list
列出簡表。

語法:　int　ldap_list(int　handle,　string　base_dn,　string　filter,　array　[attributes]);

傳回值:　整數

函式種類:　網路系統


　
　
內容說明　


本函式用來列出單層　(One　Level)　的資料，實際上它等ldap_searchldap_search()，只是將值域改成　LDAP_SCOPE_ONELEVEL，本函式作用有點像　DOS　的　dir　或是　UNIX　的　ls。參數　handle　為開啟　LDAP　的代號。參數　base_dn　為最基本的　dn　條件值，例如包括　o　和　c　二欄位。參數　filter　為布林條件，它的語法可以在　Netscape　站上找一份　dirsdkpg.pdf　檔案，其中的　Search　Syntax　一部份有詳細的說明。參數　attributes　可省略，用來設定更細的列出屬性。　


　
　
使用范例　


這個范例為片段程式

$basedn　=　"o=SuperPHP　Company,　c=TW";
$justthese　=　array("ou");
$sr=ldap_list($ds,　$basedn,　"ou=*",　$justthese);
$info　=　ldap_get_entries($ds,　$sr);
for　($i=0;　$i<$info["count"];　$i++)　{
　　echo　$info[$i]["ou"][0]　;
}
?>　

　
　
參考　


ldap_read()　　ldap_search()　　


--------------------------------------------------------------------------------
　函式:ldap_modify()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_modify
改變　LDAP　名錄的屬性。

語法:　boolean　ldap_modify(int　handle,　string　dn,　array　entry);

傳回值:　布林值

函式種類:　網路系統


　
　
內容說明　


本函式用來改變　LDAP　伺服器上目前所在名錄上的屬性。參數　handle　為開啟　LDAP　的代號。參數　dn　為要加入條目的具體　dn　字串。參數　entry　為陣列，為個體所有的屬性，陣列的內容是名錄屬性的相關資訊。若無錯誤則傳回　true　值。


　
　
使用范例　


本例為　nickt@powys.gov.uk　提出的片段　(23-Apr-1999)

$newinfo[mail]="nick@county.gov.uk";
ldap_modify($valid_ldaplink,　$valid_dn,　$newinfo);
?>　

　
　
參考　


ldap_mod_add()　　



--------------------------------------------------------------------------------
　函式:ldap_next_attribute()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_next_attribute
取得傳回資料的下筆屬性。

語法:　string　ldap_next_attribute(int　handle,　int　result_entry_identifier,　int　ber_identifier);

傳回值:　字串

函式種類:　網路系統


　
　
內容說明　


本函式用來取得　LDAP　中所在傳回的下筆屬性。參數　handle　為開啟　LDAP　的代號。參數　result_entry_identifier　將由　ldap_next_attribute()　沿用。參數　ber_identifier　為指標，意即需在前面加上　&　符號。


　
　
參考　


ldap_get_attributes()　　ldap_first_attribute()　　
　

--------------------------------------------------------------------------------
　函式:ldap_next_entry()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_next_entry
取得下一筆結果代號。

語法:　int　ldap_next_entry(int　handle,　int　result_entry_identifier);

傳回值:　整數

函式種類:　網路系統


　
　
內容說明　


本函式用來取得　LDAP　中目前指標的下筆資料代號。參數　handle　為開啟　LDAP　的代號。參數　result_identifier　為　ldap_search()　所傳回的搜尋代號。若有錯誤則傳回　false。


　
　
參考　


ldap_first_entry()　　ldap_get_entries()　　

--------------------------------------------------------------------------------
　函式:ldap_read()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_read
取得目前的資料屬性。

語法:　int　ldap_read(int　handle,　string　base_dn,　string　filter,　array　[attributes]);

傳回值:　整數

函式種類:　網路系統


　
　
內容說明　


本函式用來列出樹狀資料，它的值域條件是　LDAP_SCOPE_BASE。參數　handle　為開啟　LDAP　的代號。參數　base_dn　為最基本的　dn　條件值，例如包括　o　和　c　二欄位。參數　filter　為布林條件，它的語法可以在　Netscape　站上找一份　dirsdkpg.pdf　檔案，其中的　Search　Syntax　一部份有詳細的說明。參數　attributes　可省略，用來設定更細的列出屬性。


　
　
參考　


ldap_list()　　ldap_search()　　
　

--------------------------------------------------------------------------------
　函式:ldap_search()　
--------------------------------------------------------------------------------
　


LDAP　目錄協定函式庫


ldap_search
列出樹狀簡表。

語法:　int　ldap_search(int　handle,　string　base_dn,　string　filter,　array　[attributes]);

傳回值:　整數

函式種類:　網路系統


　
　
內容說明　


本函式用來列出樹狀資料，它的值域條件是　LDAP_SCOPE_SUBTREE。參數　handle　為開啟　LDAP　的代號。參數　base_dn　為最基本的　dn　條件值，例如包括　o　和　c　二欄位。參數　filter　為布林條件，它的語法可以在　Netscape　站上找一份　dirsdkpg.pdf　檔案，其中的　Search　Syntax　一部份有詳細的說明。參數　attributes　可省略，用來設定更細的列出屬性。


　
　
使用范例　


下面范例為片段程式

$dn　=　"o=SuperLDAP　Company,　c=TW";
$filter="(|(sn=$person*)(givenname=$person*))";
$justthese　=　array(　"ou",　"sn",　"givenname",　"mail");
$sr=ldap_search($ds,　$dn,　$filter,　$justthese);
$info　=　ldap_get_entries($ds,　$sr);
print　$info["count"]."　entries　returned