Start · Sprachen · PHP · Referenz · svn_auth_get_parameter

svn_auth_get_parameter

Funktion

Ruft einen zuvor gesetzten SVN-Authentifizierungsparameter anhand seines Schlüssels ab.

Kategorie: misc

Signatur

svn_auth_get_parameter(string $key): ?string

Beschreibung

svn_auth_get_parameter() gibt den Wert eines Authentifizierungsparameters zurück, der für die SVN-Verbindung gesetzt wurde. Diese Parameter steuern, wie sich PHP bei der Kommunikation mit einem Subversion-Repository (z. B. über HTTP, HTTPS oder svn://) authentifiziert.

Die Funktion gehört zur PECL-Erweiterung svn und arbeitet eng mit svn_auth_set_parameter() zusammen. Typische Schlüssel sind vordefinierte Konstanten wie SVN_AUTH_PARAM_DEFAULT_USERNAME, SVN_AUTH_PARAM_DEFAULT_PASSWORD oder SVN_AUTH_PARAM_NO_AUTH_CACHE, die steuern, welche Anmeldedaten beim Zugriff auf das Repository verwendet werden.

Die Funktion ist nützlich, wenn man den aktuell konfigurierten Zustand der SVN-Authentifizierung prüfen möchte, ohne ihn neu setzen zu müssen – beispielsweise um in Testkontexten zu verifizieren, ob bestimmte Zugangsdaten korrekt hinterlegt sind.

Parameter

Name Typ Default Beschreibung
$key Pflicht string Der Schlüssel des abzurufenden Authentifizierungsparameters. Typischerweise eine der vordefinierten SVN-Konstanten, z. B. SVN_AUTH_PARAM_DEFAULT_USERNAME oder SVN_AUTH_PARAM_DEFAULT_PASSWORD.

Rückgabewert

Typ
?string
Beschreibung
Gibt den Wert des Authentifizierungsparameters als string zurück, oder null, wenn der Parameter nicht gesetzt wurde.

Beispiele

Aktuellen SVN-Benutzernamen auslesen

<?php
// Zunächst einen Benutzernamen setzen
svn_auth_set_parameter(SVN_AUTH_PARAM_DEFAULT_USERNAME, 'max.mustermann');

// Anschließend den gesetzten Wert wieder auslesen
$username = svn_auth_get_parameter(SVN_AUTH_PARAM_DEFAULT_USERNAME);

echo 'SVN-Benutzername: ' . $username;
SVN-Benutzername: max.mustermann

Prüfen, ob ein Passwort gesetzt ist

<?php
// Passwort setzen
svn_auth_set_parameter(SVN_AUTH_PARAM_DEFAULT_PASSWORD, 'geheim123');

// Parameter auslesen und prüfen
$password = svn_auth_get_parameter(SVN_AUTH_PARAM_DEFAULT_PASSWORD);

if ($password !== null) {
    echo 'SVN-Passwort ist gesetzt.';
} else {
    echo 'Kein SVN-Passwort konfiguriert.';
}
SVN-Passwort ist gesetzt.

// Wichtig · Fallstricke

Sicherheitshinweis: SVN-Passwörter, die über svn_auth_set_parameter() gesetzt wurden, können über diese Funktion im Klartext ausgelesen werden. Passwörter sollten daher niemals in Ausgaben, Logs oder Fehlermeldungen erscheinen. Vermeiden Sie es, den Rückgabewert von SVN_AUTH_PARAM_DEFAULT_PASSWORD direkt auszugeben.

Die Funktion ist Teil der PECL-Erweiterung svn und steht nicht in der PHP-Standardinstallation zur Verfügung. Sie muss separat installiert werden (pecl install svn). Die Verfügbarkeit der einzelnen Konstanten kann je nach installierter Version der Erweiterung variieren.