« pg\_connect\_pollpg\_connection\_busy »PHP ManualФункції PostgreSQL

pg_connect

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_connect — Відкриває з'єднання з базою даних PostgreSQL

Опис

pg_connect(string $connection_string, int $flags = 0): PgSql\Connection|false

pg_connect() відкриває з'єднання з базою даних PostgreSQL, визначене рядком connection_string

При повторному виклику функції pg_connect() з тими ж значеннями параметрів connection_string функція поверне існуюче підключення. Щоб примусово створити нове з'єднання, необхідно надіслати рядок підключення функції PGSQL_CONNECT_FORCE_NEW як параметр flags

Прежний синтаксис с множеством параметров**$conn = pg_connect("host", "port", "options", "tty", "dbname")**считается устаревшим.

Список параметрів

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()

Значення, що повертаються

Повертає екземпляр PgSql\Connection у разі успішного виконання або **false**в случае возникновения ошибки.

список змін

ВерсияОпис
8.1.0Повертає екземпляр PgSql\Connection; раніше повертався ресурс (resource

Приклади

Приклад #1 Использование функцииpg_connect()****

Loading...

Дивіться також

  • pg_pconnect() - Відкриває постійне з'єднання із сервером PostgreSQL
  • pg_close() - Закриває з'єднання з базою даних PostgreSQL
  • pg_host() - Повертає ім'я хоста, що відповідає підключенню
  • pg_port() - Повертає номер порту, який відповідає заданому з'єднанню
  • pg_tty() - Повертає ім'я терміналу TTY, пов'язане зі з'єднанням
  • pg_options() - Отримання параметрів з'єднання із сервером баз даних
  • pg_dbname() - Визначає ім'я бази даних