cubrid_pconnect

(PECL CUBRID >= 8.3.1)

cubrid_pconnect — Открывает постоянное соединение с сервером CUBRID

Описание

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

Устанавливает постоянное соединение с сервером CUBRID.

cubrid_pconnect() действует очень похоже на cubrid_connect() с двумя основными отличиями:

Во-первых, при подключении функция сначала попытается найти (постоянную) ссылку, которая уже открыта с тем же хостом, портом, именем базы данных и идентификатором пользователя. Если соединение будет найдено, вместо открытия нового будет возвращён его идентификатор.

Во-вторых, соединение с SQL-сервером не будет закрыто по окончании выполнения скрипта. Вместо этого ссылка останется открытой для использования в будущем (cubrid_close() или cubrid_disconnect() не закроет ссылки, установленные cubrid_pconnect()).

Поэтому этот тип ссылки называется "постоянным".

Список параметров

host: Имя хоста или IP-адрес сервера CUBRID CAS.
port: Номер порта CUBRID CAS-сервера (BROKER_PORT настроенный в $CUBRID/conf/cubrid_broker.conf).
dbname: Имя базы данных.
userid: Имя пользователя базы данных.
passwd: Пароль пользователя.

Возвращаемые значения

Идентификатор соединения в случае успешного выполнения процесса или false в случае возникновения ошибки.

Примеры

Пример #1 Пример использования cubrid_connect()

<?php
printf("%-30s %s\n", "Версия PHP CUBRID:", cubrid_version());

printf("\n");

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

if (!$conn) {
    die('Ошибка соединения ('. 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);
printf("%-30s %s\n", "Информация о клиенте:", $client_info);

printf("\n");

$charset = cubrid_get_charset($conn);

printf("%-30s %s\n", "Кодировка CUBRID:", $charset);

cubrid_disconnect($conn);
?>

Результат выполнения приведённого примера:

Версия PHP CUBRID:             9.1.0.0001

PARAM_ISOLATION_LEVEL          3
LOCK_TIMEOUT                   -1
MAX_STRING_LENGTH              1073741823
PARAM_AUTO_COMMIT              1

Информация о сервере:             9.1.0.0212
Информация о клиенте:             9.1.0

Кодировка CUBRID:                iso8859-1

Смотрите также

cubrid_connect() - Открывает соединение к серверу CUBRID
cubrid_connect_with_url() - Создаёт окружение для соединения с сервером CUBRID
cubrid_pconnect_with_url() - Открывает постоянное соединение с сервером CUBRID
cubrid_disconnect() - Закрывает соединение с базой данных
cubrid_close() - Закрывает соединение с базой данных

add a note

User Contributed Notes

There are no user contributed notes for this page.