ldap_connect

(PHP 4, PHP 5, PHP 7)

ldap_connectVerbindet zu einem LDAP Server

Beschreibung

ldap_connect ([ string $ldap_uri = NULL ] ) : resource
Warnung

Die folgende Signatur wird aus Gründen der Abwärtskompatibilität weiterhin unterstützt, wird aber als veraltet betrachtet und sollte nicht mehr verwendet werden!

ldap_connect ([ string $host = NULL [, int $port = 389 ]] ) : resource

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

ldap_uri

Eine vollständige LDAP URI der Form ldap://hostname:port oder ldaps://hostname:port für SSL-Verschlüsselung.

Es können auch mehrere LDAP-URIs, gtrennt dich ein Leerzeichen, als ein String angegebene werden.

Es muss beachtet werden, dass hostname:port keine unterstützte LDAP URI ist, da das Schema fehlt.

host

Der Hostname zu dem eine Verbindung aufgebaut werden soll.

port

Der Port zu dem eine Verbindung aufgebaut werden soll.

Rückgabewerte

Liefert eine postive LDAP Verbindungskennung zurück, wenn die angegebene 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. Andernfalls 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().

Wird kein Argumente angegeben, wird die Verbindungs-Kennung einer bereits geöffneten Verbindung zurückgeliefert.

Beispiele

Beispiel #1 Verbindung zu einem LDAP server.

<?php

// LDAP Variablen
$ldapuri "ldap://ldap.example.com:389";  // Ihre ldap-uri

// Verbindung zu LDAP
$ldapconn ldap_connect($ldapuri)
    or die( 
"Die LDAP-URI konnte nicht gepasst werden" );
    
?>

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( 
"Die LDAP-URI konnte nicht gepasst werden" );

?>

Siehe auch