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

<?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 -