ibase_pconnect

(PHP 5, PHP 7)

ibase_pconnect - 打开到InterBase数据库的持久连接

描述

resource ibase_pconnect ([ string $database [, string $username [, string $password [, string $charset [, int $buffers [, int $dialect [, string $role [, int $sync ]]]]]]]] )

打开到InterBase数据库的持久连接。

ibase_pconnect（）与ibase_connect（）非常相似，主要区别在于两点。

首先，在连接时，函数将首先尝试找到已经用相同参数打开的（持久）链接。如果找到一个，那么它的标识符将被返回而不是打开一个新的连接。

其次，当脚本执行结束时，不会关闭到InterBase服务器的连接。相反，链接将保持打开以供将来使用（ibase_close（）不会关闭由ibase_pconnect（）建立的链接）。这种类型的链接因此被称为“持久性”。

参数

database

该database参数必须是在服务器上的数据库文件，它驻留在一个有效的路径。如果服务器不在本地，则根据所使用的连接协议，它必须以'主机名：'（TCP / IP），'//主机名/'（NetBEUI）或'主机名@'（IPX / SPX）作为前缀。

username

用户名。可以使用ibase.default_user php.ini指令进行设置。

password

密码为username。可以使用ibase.default_password php.ini指令进行设置。

charset

charset 是数据库的默认字符集。

buffers

buffers是分配给服务器端缓存的数据库缓冲区的数量。如果为0或省略，服务器将选择其自己的默认值。

dialect

dialect为连接中执行的任何语句选择默认的SQL方言，并默认为客户端库支持的最高语言。仅适用于InterBase 6及更高版本。

role

仅适用于InterBase 5及更高版本。

sync

返回值

成功时返回InterBase链接标识符或错误时返回FALSE。