cubrid_get_charset — Funktion · PHP-Referenz

Signatur

cubrid_get_charset(resource $conn_identifier): string|false

Beschreibung

cubrid_get_charset() liefert den Namen des Zeichensatzes (Character Set), der für die angegebene CUBRID-Datenbankverbindung aktuell verwendet wird. Der Rückgabewert ist eine Zeichenkette wie utf-8, euc-kr oder iso8859-1.

Die Funktion ist nützlich, wenn man sicherstellen möchte, dass Daten korrekt kodiert übertragen werden, oder wenn man zur Laufzeit den Verbindungszeichensatz überprüfen und ggf. anpassen will. Sie ergänzt Funktionen wie cubrid_set_charset(), mit der der Zeichensatz der Verbindung geändert werden kann.

Der Einsatz empfiehlt sich besonders bei mehrsprachigen Anwendungen oder wenn Verbindungen zu CUBRID-Instanzen mit unterschiedlichen Zeichensatzkonfigurationen verwaltet werden müssen.

Parameter

Name	Typ	Default	Beschreibung
$conn_identifier Pflicht	resource		Eine gültige CUBRID-Verbindungsressource, die zuvor mit `cubrid_connect()` oder `cubrid_connect_with_url()` erzeugt wurde.

Rückgabewert

Typ

string|false

Beschreibung

Gibt den Namen des aktuellen Zeichensatzes als Zeichenkette zurück (z. B. utf-8). Im Fehlerfall (ungültige Verbindung o. Ä.) wird false zurückgegeben.

Beispiele

Aktuellen Zeichensatz einer CUBRID-Verbindung ausgeben

<?php
$conn = cubrid_connect('localhost', 33000, 'demodb', 'dba', '');

if ($conn) {
    $charset = cubrid_get_charset($conn);
    if ($charset !== false) {
        echo 'Aktueller Zeichensatz: ' . $charset;
    } else {
        echo 'Zeichensatz konnte nicht ermittelt werden.';
    }
    cubrid_disconnect($conn);
} else {
    echo 'Verbindung fehlgeschlagen.';
}
?>

Aktueller Zeichensatz: utf-8

Zeichensatz prüfen und bei Bedarf warnen

<?php
$conn = cubrid_connect('localhost', 33000, 'demodb', 'dba', '');

if ($conn) {
    $charset = cubrid_get_charset($conn);
    $expected = 'utf-8';

    if ($charset === $expected) {
        echo 'Verbindung verwendet den erwarteten Zeichensatz: ' . $charset;
    } else {
        echo 'Warnung: Unerwarteter Zeichensatz "' . $charset . '" (erwartet: "' . $expected . '").';
    }

    cubrid_disconnect($conn);
}
?>

Verbindung verwendet den erwarteten Zeichensatz: utf-8

// Wichtig · Fallstricke

Hinweis: Die CUBRID-PHP-Erweiterung muss auf dem System installiert und aktiviert sein, damit cubrid_get_charset() verfügbar ist. Diese Funktion ist nicht Teil der Standard-PHP-Distribution.

Bei der Verarbeitung von Benutzerdaten sollte sichergestellt werden, dass der zurückgegebene Zeichensatz mit dem erwarteten übereinstimmt, um Datenkorruption oder Sicherheitsprobleme (z. B. durch falsches Encoding bei der Datenbankabfrage) zu vermeiden.

Siehe auch

cubrid_connect cubrid_connect_with_url cubrid_set_charset cubrid_get_db_parameter cubrid_disconnect