cubrid_pconnect_with_url

(PECL CUBRID >= 8.3.1)

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

Опис

cubrid_pconnect_with_url(string $conn_url, string $userid = ?, string $passwd = ?): resource

Встановлює постійне з'єднання із сервером CUBRID.

cubrid_pconnect_with_url() діє дуже схоже на cubrid_connect_with_url() з двома основними відмінностями:

По-перше, при підключенні функція спочатку спробує знайти (постійне) посилання, яке вже відкрито з тим самим хостом, портом, ім'ям бази даних та ідентифікатором користувача. Якщо з'єднання буде знайдено, замість відкриття нового буде повернуто його ідентифікатор.

По-друге, з'єднання з SQL-сервером не буде закрито після закінчення скрипту. Натомість посилання залишиться відкритим для використання в майбутньому (cubrid_close() або cubrid_disconnect() не закриє посилання, встановлені cubrid_pconnect_with_url()

Тому цей тип посилання називається "постійним".

::= CUBRID::<db_name>:<db_user>:<db_password>:[? ]

[&]

::= alhosts=<alternative_hosts>[ &rctime=]

::= login_timeout=<milli_sec>

::= query_timeout=<milli_sec>

::= disconnect_on_query_timeout=true|false

<alternative_hosts> ::= <standby_broker1_host>: [,<standby_broker2_host>:]

:= HOSTNAME | IP_ADDR

:= SECOND

<milli_sec> := MILLI SECOND

host : Ім'я хоста або IP-адреса основної бази даних
db_name : Ім'я бази даних
db_user : Ім'я користувача бази даних
db_password : Пароль користувача бази даних
alhosts : Задає інформацію про брокера резервного сервера, який буде використовуватися у разі недоступності основного. Якщо ви задасте кілька резервних брокерів, спроби з'єднання будуть відбуватися в тому ж порядку, як вони описані в URL.
rctime : Інтервал між спробами підключення до активного брокера, у якому відбувся збій. Після виникнення помилки система з'єднається з резервним брокером, вказаним в althosts (failover), відкотить незавершені транзакції, і потім спробує з'єднатися з активним брокером основного вузла через кожні rctime. Значення за промовчанням 600 секунд.
login_timeout : Максимальний час (мілісекунди) очікування на авторизацію. За умовчанням 0, що означає нескінченний час очікування.
query_timeout : Максимальний час (мілісекунди) очікування на виконання запиту. Після вичерпання цього часу на сервер буде надіслано повідомлення про припинення запиту. Повернене значення запиту залежатиме від налаштування disconnect_on_query_timeout; навіть якщо буде надіслано повідомлення про припинення запиту, він може завершитися вдало.
disconnect_on_query_timeout : Визначає, чи повертається помилка відразу після перевищення часу очікування запиту. За замовчуванням**false**

Зауваження :

Символи ? и : є спеціальними в URL-з'єднання і не можуть бути використані в паролі. Приклад некоректного пароля, який не можна використовувати в рядку з'єднання, тому що в ньому використовуються символи "?:".

$url = "CUBRID:localhost:33000:tdb:dba:12?:?login_timeout=100";

Пароли, содержащие? или : можуть бути надіслані окремо.

$url = "CUBRID:localhost:33000:tbd:::?login_timeout=100";

$conn = cubrid_pconnect_with_url ($url, "dba", "12?");

Якщо логін або пароль порожні, необхідно зберігати символи " : ":

$url = "CUBRID:localhost:33000:demodb:::";

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

conn_url

Рядок, що містить інформацію для з'єднання.

userid

Ім'я користувача бази даних.

passwd

Пароль користувача.

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

Ідентифікатор з'єднання у разі успішного виконання або **false**в случае возникновения ошибки.

Приклади

Приклад #1 Приклад використання cubrid_pconnect_with_url()** без завдання властивостей**

Loading...

Приклад #2cubrid_pconnect_with_url()url with properties example

Loading...

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

cubrid_connect() - Відкриває з'єднання з сервером CUBRID
cubrid_connect_with_url() - Створює оточення для з'єднання із сервером CUBRID
cubrid_pconnect() - Відкриває постійне з'єднання із сервером CUBRID
cubrid_disconnect() - Закриває з'єднання з базою даних
cubrid_close() - Закриває з'єднання з базою даних