ldap_connect
(PHP 4, PHP 5, PHP 7)
ldap_connect — LDAP サーバーへ接続する
説明
ldap_connect
([ string $ldap_uri = null
] ) : resource
警告 次の シグナチャは後方互換のためまだサポートされていますが、 非推奨と見なされているのでもう使わないでください！
ldap_connect
([ string $host = null
[, int $port = 389
]] ) : resource
LDAP リンク ID を作成して、指定した
host および port
が妥当であるかどうかを調べます。
注意:
注意: この関数は、接続を確立するするわけでは ありません。 指定したパラメータが妥当であり、必要に応じて接続をオープンできるかどうかを調べるだけです。
パラメータ
ldap_uri完全な LDAP URI を指定します。
ldap://hostname:port形式、あるいは SSL を用いる場合はldaps://hostname:port形式が使えます。複数の LDAP URI を指定する場合は、間にスペースをはさんだひとつの文字列とします。
hostname:port形式は LDAP URI としてサポートされないことに注意しましょう。 スキーマが抜けているからです。host接続するホスト名
port接続するポート。
返り値
LDAP URI が妥当であると思われる場合に正の LDAP リンク ID を返します。
これは単なる構文チェックであり、実際にサーバーに接続するわけではありません。
構文チェックに失敗した場合は false を返します。
失敗していない場合は、ldap_connect() は常に resource
を返しますが、実際には接続せずにパラメータの初期化だけを行います。
実際に接続するのは次に ldap_* 関数がコールされた際で、これは
通常は ldap_bind() です。
引数が指定されない場合、既に開かれているリンクのリンク ID を返します。
例
例1 LDAP サーバーに接続する例
<?php// LDAP 変数$ldapuri = "ldap://ldap.example.com:389"; // ldap-uri// LDAP に接続します$ldapconn = ldap_connect($ldapuri) or die("That LDAP-URI was not parseable");?>
例2 LDAP サーバーへのセキュアな接続の例
<?php// サーバー証明書が証明するホストであることを// 確認する$ldaphost = "ldaps://ldap.example.com/";// LDAP に接続します$ldapconn = ldap_connect($ldaphost) or die("That LDAP-URI was not parseable");?>
