array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.odbc-prepare.php', 1 => 'odbc_prepare', 2 => 'Подготавливает запрос к выполнению', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'Функции ODBC', ), 'prev' => array ( 0 => 'function.odbc-pconnect.php', 1 => 'odbc_pconnect', ), 'next' => array ( 0 => 'function.odbc-primarykeys.php', 1 => 'odbc_primarykeys', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/uodbc/functions/odbc-prepare.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

odbc_prepare

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_prepare — Подготавливает запрос к выполнению

Описание

odbc_prepare(Odbc\Connection $odbc, string $query): Odbc\Result|false

Функция подготавливает запрос к выполнению. Объект ODBC с результатом затем передают в функцию odbc_execute() для выполнения запроса.

Отдельные базы данных наподобие IBM DB2, MS SQL Server и Oracle поддерживают хранимые процедуры, которые принимают in-, inout- и out-параметры, как определяет спецификация протокола ODBC. Однако драйвер Unified ODBC пока поддерживает для хранимых процедур только in-параметры.

Список параметров

odbc

Объект ODBC-соединения. Подробнее о коннекторе рассказывает описание функции odbc_connect().

query

Подготавливаемый запрос в виде строки.

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

Функция возвращает объект ODBC с результатом, если подготовка SQL-команды выполнилась успешно. Функция возвращает значение false, если возникла ошибка.

Список изменений

Версия Описание
8.4.0 Параметр odbc теперь принимает объект соединения Odbc\Connection; раньше принимался тип resource.
8.4.0 Функция теперь возвращает объект с результатом ODBC-запроса Odbc\Result; раньше возвращалось значение с типом resource.

Примеры

Пример #1 Пример подготовки запроса к выполнению функциями odbc_execute() и odbc_prepare()

В следующем примере переменной $success присвоится значение true, только если каждый из трёх параметров в списке параметров для выполнения хранимой процедуры myproc относится ко входному in-параметру, — передаётся в процедуру по значению:

<?php

$a = 1;
$b = 2;
$c = 3;

$stmt = odbc_prepare($conn, 'CALL myproc(?, ?, ?)');
$success = odbc_execute($stmt, array($a, $b, $c));

?>

Для вызова хранимой процедуры с inout-параметром, который передаётся по ссылке, или с out-параметром, который возвращается из процедуры по значению, лучше отправить запрос через родной модуль базы данных наподобие модуля oci8 для СУБД Oracle.

Смотрите также