array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.cubrid-pconnect.php', 1 => 'cubrid_pconnect', 2 => 'Öffnet eine dauerhafte Verbindung zu einem CUBRID-Server', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'CUBRID Funktionen', ), 'prev' => array ( 0 => 'function.cubrid-num-rows.php', 1 => 'cubrid_num_rows', ), 'next' => array ( 0 => 'function.cubrid-pconnect-with-url.php', 1 => 'cubrid_pconnect_with_url', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/cubrid/functions/cubrid-pconnect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

cubrid_pconnect

(PECL CUBRID >= 8.3.1)

cubrid_pconnect — Öffnet eine dauerhafte Verbindung zu einem CUBRID-Server

Beschreibung

function cubrid_pconnect(
    string $host,
    int $port,
    string $dbname,
    string $userid = ?,
    string $passwd = ?
): resource

Stellt eine dauerhafte Verbindung zu einem CUBRID-Server her.

cubrid_pconnect() verhält sich sehr ähnlich wie cubrid_connect(), mit zwei wesentlichen Unterschieden.

Erstens versucht die Funktion beim Verbinden zunächst, eine (dauerhafte) Verbindung zu finden, die bereits mit demselben Host, Port, dbname und userid geöffnet ist. Wird eine gefunden, wird stattdessen ein Identifikator dafür zurückgegeben, anstatt eine neue Verbindung zu öffnen.

Zweitens wird die Verbindung zum SQL-Server nicht geschlossen, wenn die Ausführung des Skripts endet. Stattdessen bleibt die Verbindung für die spätere Verwendung offen (cubrid_close() oder cubrid_disconnect() schließen keine Verbindungen, die von cubrid_pconnect() hergestellt wurden).

Diese Art von Verbindung wird deshalb als „dauerhaft“ (persistent) bezeichnet.

Parameter-Liste

host
Hostname oder IP-Adresse des CUBRID-CAS-Servers.
port
Portnummer des CUBRID-CAS-Servers (BROKER_PORT, konfiguriert in $CUBRID/conf/cubrid_broker.conf).
dbname
Name der Datenbank.
userid
Benutzername für die Datenbank.
passwd
Benutzerpasswort.

Rückgabewerte

Verbindungs-Identifikator im Erfolgsfall,Bei einem Fehler wird false zurückgegeben..

Beispiele

Beispiel #1 Beispiel für cubrid_pconnect()

<?php
printf("%-30s %s\n", "CUBRID PHP Version:", cubrid_version());

printf("\n");

$conn = cubrid_pconnect("localhost", 33000, "demodb", "dba");

if (!$conn) {
die('Connect Error ('. cubrid_error_code() .')' . cubrid_error_msg());
}

$db_params = cubrid_get_db_parameter($conn);

while (list($param_name, $param_value) = each($db_params)) {
printf("%-30s %s\n", $param_name, $param_value);
}

printf("\n");

$server_info = cubrid_get_server_info($conn);
$client_info = cubrid_get_client_info();

printf("%-30s %s\n", "Server Info:", $server_info);
printf("%-30s %s\n", "Client Info:", $client_info);

printf("\n");

$charset = cubrid_get_charset($conn);

printf("%-30s %s\n", "CUBRID Charset:", $charset);

cubrid_disconnect($conn);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

CUBRID PHP Version:            9.1.0.0001

PARAM_ISOLATION_LEVEL          3
LOCK_TIMEOUT                   -1
MAX_STRING_LENGTH              1073741823
PARAM_AUTO_COMMIT              1

Server Info:                   9.1.0.0212
Client Info:                   9.1.0

CUBRID Charset:                iso8859-1

Siehe auch