函数名: pg_connect()
适用版本: PHP 4 >= 4.0.6, PHP 5, PHP 7
用法: pg_connect() 函数用于打开与 PostgreSQL 数据库服务器的连接。
语法: resource pg_connect ( string $connection_string [, int $connect_type ] )
参数:
connection_string: 必需,定义了连接的参数,包括主机、端口、数据库名、用户名和密码等信息。连接字符串的格式如下: "host=hostname port=port dbname=database user=username password=password"
connect_type: 可选,连接类型。默认为 0,表示普通连接。如果设置为 PGSQL_CONNECT_FORCE_NEW,则会创建一个新的连接,而不是共享一个现有的连接。
返回值:成功时返回一个 PostgreSQL 连接资源,失败时返回 FALSE。
示例:
- 连接到本地 PostgreSQL 数据库:
$conn = pg_connect("host=localhost port=5432 dbname=mydb user=myuser password=mypassword");
if (!$conn) {
echo "连接到数据库失败!";
exit;
}
// 连接成功后可以执行其他操作...
- 连接到远程 PostgreSQL 数据库:
$conn = pg_connect("host=remotehost port=5432 dbname=mydb user=myuser password=mypassword");
if (!$conn) {
echo "连接到数据库失败!";
exit;
}
// 连接成功后可以执行其他操作...
注意:
- pg_connect() 函数返回的是一个 PostgreSQL 连接资源,可以用于执行其他 PostgreSQL 相关的操作,如查询、插入、更新等。
- 当连接成功时,返回的连接资源应保存起来,以便后续使用。
- 在连接失败时,可以通过检查返回值是否为 FALSE 来判断连接是否成功。
- 连接字符串中的参数顺序可以任意调整,但参数名称必须正确。
- 连接字符串中的参数值如果包含空格或特殊字符,需要使用单引号或双引号括起来。
- 连接字符串中的参数名称和参数值之间使用等号 (=) 进行分隔。
- 可以通过设置 connect_type 参数为 PGSQL_CONNECT_FORCE_NEW 来创建一个新的连接,而不是共享一个现有的连接。