array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.odbc-prepare.php', 1 => 'odbc_prepare', 2 => 'Prépare une commande pour l\'exécution', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'Fonctions 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' => 'fr', '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 — Prépare une commande pour l'exécution

Description

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

Prépare une commande pour l'exécution. L’objet de résultat ODBC peut être utilisé plus tard pour exécuter la commande avec odbc_execute().

Quelques bases de données (comme IBM DB2, MS SQL Server et Oracle) supportent les procédures stockées qui acceptent les types de paramètres IN, INOUT et OUT comme définis dans les spécifications ODBC. Cependant, le driver unifié ODBC supporte actuellement uniquement le type de paramètres IN pour les procédures stockées.

Liste de paramètres

odbc

L'objet de connexion ODBC, voir la documentation de la fonction odbc_connect() pour plus de détails.

query

La requête à préparer.

Valeurs de retour

Renvoie un objet de résultat ODBC si la commande SQL a été préparée avec succès. Retourne false si une erreur survient.

Historique

Version Description
8.4.0 odbc attend désormais une instance de Odbc\Connection; auparavant, un resource était attendu.
8.4.0 Cette fonction retourne désormais une instance de Odbc\Result; auparavant, un resource était retourné.

Exemples

Exemple #1 Exemple avec odbc_prepare() et odbc_execute()

Dans le code suivant, $res ne sera valide uniquement si les trois paramètres pour myproc sont des paramètres IN :

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

S'il faut appeler une procédure stockée utilisant des paramètres INOUT ou OUT, il est recommandé d'utiliser l'extension native de la base de données (par exemple oci8 pour Oracle).

Voir aussi