Доступные версии документации

DB-основной класс

Установить соединение с базой данных

Назначение
 

Функция DB::connect устанавливает соединение между РНР-модулем и СУБД ЛИНТЕР на узле с заданным именем пользователя и паролем.

Синтаксические правила
mixed connect   (string $dsn [, array $options]);
$dsn

Строка, содержащая параметры соединения.

Формат строки:

linter://<пользователь>:<пароль>@[сервер].
Пользователь

Имя пользователя БД. Символьная строка длиной не более 66 символов.

Пароль

Пароль пользователя. Символьная строка длиной не более 18 символов.

Сервер

Имя ЛИНТЕР-сервера, с которым необходимо установить соединение. Символьная строка длиной не более 8 символов.

$options

Опции соединения (в СУБД ЛИНТЕР не используются).

Возвращаемое значение

Результат соединения с БД:

  • mixed – созданный DB-объект соединения (нормальное завершение);

  • DB_Error-объект – при ошибке соединения.

Примеры
$dbh =&DB::connect("linter://SYSTEM:MANAGER@", $options);
$dbh =&DB::connect("linter://SYSTEM:MANAGER@HOST1", $options);
<?php
require_once("DB.php");
$dsn = 'linter://SYSTEM:MANAGER@';
$db = DB::Connect($dsn);
if (DB::isError($db))
{
  echo $dbh->getUserInfo(); // содержит код ошибки СУБД ЛИНТЕР и ее описание
  echo $dbh->getMessage();  // стандартное описание PEAR ошибки
  die;
}
...
?>

Проверить на ошибку

Назначение
 

Функция DB::isError проверяет код завершения на принадлежность его к группе ошибок.

Синтаксические правила
boolean isError (mixed $value);
$value

Проверяемый код завершения.

Возвращаемое значение

Результат проверки:

  • true – код завершения соответствует ошибке (DB_Error-объект);

  • false – в противном случае.

Пример

Получение сообщений об ошибках из Pear Error объектов.

<?php
...
$res = $db->query('selct * from auto');
if (DB::isError($res)) {
   // Получение краткого сообщения об ошибке
   echo $res->getMessage();
}
?>
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter