ldap_parse_result

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

ldap_parse_result — 結果から情報を展開する

説明

ldap_parse_result(
    LDAP\Connection $ldap,
    LDAP\Result $result,
    int &$error_code,
    string &$matched_dn = null,
    string &$error_message = null,
    array &$referrals = null,
    array &$controls = null
): bool

LDAP の検索結果をパースします。

パラメータ

ldap: ldap_connect() が返す LDAP\Connection クラスのインスタンス。
result: ldap_list() や ldap_search() が返す、LDAP\Result クラスのインスタンス。.
error_code: 結果に含まれる LDAP エラーコードを格納する変数への参照。エラーが発生しなかった場合は、この変数に 0 を格納します。
matched_dn: リクエスト内にマッチする DN があった場合に、それを格納する変数への参照。なかった場合は、この変数に null を格納します。
error_message: 結果に含まれる LDAP エラーメッセージを格納する変数への参照。エラーが発生しなかった場合は、この変数に空文字列を格納します。
referrals: 結果に含まれるすべての照会文字列の配列を格納する変数への参照。存在しない場合は、この変数に空の配列を格納します。
controls: レスポンスを送信した LDAP コントロールの array。

戻り値

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

変更履歴

バージョン	説明
8.1.0	引数 `ldap` は、LDAP\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、リソースを期待していました。
8.1.0	引数 `result` は、 LDAP\Result クラスのインスタンスを期待するようになりました。これより前のバージョンでは、リソースを期待していました。
7.3	`controls` のサポートが追加されました。

例

例1 ldap_parse_result() の例


<?php
$result = ldap_search($link, "cn=userref,dc=my-domain,dc=com", "(cn=user*)");
$errcode = $dn = $errmsg = $refs =  null;
if (ldap_parse_result($link, $result, $errcode, $dn, $errmsg, $refs)) {
    // $errcode や $dn、$errmsg、$refs を使って何かをします。
}
?>

関連キーワード: 　変数, 格納, 展開, 情報, result, クラス, 期待, 参照, インスタンス, Connection