(PHP 4, PHP 5, PHP 7)
ldap_connect — Verbindet zu einem LDAP Server
$host
= NULL
[, int $port
= 389
]] )
Erzeugt einen LDAP Verbindungskennung und prüft, ob die
angegebenen host
und
port
plausibel sind.
Hinweis: Es ist zu beachten, dass diese Funktion keine Verbindung öffnet. Sie prüft, ob die übergebenen Parameter plausibel sind, und kann verwendet werden, um eine Verbindung zu öffnen sobald eine benötigt wird.
host
Dieser Parameter unterstützt einen Hostnamen, oder mit OpenLDAP 2.x.x und später, eine vollständige LDAP-URI der Form ldap://hostname:port oder ldaps://hostname:port für SSL-Verschlüsselung.
Es können ebenfalls mehrere LDAP-URIs getrennt durch Leerzeichen als eine Zeichenkette übergeben werden.
Es ist zu beachten, dass hostname:port keine unterstützte LDAP-URI ist, da das Schema fehlt.
port
Der Port zu dem eine Verbindung aufgebaut werden soll. Dies wird bei der Verwendung von LDAP-URIs nicht benutzt.
Liefert eine postive LDAP Verbindungskennung zurück, wenn die angegebene
Hostname/Port-Kombination oder LDAP-URI plausibel scheint. Es handelt sich um
eine Syntaxprüfung der übergebenen Paramter, aber der (oder die) Server
werden nicht kontaktiert! Schlägt die Syntaxprüfung fehlt, wird FALSE
zurückgegeben.
Wenn OpenLDAP 2.x.x verwendet wird,
liefert ldap_connect() immer eine gültige Resource
mit positiver Verbindungs-Kennung zurück. Die Verbindung zum LDAP-Server
wird noch nicht hergestellt, die Verbindung wird lediglich initialisiert.
Der Verbindungsaufbau erfolgt bei der nächsten Nutzung einer ldap_*
Funktion; Normalerweise ist dies ldap_bind().
Werden keine Argumente angegeben, wird die Verbindungs-Kennung einer bereits geöffneten Verbindung zurückgeliefert.
Beispiel #1 Verbindung zu einem LDAP server.
<?php
// LDAP Variablen
$ldaphost = "ldap.example.com"; // Ihr ldap server
$ldapport = 389; // Die Portnummer ihres ldap servers
// Verbindung zu LDAP
$ldapconn = ldap_connect($ldaphost, $ldapport)
or die( "Keine Verbindung zu $ldaphost möglich" );
?>
Beispiel #2 Sichere Verbindung zu einem LDAP server.
<?php
// Stellen Sie sicher, dass Sie den korrekten Host angeben,
// für den das Zertifikate ausgestellt wurde
$ldaphost = "ldaps://ldap.example.com/";
// Verbindung zu LDAP
$ldapconn = ldap_connect( $ldaphost )
or die( "Keine Verbindung zu {$ldaphost} möglich" );
?>