Соединение с сервером HyTech, функция hytech_pconnect

Функция hytech_pconnect предназначена для постоянного подключения к серверу. Постоянное подключение устанавливается в момент первого вызова hytech_pconnect. При последующих вызовах hytech_pconnect (не зависимо от того, когда оно произойдет, при обработке текущего запроса от клиента или при последующих запросах) будет использовано именно это соединение. Использование hytech_pconnect позволяет сэкономить на времени соединения с сервером HyTech. При большом количестве клиентских запросов это время, в случае, если соединение выполняется каждый раз при обработке запроса, может сильно повлиять на производительность системы.

Формат вызова:

ConnId = hytech_pconnect ( host, user_name, password, charset );

Параметры функции hytech_pconnect, возвращаемое значение, возможные комбинации параметров и т.п. полностью аналогичны hytech_connect.

Отключение от сервера HyTech

Функция hytech_close предназначена для отключения от сервера HyTech.

Поведение hytech_close отличается в зависимости от того, в паре с какой функцией она используется, hytech_connect или hytech_pconnect. Если hytech_close используется в паре с hytech_connect, то закрываются все открытые результаты и выполняется отключение от сервера. Если hytech_close используется в паре с hytech_pconnect, то только закрываются все открытые результаты (отключения от сервера не происходит).

Формат вызова:

hytech_close( ConnId );

Аргументы:

Аргумент	Тип	Значение
ConnId	Resource	Идентификатор соединения, возвращенный функцией hytech_connect или hytech_pconnect.

Результат: не специфицирован.

Пример c использованием функции hytech_connect:

<?php // всякий раз соединяемся с сервером заново $h = hytech_connect( "tcpip:/localhost:13000", "HTADMIN", "PASSWORD" ); if( hytech_errno() != 0 ) {   echo "Соединение неудачно";   return ; } else {   echo "Успешно соединились с сервером"; } // закрываем все открытые результаты, // закрываем соединение с сервером hytech_close( $h ); ?>

Пример c использованием функции hytech_pconnect:

<?php // соединяемся с сервером только один раз, при последующих вызовах // используем уже установленное соединение $h = hytech_pconnect( "tcpip:/localhost:13000", "HTADMIN", "PASSWORD" ); if( hytech_errno() != 0 ) {   echo "Соединение неудачно";   return ; } else {   echo "Успешно соеденились с сервером"; } // закрываем все открытые результаты, // закрываем соединение с сервером hytech_close( $h ); ?>

Функция для смены кодировки символов

Упомянем также функцию для смены кодировки символов в процессе работы. Если текущая кодировка символов не соответствует кодировке БД, то она может быть изменена при помощи функции hytech_set_charset. Кодировка будет действовать до закрытия соединения.

Формат вызова:

hytech_set_charset( ConnId, charset );

Аргументы:

Аргумент	Тип	Значение
ConnId	Resource	Идентификатор соединения, возвращенный функцией hytech_connect или hytech_pconnect.
charset	Integer	Задает кодировку, в которой следует получать результаты запросов. Возможные значения: HYTECH_CHAR_WIN – результаты в кодировке Windows; HYTECH_CHAR_DOS – результаты в кодировке Dos.