odbc_prepare

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

odbc_prepare — Prepara um comando para execução

Descrição

odbc_prepare(resource $connection_id, string $query_string): resource

Prepara um comando para execução. O identificador de resultado pode ser usado posteriormente para executar o comando com odbc_execute().

Alguns bancos de dados (como IBM DB2, MS SQL Server, e Oracle) suportam stored procedures que aceitam parâmetros do tipo IN, INOUT, e OUT como definido pela especificação ODBC. Entretanto, o Unified ODBC driver atualmente suporta apenas parâmetros do tipo IN em stored procedures.

Parâmetros

connection_id: O identificador de conexão ODBC, veja odbc_connect() para detalhes.
query_string: The query string statement being prepared.

Valor Retornado

Returns an ODBC result identifier if the SQL command was prepared successfully. Returns false on error.

Exemplos

Exemplo #1 odbc_execute() and odbc_prepare() example

No seguinte código, $res será válido apenas se todos os três parâmetros em myproc forem parâmetros IN:


<?php
$a = 1;
$b = 2;
$c = 3;
$stmt    = odbc_prepare($conn, 'CALL myproc(?,?,?)');
$success = odbc_execute($stmt, array($a, $b, $c));
?>

Se você precisar usar um stored procedure usando parâmetros INOUT ou OUT, a alternativa é usar a extensão nativa para o seu banco de dados (por exemplo, oci8 para Oracle).

Veja Também

odbc_execute() - Executa um comando preparado

＋add a note

User Contributed Notes 3 notes

down

bslorence ¶

16 years ago


Is it just me or is the code above misleading? It makes it look like odbc_execute() returns a resource suitable, say, for passing to one of the odbc_fetch_* functions.

In fact, odbc_execute() returns a boolean, which simply indicates success (TRUE) or failure (FALSE). The variable to pass to odbc_fetch_* is the same one that you pass to odbc_execute():

<?php
$res = odbc_prepare($db_conn, $query_string);
if(!$res) die("could not prepare statement ".$query_string);

if(odbc_execute($res, $parameters)) {
    $row = odbc_fetch_array($res);
} else {
    // handle error
}
?>

down

lzsiga at freemail dot c3 dot hu ¶

3 years ago


The resource returned by odbc_prepare can be freed with odbc_free_result.

down

Marek ¶

18 years ago


Use this example for IBM DB/2:

$q = "update TABLE set PASS=? where NAME=?";
$res = odbc_prepare ($con, $q);

$a = "secret"; $b="user";
$exc = odbc_execute($res, array($a, $b));

＋add a note