pg_connect
Открывает соединение с базой данных PostgreSQL
&reftitle.description;
PgSql\Connectionfalsepg_connect
stringconnection_string
intflags0
Функция pg_connect открывает соединение с базой данных
PostgreSQL на основе параметров, которые указали в строке connection_string.
При повторном вызове функции pg_connect с теми же параметрами
в строке connection_string функция вернёт подключение,
которое уже установили, если только в параметр flags
не передали флаг PGSQL_CONNECT_FORCE_NEW.
Прежний синтаксис с набором параметров —
$conn = pg_connect("host", "port", "options", "tty", "dbname") —
устарел.
&reftitle.parameters;
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.
Параметр options устанавливает параметры командной строки, которые
вызовет сервер.
flags
При передаче флага PGSQL_CONNECT_FORCE_NEW функция создаёт новое соединение,
даже если строка подключения connection_string идентична
строке подключения, которое уже установили.
При передаче флага PGSQL_CONNECT_ASYNC функция устанавливает
асинхронное соединение. Состояние соединения
проверяют функцией pg_connect_poll
или pg_connection_status.
&reftitle.returnvalues;
Функция возвращает экземпляр класса PgSql\Connection,
если выполнилась успешно,&return.falseforfailure;.
&reftitle.changelog;
&Version;
&Description;
8.1.0
Функция теперь возвращает экземпляр класса PgSql\Connection;
раньше возвращался ресурс (&resource;).
&reftitle.examples;
Пример установки соединения функцией pg_connect
]]>
&reftitle.seealso;
pg_pconnect
pg_close
pg_host
pg_port
pg_tty
pg_options
pg_dbname