pg_connect
Открывает соединение с базой данных PostgreSQL
&reftitle.description;
PgSql\Connectionfalsepg_connect
stringconnection_string
intflags0
pg_connect открывает соединение с базой данных
PostgreSQL, определённое строкой connection_string.
При повторном вызове функции pg_connect с теми же
значениями параметров в connection_string функция вернёт
существующее подключение. Чтобы принудительно создать новое соединение,
необходимо передать строку подключения функции PGSQL_CONNECT_FORCE_NEW в качестве
параметра flags.
Прежний синтаксис с множеством параметров
$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