LDAP Funktionen
PHP Manual

ldap_connect

(PHP 4, PHP 5, PHP 7)

ldap_connectVerbindet zu einem LDAP Server

Beschreibung

resource ldap_connect ([ string $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.

Parameter-Liste

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.

Rückgabewerte

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.

Beispiele

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" );

?>

Siehe auch


LDAP Funktionen
PHP Manual