array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.odbc-prepare.php', 1 => 'odbc_prepare', 2 => 'Bereitet eine Anweisung für die Ausführung vor', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'ODBC Funktionen', ), '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' => 'de', '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 — Bereitet eine Anweisung für die Ausführung vor

Beschreibung

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

Bereitet eine Anweisung für die Ausführung vor. Das Das ODBC-Ergebnis-Objekt kann später verwendet werden, um die Anweisung mit odbc_execute() auszuführen.

Einige Datenbanken (wie beispielsweise IBM DB2, MS SQL Server und Oracle) unterstützen gespeicherte Prozeduren, die Parameter vom Typ IN, INOUT und OUT akzeptieren können, wie von der ODBC-Spezifikation definiert. Allerdings unterstützt der Unified-ODBC-Treiber zurzeit nur Parameter vom Typ IN für gespeicherte Prozeduren.

Parameter-Liste

odbc

Das ODBC-Verbindungs-Objekt, siehe odbc_connect() für Details.

query

Die Abfrage-Anweisung, die vorbereitet werden soll, als Zeichenkette.

Rückgabewerte

Gibt ein ODBC-Ergebnis-Objekt zurück, wenn das SQL-Kommando erfolgreich vorbereitet wurde. Im Fehlerfall wird false zurückgegeben.

Changelog

Version Beschreibung
8.4.0 odbc erwartet nun eine Instanz von Odbc\Connection; vorher wurde eine Ressource erwartet.
8.4.0 Diese Funktion gibt nun eine Instanz von Odbc\Result zurück; vorher wurde eine Ressource zurückgegeben.

Beispiele

Beispiel #1 Beispiel für odbc_execute() und odbc_prepare()

Im folgenden Code ist $success nur dann true, wenn alle drei Parameter für myproc Eingabeparameter (IN) sind:

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

Wenn eine gespeicherte Prozedur aufgerufen werden soll, die Ein-Ausgabe- (INOUT) oder Ausgabeparameter (OUT) verwendet, wird als Workaround empfohlen, eine native Erweiterung für die jeweilige Datenbank zu verwenden (beispielsweise oci8 für Oracle).

Siehe auch