PHP Conference Nagoya 2025

odbc_prepare

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

odbc_preparePrepara uma isntrução para execução

Descrição

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

Prepara uma instrução para execução. O objeto de resultado ODBC 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 objeto 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 objeto de resultado ODBC se a instrução SQL foi preparada com sucesso. Retorna false em caso de erro.

Registro de Alterações

Versão Descrição
8.4.0 odbc agora espera uma instância de Odbc\Connection; anteriormente, esperava um resource.
8.4.0 Esta função agora retorna uma instância de Odbc\Result; anteriormente, retornava um resource.

Exemplos

Exemplo #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

adicione uma nota

Notas Enviadas por Usuários (em inglês) 4 notes

up
13
bslorence
17 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
}
?>
up
1
lzsiga at freemail dot c3 dot hu
5 years ago
The resource returned by odbc_prepare can be freed with odbc_free_result.
up
1
info dot codesquare at gmail dot com
9 months ago
after 2 days finaly got a working code
(SQL SERVER stored procedure with parameters through ODBC)

STORED PROCEDURE

SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO

ALTER PROCEDURE [dbo].[sp_prev_frm_prev2]
@id int,
@cli nchar(20)
AS
BEGIN
SET NOCOUNT ON;
--SELECT 1
END

PHP

$stmt=odbc_prepare($conn,'{call db.dbo.sp_prev_frm_prev2(?,?)}');

$params=array(1,"clie");

$result = odbc_execute($stmt, $params);
up
1
Marek
19 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));
To Top