« ldap_errno
ldap_escape »

ldap_error

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

ldap_error — 直近の LDAP コマンドの LDAP エラーメッセージを返す

説明

function ldap_error(LDAP\Connection $ldap): string

指定した ldap に関して、 直近の LDAP コマンドにより生成されたエラーを表すエラーメッセージ文字列を返します。 LDAP errno 番号は標準化されていますが、ライブラリによって異なる (あるいはローカライズされた)エラーメッセージを返します。 エラーメッセージの内容をチェックするのではなく、 必ずエラー番号をチェックするようにしてください。

php.ini で警告レベルを十分に下げるか、 警告出力を抑制するために LDAP コマンドの前に @ 文字をつけない限り、発生したエラーは HTML 出力にも表示されます。

パラメータ

ldap

ldap_connect() が返す LDAP\Connection クラスのインスタンス。

戻り値

エラーメッセージ文字列を返します。

変更履歴

バージョン 説明
8.1.0 引数 ldap は、LDAP\Connection クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、有効な ldap link resource を期待していました。

参考

  • ldap_err2str() - LDAP のエラー番号をエラーメッセージ文字列に変換する
  • ldap_errno() - 直近の LDAP コマンドの LDAP エラー番号を返す

関連キーワード:
ldap   エラーメッセージ   直近   番号   errno   Connection   チェック   インスタンス   期待   escape   標準化   ライブラリ   ローカライズ   レベル   抑制   connect   履歴   link   resource   参考
関連する関数・ページ:
function.ldap-err2str   function.ldap-errno   function.ldap-t61-to-8859   function.ldap-count-references   function.ldap-8859-to-t61   function.ldap-get-dn