ibase_pconnect

(PHP 5, PHP 7 < 7.4.0)

ibase_pconnectОткрывает постоянное соединение с базой данных InterBase

Описание

ibase_pconnect(
    string$database = ?,
    string$username = ?,
    string$password = ?,
    string$charset = ?,
    int$buffers = ?,
    int$dialect = ?,
    string$role = ?,
    int$sync = ?
): resource

Открывает постоянное соединение с базой данных InterBase.

Принцип работы ibase_pconnect() очень похож на ibase_connect() с двумя основными отличиями.

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

Во-вторых, соединение с сервером InterBase не будет закрыто по окончании выполнения скрипта. Вместо этого ссылка останется открытой для использования в дальнейшем (ibase_close() не будет закрывать ссылки, установленные ibase_pconnect()). Поэтому этот тип ссылки называется "постоянным".

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

database

Аргумент database должен быть допустимым путём к файлу базы данных на сервере, на котором он находится. Если сервер не является локальным, он должен иметь префикс 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) или 'hostname@' (IPX/SPX), в зависимости от используемого протокола подключения.

username

Имя пользователя. Можно установить с помощью директивы php.iniibase.default_user.

password

Пароль для username. Можно установить с помощью директивы php.iniibase.default_password.

charset

charset - набор символов по умолчанию для базы данных.

buffers

buffers - количество буферов базы данных, выделяемых для кеша на стороне сервера. Если значение равно 0 или опущено, сервер выбирает собственное значение по умолчанию.

dialect

dialect выбирает диалект SQL по умолчанию для любого выражения, выполняемого в соединении, и по умолчанию выбирает самый высокий диалект, поддерживаемый клиентскими библиотеками. Работает только с InterBase 6 и выше.

role

Работает только с InterBase 5 и выше.

sync

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

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

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

  • ibase_close() - Закрывает соединение с базой данных InterBase
  • ibase_connect() - Открывает соединение с базой данных
To Top