ldap_connect
(PHP 4, PHP 5, PHP 7, PHP 8)
ldap_connect — Verbindet mit einem LDAP-Server
Beschreibung
Die folgende Signatur wird aus Gründen der Abwärtskompatibilität (von der Verwendung benannter Parameter abgesehen) weiterhin unterstützt, wird aber als veraltet betrachtet und sollte nicht mehr verwendet werden!
Erzeugt eine LDAP\Connection-Verbindung und prüft, ob der angegebene
uri plausibel ist.
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
-
uri -
Ein vollständiger LDAP-URI der Form
ldap://hostname:portoderldaps://hostname:portfür SSL-Verschlüsselung.Es können auch mehrere LDAP-URIs, getrennt durch ein Leerzeichen, als eine Zeichenkette angegeben werden.
Es muss beachtet werden, dass
hostname:portkein unterstützter LDAP-URI ist, da das Schema fehlt. -
uri -
Der Hostname, zu dem eine Verbindung aufgebaut werden soll.
-
port -
Der Port, zu dem eine Verbindung aufgebaut werden soll.
Rückgabewerte
Gibt eine LDAP\Connection-Instanz zurück, wenn der angegebene
LDAP-URI plausibel scheint. Es handelt sich um eine Syntaxprüfung der
übergebenen Parameter, aber Server werden nicht kontaktiert! Schlägt die
Syntaxprüfung fehl, wird false zurückgegeben. Andernfalls gibt
ldap_connect() immer eine gültige LDAP\Connection-Instanz mit
positiver Verbindungskennung zurück. Die Verbindung zum LDAP-Server wird
noch nicht hergestellt, sie 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 LDAP\Connection-Instanz einer bereits geöffneten Verbindung zurückgegeben.
Changelog
| Version | Beschreibung |
|---|---|
| 8.1.0 | Gibt nun eine LDAP\Connection-Instanz zurück; vorher wurde eine Ressource zurückgegeben. |
Beispiele
Beispiel #1 Verbindung zu einem LDAP-Server
<?php
// LDAP-Variablen
$ldapuri = "ldap://ldap.example.com:389"; // Ihr LDAP-URI
// Verbindung zu LDAP
$ldapconn = ldap_connect($ldapuri)
or die( "Der LDAP-URI konnte nicht geparst werden" );
?>
Beispiel #2 Sichere Verbindung zu einem LDAP-Server
<?php
// Stellen Sie sicher, dass Sie den korrekten Host angeben,
// für den das Zertifikat ausgestellt wurde
$ldaphost = "ldaps://ldap.example.com/";
// Verbindung zu LDAP
$ldapconn = ldap_connect($ldaphost)
or die( "Der LDAP-URI konnte nicht geparst werden" );
?>
