Руководство по РНР 3.0 - Функции Oracle
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 содержат выходные значения, если они доступны.
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
на
пользователя
как здесь:
Если у вас символьные данные вместе с не 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()
.
Содержание