Приглашаем посетить
Есенин (sergeiesenin.lit-info.ru)

Руководство по РНР 3.0 - Функции Oracle

Функции Oracle

Содержание
Ora_Bind
Ora_Close
Ora_ColumnName
Ora_ColumnType
Ora_Commit
Ora_CommitOff
Ora_CommitOn
Ora_Error
Ora_ErrorCode
Ora_Exec
Ora_Fetch
Ora_GetColumn
Ora_Logoff
Ora_Logon
Ora_Open
Ora_Parse
Ora_Rollback

Ora_Bind

Ora_Bind -- связывает переменной PHP с параметром Oracle
Описание

int ora_bind (int cursor, string PHP variable name, string SQL parameter name, int length, int [ type ]);

Возвращает true если связывание прошло успешно, в обратном случае - false. Делали об ошибке могут быть получены использую функции ora_error() и ora_errorcode() .

Эта функция связывает именованную переменную PHP с параметром SQL. Параметр SQL должен быть в виде ":имя". С дополнительным параметром типа вы можете определить SQL параметр как входной/выходной (0, по умолчанию), как входной (1) или как выходной (2). В PHP версии 3.0.1 вы можете использовать константы ORA_BIND_INOUT, ORA_BIND_IN and ORA_BIND_OUT вместо чисел.

Функция ora_bind должна вызывать после ora_parse() и до ora_exec() . Входные значения могут быть заданы присваиванием связанным переменным PHP, после вызова ora_exec() связанные переменные PHP содержат выходные значения, если они доступны.

<?php
ora_parse($curs, "declare tmp INTEGER; begin tmp := :in; :out := tmp; :x := 7.77; end;");
ora_bind($curs, "result", ":x", $len, 2);
ora_bind($curs, "input", ":in", 5, 1);
ora_bind($curs, "output", ":out", 5, 2);
$input = 765;
ora_exec($curs);
echo "Result: $result<BR>Out: $output<BR>In: $input";
?>


Ora_Close

Ora_Close -- закрывает курсор Oracle
Описание

int ora_close (int cursor);

Взвращает true, если закрытие завершилось успешно, иначе false. Детали об ошибке могут быть получены используя функции ora_error() и ora_errorcode() .

Эти функции закрывают курсор данных, открытый функцией ora_open() .


Ora_ColumnName

Ora_ColumnName -- возвращает имя результирующего столбца Oracle
Описание

string Ora_ColumnName (int cursor, int column);

Возвращает имя поля/столбца column под курсором cursor . Все буквы возвращенного имени возвращаются в верхнем регистре.


Ora_ColumnType

Ora_ColumnType -- возвращает тип результирующего столбца Oracle
Описание

string Ora_ColumnType (int cursor, int column);

Возвращает имя типа данных Oracle для поля/столбца column под курсором cursor . Возвращаемый тип будет один из следующих:

"VARCHAR2"
"VARCHAR"
"CHAR"
"NUMBER"
"LONG"
"LONG RAW"
"ROWID"
"DATE"
"CURSOR"


Ora_Commit

Ora_Commit -- фиксирует транзакцию Oracle
Описание

int ora_commit (int conn);

Возвращает true при успехе, false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() Эти функция фиксирует транзакцию Oracle. Транзакция определяется как все изменения на данном содинении с момента последней фиксации/отката, автофиксирование отключается при установке соединения.


Ora_CommitOff

Ora_CommitOff -- отключает атоматическое фиксирование
Описание

int ora_commitoff (int conn);

Возвращает true при успехе, false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() .

Эти функция отключает автоматичиское фиксирование после каждого вызова ora_exec() .


Ora_CommitOn

Ora_CommitOn -- включает автоматическое фиксирование
Описание

int ora_commiton (int conn);

Эта функция включает автоматическое фиксирование после каждого вызова ora_exec() на данном соединении.

Возвращает true при успехе, false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() .


Ora_Error

