pg_pconnect - Открывает постоянное соединение с сервером PostgreSQL
Вернуться к: PostgreSQL
pg_pconnect
(PHP 4, PHP 5, PHP 7)
pg_pconnect — Открывает постоянное соединение с сервером PostgreSQL
Описание
$connection_string
[, int $connect_type
] )pg_pconnect() устанавливает соединение с базой данных PostgreSQL. Возвращает ресурс соединения необходимый для работы большинства функций PostgreSQL.
При повторном вызове функции pg_pconnect() с теми же
значениями параметров в connection_string функция вернет
существующее подключение. Чтобы принудительно создать новое соединение,
необходимо передать строку подключения функции PGSQL_CONNECT_FORCE_NEW в качестве
параметра connect_type.
Возможность создавать постоянные подключения регулируется директивой pgsql.allow_persistent файла php.ini. Для включения, установите значение в "On" (является значением по умолчанию). Максимальное количество постоянных соединений задается директивой pgsql.max_persistent файла php.ini (по умолчанию -1, не ограничено). Количество любых возможных подключений устанавливается директивой pgsql.max_links файла php.ini.
pg_close() не закрывает соединения, открытые функцией pg_pconnect().
Список параметров
-
connection_string -
Строка
connection_stringможет быть пустой строкой, или содержать несколько параметров разделенных пробелами. Каждый параметр указывается как keyword = value. Пробелы вокруг знака равно необязательны. Пустые строки в качестве значения или значения, содержащие пробелы отделяются одинарными кавычками, как например, keyword = 'a value'. Для задания одинарных кавычек и обратных слешей в качестве значений их необходимо экранировать обратным слешем, то есть \' и \\.Список основных ключевых слов:
host,hostaddr,port,dbname(значение по умолчанию для параметраuser),user,password,connect_timeout,options,tty(игнорируется),sslmode,requiressl(устарело в связи с использованием параметраsslmode), иservice. Какие из этих аргументов будут обработаны, зависит от версии PostgreSQL. -
connect_type -
Если в функцию передана константа
PGSQL_CONNECT_FORCE_NEW, будет создаваться новое подключение, даже еслиconnection_stringидентична строке существующего подключения.
Возвращаемые значения
Ресурс соединения с базой данных PostgreSQL либо FALSE, если подключиться не удалось.
Примеры
Пример #1 Пример использования pg_pconnect()
<?php
$dbconn = pg_pconnect("dbname=mary");
//подключиться к базе "mary"
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
// подключиться к базе "mary" на хосте "localhost", порт "5432"
$dbconn3 = pg_pconnect("host=sheep port=5432 dbname=mary user=lamb password=foo");
//подключиться к базе "mary" на хосте "sheep", используя имя пользователя и пароль
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_pconnect($conn_string);
//подключиться к базе "test" на хосте "sheep", используя имя пользователя и пароль
?>
Смотрите также
- pg_connect() - Открывает соединение с базой данных PostgreSQL
- Постоянные соединения с базой данных
Вернуться к: PostgreSQL