« cubrid\_commitcubrid\_connect »PHP ManualФункції CUBRID

cubrid_connect_with_url

(PECL CUBRID >= 8.3.1)

cubrid_connect_with_url — Створює оточення для з'єднання із сервером CUBRID

Опис

cubrid_connect_with_url(    string $conn_url,    string $userid = ?,    string $passwd = ?,    bool $new_link = false): resource

Функцияcubrid_connect_with_url() використовується для створення оточення для з'єднання з сервером за допомогою інформації, заданої у вигляді рядка URL. Якщо в CUBRID дозволена функціональність високої доступності, необхідно встановити інформацію для з'єднання з резервним сервером, яка буде використовуватися для з'єднання, якщо з основним щось трапиться. Якщо логін та пароль не задані, то за умовчанням використовуватиметься з'єднання "PUBLIC".

::= 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_connect_with_url($url, "dba", "12?");

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

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

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

conn_url

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

userid

Ім'я користувача.

passwd

пароль.

new_link

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

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

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

Приклади

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

Loading...

Приклад #2 Приклад використання cubrid_connect_with_url()с заданием свойств

Loading...

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