cubrid_list_dbs — Funktion · PHP-Referenz

Signatur

cubrid_list_dbs(resource $conn_identifier): array|false

Beschreibung

cubrid_list_dbs() fragt den CUBRID-Datenbankserver über eine bestehende Verbindung nach allen verfügbaren Datenbanken ab und gibt deren Namen als indiziertes Array zurück. Dies entspricht konzeptionell dem Befehl SHOW DATABASES in MySQL-ähnlichen Systemen.

Die Funktion ist besonders nützlich, wenn eine Anwendung dynamisch entscheiden muss, welche Datenbanken auf einem Server existieren – etwa bei Verwaltungswerkzeugen, Backupskripten oder automatisierten Deployment-Prozessen. Es wird eine gültige CUBRID-Verbindungsressource benötigt, die zuvor mit cubrid_connect() oder cubrid_connect_with_url() erstellt wurde.

Im Fehlerfall – beispielsweise wenn die Verbindung ungültig ist oder der Server nicht antwortet – gibt die Funktion false zurück. Es empfiehlt sich daher, den Rückgabewert stets auf false zu prüfen, bevor das Array weiterverarbeitet wird.

Parameter

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

Rückgabewert

Typ

array|false

Beschreibung

Gibt ein indiziertes Array mit den Namen aller vorhandenen CUBRID-Datenbanken zurück. Im Fehlerfall wird false zurückgegeben.

Beispiele

Alle CUBRID-Datenbanken auflisten

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

if (!$conn) {
    die('Verbindung fehlgeschlagen: ' . cubrid_error());
}

$databases = cubrid_list_dbs($conn);

if ($databases === false) {
    echo 'Fehler beim Abrufen der Datenbankliste.' . PHP_EOL;
} else {
    echo 'Verfügbare Datenbanken:' . PHP_EOL;
    foreach ($databases as $index => $dbName) {
        echo ($index + 1) . '. ' . $dbName . PHP_EOL;
    }
}

cubrid_disconnect($conn);

Verfügbare Datenbanken: 1. demodb 2. testdb

Prüfen, ob eine bestimmte Datenbank existiert

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

if (!$conn) {
    die('Verbindung fehlgeschlagen.');
}

$searchDb = 'productiondb';
$databases = cubrid_list_dbs($conn);

if ($databases !== false && in_array($searchDb, $databases)) {
    echo "Die Datenbank '{$searchDb}' ist vorhanden." . PHP_EOL;
} else {
    echo "Die Datenbank '{$searchDb}' wurde nicht gefunden." . PHP_EOL;
}

cubrid_disconnect($conn);

Die Datenbank 'productiondb' wurde nicht gefunden.

// Wichtig · Fallstricke

Hinweis zur Verfügbarkeit: Die CUBRID-PHP-Erweiterung muss auf dem Server installiert und aktiviert sein (extension=cubrid.so bzw. cubrid.dll). Ohne diese Erweiterung steht cubrid_list_dbs() nicht zur Verfügung.

Berechtigungen: Der verwendete Datenbankbenutzer benötigt ausreichende Rechte, um Datenbanklistenabfragen durchführen zu dürfen. Andernfalls kann die Funktion false zurückgeben oder nur eine eingeschränkte Liste liefern.

Deprecation: Die CUBRID-PHP-Erweiterung wird seit PHP 8.0 nicht mehr aktiv entwickelt. Für neue Projekte sollte geprüft werden, ob aktuellere Treiber oder Alternativen verfügbar sind.

Siehe auch

cubrid_connect cubrid_connect_with_url cubrid_disconnect cubrid_error cubrid_get_db_parameter