odbc_prepare

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

odbc_prepare — Prepara uma isntrução para execução

Descrição

odbc_prepare(resource $odbc, string $query): resource|false

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

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

Parâmetros

odbc

O identificador da conexão ODBC. Consulte odbc_connect() para obter detalhes.

query

A instrução da string de consulta que está sendo preparada.

Valor Retornado

Retorna um identificador de resultado ODBC se a instrução SQL foi preparada com sucesso. Retorna false em caso de erro.

Exemplos

Example #1 Exemplos de odbc_execute() e odbc_prepare()

No código a seguir, $success será true 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 for necessário usar uma instrução preparada usando parâmetros INOUT ou OUT, a alternativa é usar a extensão nativa para o banco de dados (por exemplo, oci8 para Oracle).

Veja Também