Verbindet mit einem LDAP-Server

# ldap_connect

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

ldap_connect — Verbindet mit einem LDAP-Server

### Beschreibung

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

Seit PHP 8.3.0 ist die folgende Signatur veraltet.

function 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

- ldap_bind() - Anmeldung an einem LDAP-Verzeichnis

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open