|
LXX. Функции Oracle 8
Эти функции дают возможность доступа к БД Oracle8 и Oracle7.
Используется интерфейс Oracle8 Call-Interface (OCI8). Для использования
этого расширения вам понадобятся клиентские библиотеки Oracle8.
Это расширение более гибко, чем стандартное расширение Oracle. Оно
поддерживает связку глобальных и локальных переменных PHP с заглушками Oracle,
имеет полную поддержку LOB, FILE и ROWID и позволяет использовать
предоставленные пользователем определённые переменные.
Прежде чем использовать это расширение, убедитесь, что вы соответствующим
образом настроили ваши переменные окружения oracle для пользователя Oracle, а также для пользователя вашего web-демона.
Вот переменные, которые вам может понадобиться установить:
-
ORACLE_HOME
-
ORACLE_SID
-
LD_PRELOAD
-
LD_LIBRARY_PATH
-
NLS_LANG
-
ORA_NLS33
После настройки переменных окружения для пользователя вашего web-сервера не
забудьте также добавить пользователя web-сервера (nobody, www) в группу oracle.
Если ваш web-сервер не стартует или заваливается при старте:
убедитесь, что Apache связан с библиотекой pthread:
# ldd /www/apache/bin/httpd
libpthread.so.0 => /lib/libpthread.so.0 (0x4001c000)
libm.so.6 => /lib/libm.so.6 (0x4002f000)
libcrypt.so.1 => /lib/libcrypt.so.1 (0x4004c000)
libdl.so.2 => /lib/libdl.so.2 (0x4007a000)
libc.so.6 => /lib/libc.so.6 (0x4007e000)
/lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
|
Если libpthread нет в списке, нужно переустановить Apache:
# cd /usr/src/apache_1.3.xx
# make clean
# LIBS=-lpthread ./config.status
# make
# make install
|
Пример 1. Подсказки по OCI
<?php
// от [email protected]
// Используйте опцию: OCI_DEFAULT для выполнения команды задержки выполнения
OCIExecute($stmt, OCI_DEFAULT);
// для запроса использования данных (после извлечения):
$result = OCIResult($stmt, $n);
if (is_object ($result)) $result = $result->load();
// Для использования операторов INSERT или UPDATE:
$sql = "insert into table (field1, field2) values (field1 = 'value',
field2 = empty_clob()) returning field2 into :field2";
OCIParse($conn, $sql);
$clob = OCINewDescriptor($conn, OCI_D_LOB);
OCIBindByName ($stmt, ":field2", &$clob, -1, OCI_B_CLOB);
OCIExecute($stmt, OCI_DEFAULT);
$clob->save ("some text");
OCICommit($conn);
?>
|
|
Вы легко можете получить доступ к хранимым процедурам тем же способом, что
и из командной строки.
Пример 2. Использование хранимых процедур
<?php
// от [email protected]
$sth = OCIParse ( $dbh, "begin sp_newaddress( :address_id, '$firstname',
'$lastname', '$company', '$address1', '$address2', '$city', '$state',
'$postalcode', '$country', :error_code );end;" );
// Это вызывает хранимую процедуру sp_newaddress с :address_id в
// in/out-переменной и :error_code в out-переменной.
// Затем вы выполняете связывание:
OCIBindByName ( $sth, ":address_id", $addr_id, 10 );
OCIBindByName ( $sth, ":error_code", $errorcode, 10 );
OCIExecute ( $sth );
?>
|
|
-
Содержание
-
OCIBindByName - связывает PHP-переменную с заглушкой Oracle
-
OCICancel - отменяет чтение из курсора
-
OCICollAppend -
-
OCICollAssign -
-
OCICollAssignElem -
-
OCICollGetElem -
-
OCICollMax -
-
OCICollSize -
-
OCICollTrim -
-
OCIColumnIsNULL - тестирует, является ли результирующий столбец
NULL
-
OCIColumnName - возвращает имя столбца
-
OCIColumnPrecision -
-
OCIColumnScale -
-
OCIColumnSize - возвращает размер результирующего столбца
-
OCIColumnType - возвращает тип данных столбца
-
OCIColumnTypeRaw -
-
OCICommit - подтверждает внешние транзакции
-
OCIDefineByName - использует PHP-переменную для шага define в операторе SELECT
-
OCIError - возвращает последнюю ошибку из stmt|conn|global
-
OCIExecute - выполняет оператор
-
OCIFetch - извлекает следующий ряд в result-буфер
-
OCIFetchInto - извлекает следующий ряд в result-массив
-
OCIFetchStatement - извлекает все ряды результирующих данных в массив
-
OCIFreeCollection -
-
OCIFreeCursor - освобождает все ресурсы, ассоциированные с курсором
-
OCIFreeDesc - удаляет дескриптор большого объекта/large object
-
OCIFreeStatement - освобождает все ресурсы, ассоциированные с оператором
-
OCIInternalDebug - включает или отключает вывод внутренней отладки
-
OCILoadLob -
-
OCILogOff - отсоединяет от Oracle
-
OCILogon - устанавливает соединение с Oracle
-
OCINewCollection -
-
OCINewCursor - возвращает новый курсор (Statement-Handle/оператор-дескриптор)
-
OCINewDescriptor - инициализирует новый пустой дескриптор LOB или FILE
-
OCINLogon - устанавливает новое соединение с Oracle
-
OCINumCols - возвращает количество результирующих столбцов в операторе
-
OCIParse - разбирает запрос/query и возвращает оператор
-
OCIPLogon - соединяется с БД Oracle с использованием постоянного соединения
-
OCIResult - возвращает значение столбца для извлечённого ряда
-
OCIRollback - откатывает неразрешённые транзакции
-
OCIRowCount - получает количество задействованных рядов
-
OCISaveLob -
-
OCISaveLobFile -
-
OCIServerVersion - возвращает строку, содержащую информацию о версии сервера
-
OCISetPrefetch - устанавливает количество предварительно извлечённых рядов
-
OCIStatementType - возвращает тип OCI-оператора
-
OCIWriteLobToFile -
|
|