Ora_Error -- возвращает сообщение об ошибке Oracle
Описание

string Ora_Error (int cursor);

Возвращает сообщение об ошибке в виде XXX - NNNNN где XXX - место, где произошла ошибка, и NNNNN определяет сообщение об ошибке.

Параметр cursor может в версии PHP 3.0.6 быть идентификатором соединения.

В UNIX версии Oracle вы можете получить детали об ошибке, например, как эти: $ oerr ora 00001 00001, 00000, "unique constraint (%s.%s) violated" // *Причина: Попытка обновления или вставки уже существующего ключа. // Для trusted-конфигурации ORACLE в режиме DBMS MAC вы можете увидеть это // сообщение, если дубликат ключа есть на другом уровне // *Действие: Или удалите уникальное обновление или не вставляйте ключ


Ora_ErrorCode

Ora_ErrorCode -- возвращает код ошибки Oracle
Описание

int Ora_ErrorCode (int cursor);

Возвращает числовой код последней запущенной команды на указанном курсоре.

Параметр cursor может в версии PHP 3.0.6 быть идентификатором соединения.


Ora_Exec

Ora_Exec -- запускает синтаксически разобранную команду на курсоре Oracle
Описание

int ora_exec (int cursor);

Возвращает true при успехе, false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() .


Ora_Fetch

Ora_Fetch -- возвращает строку данных из курсора
Описание

int ora_fetch (int cursor);

Возвращает true (строка была получена) или false (нет больше строк или произошла ошибка). Если ошибка произошла, то детали могут быть получены с помошью функций ora_error() и ora_errorcode() . Если ошибок не было, то ora_errorcode() вернет 0. Функция возвращает строку данных из указанного курсора.


Ora_GetColumn

Ora_GetColumn -- возвращает даные из полученной строки
Описание

mixed ora_getcolumn (int cursor, mixed column);

Возвращает поле данных. Если произошла ошибка, то будет возвращено False и ora_errorcode() вернет ненулевое значение. Отметим, однако, что при проверке на ошибку на результатах из этой функции можно получить true в случае, если там ошибки не было (результат NULL, пустая строка, число 0, строка "0").


Ora_Logoff

Ora_Logoff -- закрывает соединение Oracle
Описание

int ora_logoff (int connection);

Возвращает true при успехе, false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() . Отключает пользователей и осоединяется от сервера.


Ora_Logon

Ora_Logon -- открывает соединение Oracle
Описание

int ora_logon (string user, string password);

Устанавливает соединение между PHP и базай данных Oracle с указанными именем пользователя и паролем.

Соединение могут быть установлены с помощью SQL*Net заменяя имя TNS на пользователя как здесь:

$conn = Ora_Logon("user
@TNSNAME
", "pass");

Если у вас символьные данные вместе с не ASCII символами, вам следует убедится, что NLS_LANG установлена в вашем окружении. Для серверных модулей вам следует установить его в серверном окружении до запуска сервера.

Возвращает идентификатор соединение при успехе, или false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() .


Ora_Open

Ora_Open -- открывает курсор Oracle
Описание

int ora_open (int connection);

Открывает курсор Oracle, связанный с соединением.

Возвращает идентификатор курсора или False при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() .


Ora_Parse

Ora_Parse -- делает синтаксический разбор запроса SQL
Описание

int ora_parse (int cursor_ind, string sql_statement, int defer);

Эта функция разбирает запрос SQL или блок PL/SQL и связывает его с указанным курсором. Возвращает 0 при успехе или -1 при ошибке.


Ora_Rollback

Ora_Rollback -- откатывает транзакцию
Описание

int ora_rollback (int connection);

Эта функция отменяет транзакцию Oracle. (См. ora_commit() для определения транзакции).

Возвращает true при успехе, false при ошибке. Детали об ошибке могут быть получены с помощью функций ora_error() и ora_errorcode() .

Назад | Содержание | Вперед