« pg\_parameter\_statuspg\_ping »PHP ManualФункції PostgreSQL

pg_pconnect

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

pg_pconnect — Відкриває постійне з'єднання з сервером PostgreSQL

Опис

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

pg_pconnect() встановлює з'єднання з базою даних PostgreSQL. Повертає екземпляр PgSql\Connection, необхідний роботи більшості функцій PostgreSQL.

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

Можливість створення постійних підключень регулюється директивою 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.

flags

Если в функцию передана константа**PGSQL_CONNECT_FORCE_NEW**, буде створюватися нове підключення, навіть якщо connection_string ідентична рядку існуючого підключення.

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

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

список змін

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

Приклади

Приклад #1 Приклад використання pg_pconnect()****

Loading...

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