Start · Sprachen · PHP · Referenz · mcrypt_get_cipher_name

mcrypt_get_cipher_name

Funktion

Liefert den menschenlesbaren Namen einer angegebenen Verschlüsselungs-Chiffre als Zeichenkette.

seit PHP 4.0.2 Kategorie: crypto

Signatur

mcrypt_get_cipher_name(int|string $cipher): string|false

Beschreibung

mcrypt_get_cipher_name() gibt den vollständigen, menschenlesbaren Namen einer Verschlüsselungs-Chiffre zurück. Der Parameter kann entweder eine Ganzzahl-Konstante (z. B. MCRYPT_DES) oder eine Zeichenkette mit dem Cipher-Namen (z. B. 'rijndael-128') sein.

Die Funktion ist nützlich, um programmatisch zu prüfen, welcher Cipher hinter einer gegebenen Konstante steckt, oder um den Anzeigenamen einer Chiffre für Logging- und Diagnosezwecke zu ermitteln. Sie eignet sich gut in Kombination mit mcrypt_list_algorithms(), um alle verfügbaren Algorithmen samt ihren lesbaren Namen auszugeben.

Wichtiger Hinweis: Die gesamte mcrypt-Erweiterung gilt seit PHP 7.1 als veraltet (deprecated) und wurde in PHP 7.2 vollständig entfernt. Für neue Projekte sollte stattdessen openssl_* oder die sodium_*-Funktionen verwendet werden.

Parameter

Name Typ Default Beschreibung
$cipher Pflicht int|string Eine mcrypt-Cipher-Konstante (z. B. MCRYPT_RIJNDAEL_128) oder ein Cipher-Name als Zeichenkette (z. B. 'tripledes').

Rückgabewert

Typ
string|false
Beschreibung
Gibt den menschenlesbaren Namen der Chiffre als string zurück. Falls die Chiffre nicht gefunden oder nicht unterstützt wird, gibt die Funktion false zurück.

Beispiele

Cipher-Name über Konstante ermitteln

<?php
// Gibt den lesbaren Namen der AES-128-Chiffre aus
$name = mcrypt_get_cipher_name(MCRYPT_RIJNDAEL_128);
if ($name !== false) {
    echo 'Cipher-Name: ' . $name . PHP_EOL;
} else {
    echo 'Unbekannte Chiffre.' . PHP_EOL;
}
Cipher-Name: Rijndael-128

Alle verfügbaren Cipher-Namen ausgeben

<?php
// Alle unterstützten Algorithmen mit ihren lesbaren Namen auflisten
$algorithms = mcrypt_list_algorithms();
foreach ($algorithms as $algo) {
    $name = mcrypt_get_cipher_name($algo);
    echo sprintf('%-20s => %s', $algo, $name) . PHP_EOL;
}
tripledes => TripleDES blowfish => Blowfish rijndael-128 => Rijndael-128 ...

// Wichtig · Fallstricke

Veraltet (deprecated) seit PHP 7.1: Die mcrypt-Erweiterung wurde in PHP 7.1 als veraltet markiert und in PHP 7.2 vollständig entfernt. Code, der mcrypt_get_cipher_name() verwendet, erzeugt in PHP 7.1 eine E_DEPRECATED-Warnung und ist in PHP 7.2+ nicht mehr ausführbar.

Für neue oder zu migrierende Projekte sollte ausschließlich openssl_get_cipher_methods() (zum Auflisten) oder die sodium_*-Bibliothek eingesetzt werden, da diese modernen Sicherheitsstandards entsprechen und aktiv gepflegt werden.