ldap_connect

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_connect — Verbindet mit einem LDAP-Server

Beschreibung

ldap_connect(?string $uri = null): LDAP\Connection|false
Warnung

Seit PHP 8.3.0 ist die folgende Signatur veraltet.

ldap_connect(?string $host = null, int $port = 389): LDAP\Connection|false

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:port oder ldaps://hostname:port fü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:port kein unterstützter 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

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.3.0 Der Aufruf von ldap_connect() mit separaten hostname und port ist nun veraltet.
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" );

?>

Siehe auch