Join Up! 92475 members and counting!

Login To PHPBuilder User Name: Password: Register A New Site Account * NOTE: This is for logging into the main site only! To login to the forums, click here

PHP Manual All Mail Lists Entire Site

Linux Today Enterprise Linux Today Apache Today JustLinux.com Linux Planet PHPBuilder All Linux Devices Hiermenus DatabaseJournal Technology Jobs IT Developer Internet News Small Business Personal Technology International Search internet.com Advertise Corporate Info Newsletters Tech Jobs E-mail Offers Covalent Extends Apache 2.0 to Microsoft ASP.NET ShopWorX - Support for Windows PHP Security Advisory: Vulnerability in PHP versions 4.2.0 and 4.2.1 Network Risk Assessment Full-Featured, Java-Based Apache GUI Partners & Affiliates Transforming XML with XSL using Sablotron In Case You Missed It...The Week of August 29, 2005 XMLHttpRequest and AJAX for PHP programmers, Part 2 In Case You Missed It...The Week of November 7th, 2005 In Case You Missed It... The Week of May 2, 2005

Index: phpdoc/fr/functions/uodbc.xml diff -u phpdoc/fr/functions/uodbc.xml:1.1 phpdoc/fr/functions/uodbc.xml:1.2 --- phpdoc/fr/functions/uodbc.xml:1.1 Fri Jul 21 03:27:50 2000 +++ phpdoc/fr/functions/uodbc.xml Thu Nov 23 06:26:15 2000 @@ -1,857 +1,1610 @@ - - - ODBC - - - - odbc_autocommit - Mode auto-validation - - - - - int odbc_autocommit - int connection_id - int OnOff - - - Sans paramètre OnOff, cette fonction retourne le statut - d'auto-validation de la connexion connection_id. - TRUE si le mode est activé, FALSE si il ne l'est pas, ou si une erreur survient. - - - Si OnOff vaut TRUE, l'auto-validation est activée. Si - il est FALSE, l'auto-validation est desactivée. Retourne TRUE en cas de succès, - FALSE en cas d'échec. - - - Par défaut, l'auto-validation est activée. Désactiver l'auto-validation est - équivalent à démarrer une transaction. - - - Voir aussi - odbc_commit et odbc_rollback. - - - - - - - odbc_binmode - Gestion des colonnes de données binaires. - - - - - int odbc_binmode - int result_id - int mode - - - Types ODBC SQL affectés: BINARY, VARBINARY, LONGVARBINARY. - - - - ODBC_BINMODE_PASSTHRU: Mode Passthru - - - ODBC_BINMODE_RETURN: Retourne tel quel. - - - ODBC_BINMODE_CONVERT: Converti en char et retourne la valeur. - - - - Lorsqu'une donnée SQL est convertie en caractère C, les 8 bits du caractère source - sont représentés par deux caractères ASCII. Ces caractères sont des représentations - ASCII des nombres au format hexadécimal. Par exemple, le binaire 00000001 est - converti en "01" et le binaire 11111111 est converti en - "FF". -

- - - - - mode - longueur - résultat - - - - - ODBC_BINMODE_PASSTHRU - 0 - passthru - - - ODBC_BINMODE_RETURN - 0 - passthru - - - ODBC_BINMODE_CONVERT - 0 - passthru - - - ODBC_BINMODE_PASSTHRU - 0 - passthru - - - ODBC_BINMODE_PASSTHRU - >0 - passthru - - - ODBC_BINMODE_RETURN - >0 - Tel quel - - - ODBC_BINMODE_CONVERT - >0 - Caractère - - - - - - - Si odbc_fetch_into est utilisé, passthru signifie qu'une - chaîne vide sera retournée pour ces colonnes. - - - - Si result_id vaut 0, ces paramètres - seront appliqués aux nouveaux résultats. - - - - La valeur par défaut de 4096 est 4096 et les valeurs par - défaut de odbc_binmode est ODBC_BINMODE_RETURN. - La gestion des colonnes binaires est aussi modifié par - odbc_longreadlen. - - - - - - - - - odbc_close - Ferme une connexion ODBC. - - - - - void odbc_close - int connection_id - - - - odbc_close ferme la connexion avec une source de données, - représentée par l'identifiant de connexion. - - - Cette fonction échouera si il y a des transactions en cours sur cette connexion. - Dans ce cas, la connexion restera ouverte. - - - - - - - - odbc_close_all - Ferme toutes les connexions ODBC - - - - - void odbc_close_all - - - - - odbc_close_all ferme toutes les connexions ODBC à des - sources de données. - - - Cette fonction échouera si il y a des transactions en cours sur cette connexion. - Dans ce cas, la connexion restera ouverte. - - - - - - - - odbc_commit - Valide une transaction ODBC - - - - - int odbc_commit - int connection_id - - - Retourne: TRUE en case de succès, FALSE en cas d'erreur. Toutes les connexions en - cours sur connection_id sont validées. - - Toutes les connexions en cours sur connection_id sont - validées. - - - - - - - - odbc_connect - Connexion à une source - - - - - int odbc_connect - string dsn - string user - string password - int cursor_type - - - Retourne un identifiant de connexion ODBC ou 0 (FALSE) en cas d'erreur. - - - L'identifiant de connexion retournée par cette fonction est nécessaire pour - toutes les autres fonctions ODBC. Vous pouvez avoir de multiples connexions - en même temps. Le quatrième paramètre fixe le type de pointeur de résultat - utilisé pour cette connexion. Ce paramètre n'est généralement pas nécessaire, - mais il peut être utile pour contourner certains problèmes ODBC. - - - Avec certains pilotes ODBC, l'exécution de procédures enregistrées complexes - peut produire l'erreur suivante : "Cannot open a cursor on a stored procedure - that has anything other than a single select statement in it", ce qui signifie : - "Impossible de créer un pointeur de résultat dans une procédure enregistrée qui - est réduite à une simple selection (SELECT)). Utiliser l'option SQL_CUR_USE_ODBC - permet d'éviter cette erreur. De plus, certains pilotes ne supportent le paramètre - optionnel de numéro de ligne dans odbc_fetch_row. - SQL_CUR_USE_ODBC peut aussi permettre de résoudre ces problèmes. - - - Les constantes suivantes sont définies comme type de pointeur : - - - - - SQL_CUR_USE_IF_NEEDED - - - SQL_CUR_USE_ODBC - - - SQL_CUR_USE_DRIVER - - - SQL_CUR_DEFAULT - - - - Pour les connexions persistantes, reportez vous à - odbc_pconnect. - - - - - - - odbc_cursor - Lecture du pointeur de fiche courante (cursorname). - - - - - string odbc_cursor - int result_id - - - odbc_cursor lit le pointeur de fiche courante - (cursorname) pour le résultat result_id. - - - - - - - odbc_do - Synonyme de odbc_exec - - - - - string odbc_do - int conn_id - string query - - - odbc_do excécute la requête query - avec la connexion conn_id. - - - - - - - - odbc_exec - Prépare et exécute une requête SQL. - - - - - int odbc_exec - int connection_id - string query_string - - - Retourne FALSE en cas d'erreur. Retourne un identifiant de résultat ODBC en cas - d'exécution réussie. - - - odbc_exec envoie une commande SQL à la source de données - représentée par connection_id. Ce paramètre doit être un - identifiant valide de connexion, retourné par odbc_connect ou - odbc_pconnect. - - - Voir aussi : odbc_prepare et odbc_execute - pour les éxecutions multiples de requêtes SQL. - - - - - - - odbc_execute - Exécute une requête SQL préparée. - - - - - int odbc_execute - int result_id - array - parameters_array - - - Exécute une requête SQL préparée par odbc_prepare. - Retourne TRUE en cas d'exécution réussie, et FALSE sinon. Le tableau de paramètres - parameters_array ne sert que si vous avez besoin de - paramètres votre requête. - - - - - - - - odbc_fetch_into - Lit une ligne de résultat, et la place dans un tableau. - - - - - int odbc_fetch_into - int result_id - int rownumber - array result_array - - - Retourne le nombre de colonnes dans le résultat, ou FALSE en cas d'erreur. - result_array doit avoir été passé par référence, mais il - peut être de n'importe quel type, étant donné qu'il sera converti en tableau. - Le tableau contiendra les valeurs des colonnes, ces dernières étant numérotées à - partir de 0. - - - - - - - - odbc_fetch_row - Lit une ligne de résultat. - - - - - int odbc_fetch_row - int result_id - int row_number - - - Si odbc_fetch_row a réussi, TRUE est retourné. - Si il n'y avait plus de ligne, ou en cas d'erreur, FALSE est retourné. - - - - odbc_fetch_row lit une ligne dans le résultat identifié par - result_id et retourné par odbc_do ou - odbc_exec. - Après odbc_fetch_row, les champs seront accessibles avec la - fonction odbc_result. - - - - Si row_number est omis, - row_number va tenter de lire la prochaîne ligne dans le - résultat. Des appels répétés à odbc_fetch_row avec et sans - paramètre row_number peuvent être combinés librement. - - - - Pour passer en revue toutes les lignes d'un résultat plusieurs fois, - vous pouvez appeler odbc_fetch_row avec row_number = 1, - puis continue à appeler odbc_fetch_row sans le paramètre - row_number pour passer en revue tout le résultat. Si un - pilote ne supporte pas la lecture des lignes par numéro, le paramètre sera ignoré. - - - - - - - - odbc_field_name - Lit le nom de la colonne. - - - - - string odbc_field_name - int result_id - int field_number - - - odbc_field_name lit le nom de la colonne dont l'index est - field_number. La numérotation des champs commence à 1. - FALSE est retourné en cas d'erreur. - - - - - - - - - odbc_field_type - Type de données d'un champs. - - - - - string odbc_field_type - int result_id - int field_number - - - odbc_field_type retourne le type de données SQL d'un champs, - identifié par son index. La numérotation des champs commence à 1. - - - - - - - odbc_field_len - Lit la longueur d'un champs. - - - - - int odbc_field_len - int result_id - int field_number - - - odbc_field_len retourne la longueur du champs référence par - le nombre field_number, dans la connexion ODBC - result_id. Les numéros de champs commencent à 1. - - - - - - - - odbc_free_result - Libère les ressources associées à un résultat - - - - - int odbc_free_result - int result_id - - - Retourne toujours TRUE. - - odbc_free_result n'est nécessaire que si vous craignez - d'utiliser trop de mémoire lors de l'exécution de votre script. Tous les - résultats en mémoire seront libérés dès la fin du script. Mais, si vous êtes sûr - que vous n'aurez plus besoin d'un résultat jusqu'à la fin de votre script, vous - pouvez appeler odbc_free_result, et la mémoire associée à - result_id sera libérée. - - - - Si auto-validation est désactivée (voir odbc_autocommit) - et que vous appelez odbc_free_result avant de valider vos - requêtes, toutes les transactions préparées seront annulées. - - - - - - - - odbc_longreadlen - Gestion des colonnes de type LONG. - - - - - int odbc_longreadlen - int result_id - int length - - - Types ODBC SQL affectés: LONG, LONGVARBINARY. - - - Le nombre d'octets retournés à PHP est contrôlé par le paramètre - length. Si sa valeur est 0, les colonnes de type Long - seront transformées en chaîne vide. - - - La gestion des types LONGVARBINARY est aussi affectée par - odbc_binmode. - - - - - - - - - odbc_num_fields - Nombre de colonnes dans un résultat - - - - - int odbc_num_fields - int result_id - - - odbc_num_fields retourne le nombre de colonnes dans un - résultat ODBC. Cette fonction retournera -1 en cas d'erreur. L'argument est un - identifiant de résultat valide, retourné par odbc_exec. - - - - - - - odbc_pconnect - Ouvre une connexion persistante à une source de données. - - - - - int odbc_pconnect - string dsn - string user - string password - int cursor_type - - - Retourne un identifiant de connexion ODBC ou 0 (FALSE) en cas d'erreur. - Cette fonction se comporte de manière similaire à odbc_connect, - mais la connexion ouverte n'est pas vraiment terminée lorsque le script est - terminé. Les prochaînes requêtes qui se feront sur une connexion dont - les dsn, user, - password sont les mêmes que celle-ci (avec - odbc_connect et odbc_pconnect) - réutiliseront la connexion ouverte. - - - - Les connexions persistantes n'ont aucun effet si PHP est utilisé comme CGI. - - - Pour plus de détails sur le paramètre optionnel cursor_type, - voyez odbc_connect. Pour plus de détails sur les connexions - persistantes, reportez vous à la FAQ PHP. - - - - - - - odbc_prepare - Prépare une commande pour l'exécution - - - - - int odbc_prepare - int connection_id - string query_string - - - Prépare une commande pour l'exécution. - - Retourne un identifiant de résultat ODBC si la commande SQL a été préparée - avec succès. L'identifiant peut être utilisé plus tard pour exécuter la commande - avec odbc_execute. - - - - - - - odbc_num_rows - Nombre de ligne dans un résultat. - - - - - int odbc_num_rows - int result_id - - - odbc_num_rows retourne le nombre de lignes dans un résultat - ODBC. Cette fonction retournera -1 en cas d'erreur. Pour les commandes INSERT, - UPDATE et DELETE, odbc_num_rows retourne le nombre de ligne - affectées. Pour les commandes SELECT, ce PEUT le nombre de - lignes disponibles, mais ce n'est pas certains. - - - Note: odbc_num_rows après un SELECT retournera -1 - avec de nombreux pilotes. - - - - - - - odbc_result - Lit les données de résultat. - - - - - string odbc_result - int result_id - mixed field - - - Retourne le contenu d'un champs. - - - field peut être aussi bien un entier, contenant le numéro - de colonne du champs, dans le résultat, ou bien une chaîne de caractère, qui - représente le nom du champs. Par exemple: - - $item_3 = odbc_result($Query_ID, 3 ); - $item_val = odbc_result($Query_ID, "val"); - - - Le premier appel à odbc_result retourne la valeur du troisième - champs de la ligne courante, du résultat result_id. - Le deuxième appel à odbc_result retourne la valeur du - troisième champs dont le nom est "val" de la ligne courante, du résultat - result_id. Une erreur survient si le paramètre de colonne - est inférieur à 1, ou dépasse le nombre de colonnes du résultat. De la même - manière, une erreur survient si le nom du champs passé ne correspond à aucun - champs dans le résultat. - - - - Les index de champs commencent à 1. Pour plus d'informations sur la façon de lire - des colonnes de type binaire ou long, reportez vous à - odbc_binmode et odbc_longreadlen. - - - - - - - - odbc_result_all - Affiche le résultat sous la forme d'une table HTML. - - - - - int odbc_result_all - int result_id - string format - - - Retourne le nombre de lignes dans le résultat, ou FALSE en cas d'erreur. - - - - odbc_result_all affiche toutes les lignes d'un résultat. - L'affichage se fait au format HTML. Avec l'option format, - il est possible de modifier l'aspect global de la table. - - - - - - - - odbc_rollback - Annule une transaction - - - - - int odbc_rollback - int connection_id - - - Annule toutes les transactions sur la connexion - connection_id. Retourne TRUE en cas de succès, et - FALSE en cas d'echec. - - - - - - - odbc_setoption - - Modifie les paramètres ODBC. - - - - - - int odbc_setoption - int id - int function - int option - int param - - - Cette fonction donne accès aux options ODBC pour une connexion particulière - ou un résultat de requête. Elle a été écrite pour aider à la résolution de - problème liés aux pilotes ODBC récalcitrants. Vous aurez sûrement à utiliser - cette fonction si vous êtes un programmeur ODBC et que vous comprenez les divers - effets des options disponibles. Vous aurez aussi besoin d'un bon manuel de - référence pour comprendre les options et leur usage. Différentes versions de - pilotes supportent différentes versions d'options. - - - Etant donné que les effets peuvent varier d'un pilote à l'autre, l'utilisation de - cette fonction dans des scripts voués à être livrés au public est très fortement - déconseillée. De plus, certaines options ODBC ne sont pas disponibles car elles - doivent être fixées avant l'établissement de la connexion. Cependant, si dans - un cas bien spécifique, cette fonction vous permet d'utiliser PHP sans que votre - patron vous pousse à utiliser un produit commecial, alors cela n'a pas - d'importance. - - - Id est un identifiant de connexion, ou un identifiant de - résultat, pour lequel vous souhaitez modifier des options. - Pour SQLSetConnectOption(), c'est un identifiant de connexion. - Pour SQLSetStmtOption(), c'est un identifiant de résultat. - - - function est la fonction ODBC à utiliser. La valeur doit - être de 1 pour utiliser SQLSetConnectOption() et 2 pour SQLSetStmtOption(). - - - Le paramètre option est l'option à modifier. - - - Le paramètre param est la valeur de l'option - option. - - - - -// 1. L'option 102 de SQLSetConnectOption() est SQL_AUTOCOMMIT. -// 1 de SQL_AUTOCOMMIT est SQL_AUTOCOMMIT_ON. -// Cet exemple a le meme effet que -// odbc_autocommit($conn, TRUE); - -odbc_setoption ($conn, 1, 102, 1); - -// 2. Option 0 de SQLSetStmtOption() est SQL_QUERY_TIMEOUT. -// Cet exemple fixe le délai d'expiration à 30 secondes. - -$result = odbc_prepare ($conn, $sql); -odbc_setoption ($result, 2, 0, 30); -odbc_execute ($result); - - - - - - - - + + + ODBC + + + En plus du support de l'ODBC normal, l'ODBC unifié de PHP vous donne + accès à diverses bases de données qui ont emprunté la sémantique + des API ODBC pour implémenter leur propres API. Au lieu de + maintenir de multiples pilotes qui sont similaires, ces + pilotes ont été rassemblés dans un jeu de fonctions ODBC uniques. + + + Les bases de données suivantes sont supportées par l'ODBC unifié : + Adabas D, + IBM DB2, + iODBC, + Solid, et + Sybase SQL Anywhere. + + + Reportez vous à Installation sous Unix + pour plus de détails sur les configurations de ces serveurs. + + + + Il n'y a pas d'ODBC utilisé lors des connexions aux bases de données + ci-dessus. Les fonctions que vous utiliserez portent des noms + évocateurs, et utilisent les mêmes syntaxes que leurs cousines + d'ODBC. + + + + + + odbc_autocommit + Mode auto-validation + + + + + + int odbc_autocommit + int connection_id + int OnOff + + + + Sans paramètre OnOff, + odbc_autocommit retourne le statut d'auto-validation + de la connexion connection_id. TRUE si le mode + est activé, FALSE si il ne l'est pas, ou si une erreur survient. + + + Si OnOff vaut TRUE, l'auto-validation est + activée. Si il est FALSE, l'auto-validation est désactivée. + Retourne TRUE en cas de succès, FALSE en cas d'échec. + + + Par défaut, l'auto-validation est activée. Désactiver + l'auto-validation est équivalent à démarrer une + transaction. + + + Voir aussi + odbc_commit et odbc_rollback. + + + + + + odbc_binmode + Gestion des colonnes de données binaires. + + + + + + int odbc_binmode + int result_id + int mode + + + + Types ODBC SQL affectés: BINARY, VARBINARY, LONGVARBINARY. + + + + + ODBC_BINMODE_PASSTHRU: Mode Passthru + + + + + ODBC_BINMODE_RETURN: Retourne tel quel. + + + + + ODBC_BINMODE_CONVERT: Converti en char et retourne la valeur. + + + + + Lorsqu'une donnée SQL est convertie en caractère C, + les 8 bits du caractère source sont représentés + par deux caractères ASCII. Ces caractères sont des + représentations ASCII des nombres au format hexadécimal. + Par exemple, le binaire 00000001 est converti en "01" + et le binaire 11111111 est converti en "FF". + + + + + + mode + longueur + résultat + + + + + ODBC_BINMODE_PASSTHRU + 0 + passthru + + + ODBC_BINMODE_RETURN + 0 + passthru + + + ODBC_BINMODE_CONVERT + 0 + passthru + + + ODBC_BINMODE_PASSTHRU + 0 + passthru + + + ODBC_BINMODE_PASSTHRU + >0 + passthru + + + ODBC_BINMODE_RETURN + >0 + Tel quel + + + ODBC_BINMODE_CONVERT + >0 + Caractère + + + + + + + Si odbc_fetch_into est utilisé, passthru + signifie qu'une chaîne vide sera retournée pour ces colonnes. + + + Si result_id vaut 0, ces + paramètres seront appliqués aux nouveaux résultats. + + + La valeur par défaut de 4096 est 4096 et + les valeurs par défaut de odbc_binmode est + ODBC_BINMODE_RETURN. La gestion des colonnes + binaires est aussi modifié par odbc_longreadlen. + + + + + + + + odbc_close + Ferme une connexion ODBC. + + + + + + void odbc_close + int connection_id + + + + odbc_close ferme la connexion avec une source de données, + représentée par l'identifiant de connexion. + + + odbc_close échouera si il y a des + transactions en cours sur cette connexion. Dans ce cas, la connexion + restera ouverte. + + + + + + + + odbc_close_all + Ferme toutes les connexions ODBC + + + + + + void odbc_close_all + + + + + odbc_close_all ferme toutes les connexions + ODBC à des sources de données. + + + odbc_close_all échouera si il y a des + transactions en cours sur cette connexion. Dans ce cas, la connexion + restera ouverte. + + + + + + + + odbc_commit + Valide une transaction ODBC + + + + + + int odbc_commit + int connection_id + + + + Retourne TRUE en case de succès, FALSE en cas d'erreur. Toutes + les connexions en cours sur connection_id sont + validées. + + + + + + odbc_connect + Connexion à une source + + + + + + int odbc_connect + string dsn + string user + string password + int cursor_type + + + + odbc_connect etourne un identifiant de connexion ODBC + ou 0 (FALSE) en cas d'erreur. + + + L'identifiant de connexion retournée par cette fonction est + nécessaire pour toutes les autres fonctions ODBC. Vous pouvez + avoir de multiples connexions en même temps. Le quatrième + paramètre fixe le type de pointeur de résultat + utilisé pour cette connexion. Ce paramètre n'est + généralement pas nécessaire, mais il peut être + utile pour contourner certains problèmes ODBC. + + + Avec certains pilotes ODBC, l'exécution de procédures + enregistrées complexes peut produire l'erreur suivante : + "Cannot open a cursor on a stored procedure that has anything other + than a single select statement in it", ce qui signifie : "Impossible + de créer un pointeur de résultat dans une procédure + enregistrée qui est réduite à une simple selection + (SELECT)). Utiliser l'option SQL_CUR_USE_ODBC permet d'éviter + cette erreur. De plus, certains pilotes ne supportent le paramètre + optionnel de numéro de ligne dans odbc_fetch_row. + SQL_CUR_USE_ODBC peut aussi permettre de résoudre ces problèmes. + + + Les constantes suivantes sont définies comme type de pointeur : + + + + + + SQL_CUR_USE_IF_NEEDED + + + + + SQL_CUR_USE_ODBC + + + + + SQL_CUR_USE_DRIVER + + + + + SQL_CUR_DEFAULT + + + + + Pour les connexions persistantes, reportez vous à + odbc_pconnect. + + + + + + odbc_cursor + Lecture du pointeur de fiche courante (cursorname). + + + + + + string odbc_cursor + int result_id + + + + odbc_cursor lit le pointeur de fiche courante + (cursorname) pour le résultat result_id. + + + + + + odbc_do + Synonyme de odbc_exec + + + + + + string odbc_do + int conn_id + string query + + + + odbc_do excécute la requête + query avec la connexion conn_id. + + + + + + odbc_exec + + Prépare et exécute une requête SQL. + + + + + + + int odbc_exec + int connection_id + string query_string + + + + odbc_exec retourne FALSE en cas d'erreur, ou bien + retourne un identifiant de résultat ODBC en cas + d'exécution réussie. + + + odbc_exec envoie une commande SQL à + la source de données représentée par + connection_id. Ce paramètre doit + être un identifiant valide de connexion, retourné par + odbc_connect ou odbc_pconnect. + + + Voir aussi : odbc_prepare et + odbc_execute pour les éxecutions + multiples de requêtes SQL. + + + + + + odbc_execute + + Exécute une requête SQL préparée. + + + + + + int odbc_execute + int result_id + array + parameters_array + + + odbc_execute exécute une requête SQL + préparée par odbc_prepare. + Retourne TRUE en cas d'exécution réussie, et FALSE + sinon. Le tableau de paramètres + parameters_array ne sert que si vous avez besoin de + paramètres votre requête. + + + + + + odbc_fetch_into + + Lit une ligne de résultat, et la place dans un tableau. + + + + + + + int odbc_fetch_into + int result_id + int rownumber + array result_array + + + + odbc_fetch_into retourne le nombre de colonnes + dans le résultat, ou FALSE en cas d'erreur. + result_array doit avoir été + passé par référence, mais il peut être + de n'importe quel type, étant donné qu'il sera converti en tableau. + Le tableau contiendra les valeurs des colonnes, ces dernières étant numérotées à + partir de 0. + + + + + + odbc_fetch_row + Lit une ligne de résultat. + + + + + + int odbc_fetch_row + int result_id + int row_number + + + + Si odbc_fetch_row a réussi, TRUE est + retourné. Si il n'y avait plus de ligne, ou en cas d'erreur, + FALSE est retourné. + + + odbc_fetch_row lit une ligne dans le + résultat identifié par result_id + et retourné par odbc_do ou + odbc_exec. Après + odbc_fetch_row, les champs seront accessibles avec la + fonction odbc_result. + + + Si row_number est omis, + row_number va tenter de lire la prochaîne + ligne dans le résultat. Des appels répétés + à odbc_fetch_row avec et sans paramètre + row_number peuvent être combinés librement. + + + Pour passer en revue toutes les lignes d'un résultat plusieurs fois, + vous pouvez appeler odbc_fetch_row avec row_number = 1, + puis continue à appeler odbc_fetch_row sans le + paramètre row_number pour passer en revue + tout le résultat. Si un pilote ne supporte pas la lecture des + lignes par numéro, le paramètre sera ignoré. + + + + + + odbc_field_name + Lit le nom de la colonne. + + + + + + string odbc_field_name + int result_id + int field_number + + + + odbc_field_name lit le nom de la colonne dont + l'index est field_number. La + numérotation des champs commence à 1. + FALSE est retourné en cas d'erreur. + + + + + + odbc_field_num + Numéro de colonne + + + + + + int odbc_field_num + int result_id + string field_name + + + + odbc_field_num retourne le numéro de + la colonne nommée field_name. Ce numéro + correspond à l'index du champs dans le résultat ODBC. La numérotation + commence à 1. FALSE est retourné en cas d'erreur. + + + + + + odbc_field_type + Type de données d'un champs. + + + + + + string odbc_field_type + int result_id + int field_number + + + + odbc_field_type retourne le type de données + SQL d'un champs, identifié par son index. La numérotation + des champs commence à 1. + + + + + + odbc_field_len + Lit la longueur d'un champs. + + + + + + int odbc_field_len + int result_id + int field_number + + + + odbc_field_len retourne la longueur du + champs référence par le nombre + field_number, dans la connexion ODBC + result_id. Les numéros de + champs commencent à 1. + + + + + + odbc_field_precision + Alias de odbc_field_len + + + + + + string odbc_field_precision + int result_id + int field_number + + + + odbc_field_precision retourne la précision + du champs référéncé par son numéro field_number, + dans le résultat ODBC result_id. + + + Voir aussi : odbc_field_scale pour connaître + l'échelle d'un nombre à virgule flottante. + + + + + + odbc_field_scale + Lit l'échelle d'un champs + + + + + + string odbc_field_scale + int result_id + int field_number + + + + odbc_field_precision retourne l'échelle + du champs référéncé par son numéro de champs field_number + dans le résultat ODBC result_id. + + + + + + odbc_free_result + + Libère les ressources associées à un résultat + + + + + + + int odbc_free_result + int result_id + + + + Retourne toujours TRUE. + + odbc_free_result n'est nécessaire que + si vous craignez d'utiliser trop de mémoire lors de + l'exécution de votre script. Tous les résultats + en mémoire seront libérés dès la + fin du script. Mais, si vous êtes sûr que vous + n'aurez plus besoin d'un résultat jusqu'à la + fin de votre script, vous pouvez appeler + odbc_free_result, et la + mémoire associée à result_id + sera libérée. + + + + + Si auto-validation est désactivée (voir + odbc_autocommit) et que vous appelez + odbc_free_result avant de valider vos requêtes, + toutes les transactions préparées seront annulées. + + + + + + + + odbc_longreadlen + Gestion des colonnes de type LONG. + + + + + + int odbc_longreadlen + int result_id + int length + + + + Types ODBC SQL affectés: LONG, LONGVARBINARY. + + + Le nombre d'octets retournés à PHP est contrôlé + par le paramètre length. Si sa valeur est 0, + les colonnes de type Long seront transformées en chaîne vide. + + + + La gestion des types LONGVARBINARY est aussi affectée par + odbc_binmode. + + + + + + + odbc_num_fields + Nombre de colonnes dans un résultat + + + + + + int odbc_num_fields + int result_id + + + + odbc_num_fields retourne le nombre de colonnes dans + un résultat ODBC. Cette fonction retournera -1 en cas d'erreur. + L'argument est un identifiant de résultat valide, retourné + par odbc_exec. + + + + + + odbc_pconnect + + Ouvre une connexion persistante à une source de données. + + + + + + + int odbc_pconnect + string dsn + string user + string password + int cursor_type + + + + Retourne un identifiant de connexion ODBC ou 0 (FALSE) en cas d'erreur. + Cette fonction se comporte de manière similaire à + odbc_connect, mais la connexion ouverte + n'est pas vraiment terminée lorsque le script est + terminé. Les prochaînes requêtes qui se + feront sur une connexion dont les dsn, + user, password + sont les mêmes que celle-ci (avec + odbc_connect et odbc_pconnect) + réutiliseront la connexion ouverte. + + + + + Les connexions persistantes n'ont aucun effet + si PHP est utilisé comme CGI. + + + + + Pour plus de détails sur le paramètre optionel + cursor_type, voyez odbc_connect. + Pour plus de détails sur les connexions persistantes, + reportez vous à la FAQ PHP. + + + + + + odbc_prepare + Prépare une commande pour l'exécution + + + + + + int odbc_prepare + int connection_id + string query_string + + + + odbc_prepare prépare une commande pour + l'exécution. + + + Retourne un identifiant de résultat ODBC si la commande SQL + a été préparée avec succès. + L'identifiant peut être utilisé plus tard pour + exécuter la commande avec odbc_execute. + + + + + + odbc_num_rows + Nombre de ligne dans un résultat. + + + + + + int odbc_num_rows + int result_id + + + + odbc_num_rows retourne le nombre de lignes + dans un résultat ODBC. Cette fonction retournera -1 en + cas d'erreur. Pour les commandes INSERT, UPDATE et DELETE, + odbc_num_rows retourne le nombre de ligne + affectées. Pour les commandes SELECT, ce PEUT + le nombre de lignes disponibles, mais ce n'est pas certain. + + + Note: odbc_num_rows après un SELECT + retournera -1 avec de nombreux pilotes. + + + + + + odbc_result + Lit les données de résultat. + + + + + + string odbc_result + int result_id + mixed field + + + + odbc_result retourne le contenu d'un champs. + + + field peut être aussi bien un entier, + contenant le numéro de colonne du champs, dans le + résultat, ou bien une chaîne de caractère, qui + représente le nom du champs. Par exemple: + + + $item_3 = odbc_result($Query_ID, 3 ); + $item_val = odbc_result($Query_ID, "val"); + + + + + Le premier appel à odbc_result retourne + la valeur du troisième champs de la ligne courante, du + résultat result_id. Le deuxième + appel à odbc_result retourne la valeur du + troisième champs dont le nom est "val" de la ligne courante, du + résultat result_id. Une erreur survient si + le paramètre de colonne est inférieur à 1, ou + dépasse le nombre de colonnes du résultat. De la même + manière, une erreur survient si le nom du champs passé ne + correspond à aucun champs dans le résultat. + + + Les index de champs commencent à 1. Pour plus d'informations + sur la façon de lire des colonnes de type binaire ou long, + reportez vous à odbc_binmode et + odbc_longreadlen. + + + + + + odbc_result_all + + Affiche le résultat sous la forme d'une table HTML. + + + + + + + int odbc_result_all + int result_id + string format + + + + odbc_result_all retourne le nombre de lignes + dans le résultat, ou FALSE en cas d'erreur. + + + odbc_result_all affiche toutes les lignes + d'un résultat. L'affichage se fait au format HTML. Avec + l'option format, il est possible de + modifier l'aspect global de la table. + + + + + + odbc_rollback + Annule une transaction + + + + + + int odbc_rollback + int connection_id + + + + odbc_rollback annule toutes les transactions sur + la connexion connection_id. Retourne TRUE en + cas de succès, et FALSE en cas d'echec. + + + + + + odbc_setoption + + Modifie les paramètres ODBC. + + + + + + + int odbc_setoption + int id + int function + int option + int param + + + + odbc_setoption donne accès aux options + ODBC pour une connexion particulière ou un résultat de + requête. Elle a été écrite pour aider à + la résolution de problème liés aux pilotes ODBC + récalcitrants. Vous aurez sûrement à utiliser + cette fonction si vous êtes un programmeur ODBC et que vous + comprenez les divers effets des options disponibles. Vous aurez aussi + besoin d'un bon manuel de référence pour comprendre les + options et leur usage. Différentes versions de pilotes supportent + différentes versions d'options. + + + Etant donné que les effets peuvent varier d'un pilote à + l'autre, l'utilisation de cette fonction dans des scripts voués + à être livrés au public est très fortement + déconseillée. De plus, certaines options ODBC ne sont + pas disponibles car elles doivent être fixées avant + l'établissement de la connexion. Cependant, si dans un cas + bien spécifique, cette fonction vous permet d'utiliser PHP + sans que votre patron vous pousse à utiliser un produit commercial, + alors cela n'a pas d'importance. + + + Id est un identifiant de connexion, ou un identifiant + de résultat, pour lequel vous souhaitez modifier des options. + Pour SQLSetConnectOption(), c'est un identifiant de connexion. + Pour SQLSetStmtOption(), c'est un identifiant de résultat. + + + function est la fonction ODBC à utiliser. + La valeur doit être de 1 pour utiliser SQLSetConnectOption() et 2 + pour SQLSetStmtOption(). + + + Le paramètre option est l'option à + modifier. + + + Le paramètre param est la valeur de l'option + option. + + + +// 1. L'option 102 de SQLSetConnectOption() est SQL_AUTOCOMMIT. +// 1 de SQL_AUTOCOMMIT est SQL_AUTOCOMMIT_ON. +// Cet exemple a le meme effet que +// odbc_autocommit($conn, TRUE); +odbc_setoption ($conn, 1, 102, 1); +// 2. Option 0 de SQLSetStmtOption() est SQL_QUERY_TIMEOUT. +// Cet exemple fixe le délai d'expiration à 30 secondes. +$result = odbc_prepare ($conn, $sql); +odbc_setoption ($result, 2, 0, 30); +odbc_execute ($result); + + + + + + + + odbc_tables + + Liste les tables d'une source. + + + + + + + int odbc_tables + int connection_id + string qualifier + string owner + string name + string types + + + + odbc_tables liste toutes les tables de + la source et retourne un identifiant de résultat ODBC, ou bien + FALSE en cas d'erreur. + + + Le résultat contient les colonnes suivantes : + + TABLE_QUALIFIER + TABLE_OWNER + TABLE_NAME + TABLE_TYPE + REMARKS + + + + Le résultat est ordonné grâce aux options TABLE_TYPE, TABLE_QUALIFIER, + TABLE_OWNER et TABLE_NAME. + + + Les paramètres owner et name + acceptent des masques de recherche ('%' pour remplacer zéro ou plus caractères, + et '_' pour n'en remplacer qu'un seul). + + + Pour supporter les énumérations de qualifiers, propriétaire et types + de tables, la sémantique suivante pour les paramètres + qualifier, owner, + name, et table_type + sont disponibles : + + + + Si qualifier est un signe de pourcentage (%), + et owner et name sont + des chaînes vides, alors le résultat contient la liste des + qualifiers valides pour la source. (toutes les colonnes hormis + TABLE_QUALIFIER contiennent NULL). + + + + + Si owner est un signe de pourcentage (%), + et qualifier et name + sont des chaînes vides, alors le résultat contient la liste des + propriétaires de la source (toutes les colonnes hormis + TABLE_OWNER contiennent NULL). + + + + + Si table_type est un signe de pourcentage (%), + et qualifier, owner et + name sont des chaînes vides, alors le résultat + contient la liste des types de tables de la source (toutes les colonnes hormis + TABLE_TYPE contiennent NULL). + + + + + + Si table_type n'est pas une chaîne vide, + il doit contenir une liste de valeurs, séparées par des virgules, + qui representent les types recherchés. Chaque valeur peut être + insérée entre guillements simples ('), ou sans guillements. Par + exemple "'TABLE','VIEW'" ou "TABLE, VIEW". Si la source de données + ne supporte par un type de table donné, odbc_tables + ne retournera aucun résultat pour ce type. + + + Voir aussi odbc_tableprivileges pour connaître + les droits associés. + + + + + + odbc_tableprivileges + + Liste les tables et leurs privilèges + + + + + + + int odbc_tableprivileges + int connection_id + string qualifier + string owner + string name + + + + odbc_tableprivileges liste les tables de la source + et leurs droits associés. Retourne un identifiant de résultat + ODBC, ou bien FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + TABLE_QUALIFIER + TABLE_OWNER + TABLE_NAME + GRANTOR + GRANTEE + PRIVILEGE + IS_GRANTABLE + + + + Le résultat est ordonné par TABLE_QUALIFIER, TABLE_OWNER et + TABLE_NAME. + + + Les paramètres owner et name + acceptent des masques de recherche ('%' pour remplacer zéro ou plus caractères, + et '_' pour n'en remplacer qu'un seul). + + + + + + odbc_columns + + Liste les colonnes d'une table + + + + + + + int odbc_columns + int connection_id + string qualifier + string owner + string table_name + string column_name + + + + odbc_columns liste toutes les colonnes + de la source dedonnées. Retourne un identifiant de résultat + ODBC, ou bien FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + TABLE_QUALIFIER + TABLE_OWNER + TABLE_NAME + COLUMN_NAME + DATA_TYPE + TYPE_NAME + PRECISION + LENGTH + SCALE + RADIX + NULLABLE + REMARKS + + + + Le résultat est ordonné par TABLE_QUALIFIER, TABLE_OWNER et + TABLE_NAME. + + + Les paramètres owner, column_name + et table_name acceptent des masques de recherche + ('%' pour remplacer zéro ou plus caractères, et '_' pour n'en remplacer + qu'un seul). + + + Voir aussi odbc_columnprivileges pour connaître les + droits associés. + + + + + + odbc_columnprivileges + + Liste les colonnes et leurs droits associés + + + + + + + int odbc_columnprivileges + int connection_id + string qualifier + string owner + string table_name + string column_name + + + + odbc_columnprivileges liste les colonnes + et leurs droits associés pour la table table_name. + Retourne un identifiant de résultat ODBC, ou bien FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + TABLE_QUALIFIER + TABLE_OWNER + TABLE_NAME + GRANTOR + GRANTEE + PRIVILEGE + IS_GRANTABLE + + + + Le résultat est ordonné par TABLE_QUALIFIER, TABLE_OWNER et + TABLE_NAME. + + + Le paramètre column_name accepte + des masques de recherche ('%' pour remplacer zéro ou plus caractères, + et '_' pour n'en remplacer qu'un seul). + + + + + + odbc_gettypeinfo + + Liste les types de données supportés par une source + + + + + + + int odbc_gettypeinfo + int connection_id + int data_type + + + + odbc_gettypeinfo liste les types de données + qui sont supportées par une source. Retourne un identifiant de + résultat, ou FALSE en cas d'erreur. L'argument optionel + data_type peut être utilisé pour + restreindre les informations à un seul type de données. + + + Le résultat possède les colonnes suivantes : + + TYPE_NAME + DATA_TYPE + PRECISION + LITERAL_PREFIX + LITERAL_SUFFIX + CREATE_PARAMS + NULLABLE + CASE_SENSITIVE + SEARCHABLE + UNSIGNED_ATTRIBUTE + MONEY + AUTO_INCREMENT + LOCAL_TYPE_NAME + MINIMUM_SCALE + MAXIMUM_SCALE + + + Le résultat est ordonné par DATA_TYPE et TYPE_NAME. + + + + + + odbc_primarykeys + + Liste les colonnes utilisées dans une clé primaire + + + + + + + int odbc_primarykeys + int connection_id + string qualifier + string owner + string table + + + + odbc_primarykeys liste les colonnes + utilisées dans une clé primaire de la table table. + Retourne un identifiant de résultat, ou FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + TABLE_QUALIFIER + TABLE_OWNER + TABLE_NAME + COLUMN_NAME + KEY_SEQ + PK_NAME + + + + + + + odbc_foreignkeys + + Liste les clés étrangères + + + + + + + int odbc_foreignkeys + int connection_id + string pk_qualifier + string pk_owner + string pk_table + string fk_qualifier + string fk_owner + string fk_table + + + + odbc_foreignkeys liste les clés étrangèes + utilisées dans la table pk_table. + Retourne un identifiant de résultat, ou FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + PKTABLE_QUALIFIER + PKTABLE_OWNER + PKTABLE_NAME + PKCOLUMN_NAME + FKTABLE_QUALIFIER + FKTABLE_OWNER + FKTABLE_NAME + FKCOLUMN_NAME + KEY_SEQ + UPDATE_RULE + DELETE_RULE + FK_NAME + PK_NAME + + + + Si pk_table contient un nom de table, + odbc_foreignkeys retourne la clé primaire + de la table pk_table, et toutes les + clés étrangères qui y font référence. + + + Si fk_table contient un nom de table, + odbc_foreignkeys retourne la liste des + clés étrangères de la table fk_table, + et les clés primaires (d'autres tables) qui y font référence. + + + Si pk_table et + fk_table contiennent des noms de tables, + odbc_foreignkeys retourne la liste des clés + étrangères de la table fk_table qui utilisent + la clé primaire de la table pk_table. + Cette liste devrait ne contenir qu'une clé au mieux. + + + + + + odbc_procedures + + Liste les procédure stockées + + + + + + + int odbc_procedures + int connection_id + string qualifier + string owner + string name + + + + odbc_procedures liste toutes les procédures + stockées dans la source de données. Retourne un identifiant de + résultat, ou FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + PROCEDURE_QUALIFIER + PROCEDURE_OWNER + PROCEDURE_NAME + NUM_INPUT_PARAMS + NUM_OUTPUT_PARAMS + NUM_RESULT_SETS + REMARKS + PROCEDURE_TYPE + + + + Les paramètres owner et name + acceptent des masques de recherche ('%' pour remplacer zéro ou + plus caractères, et '_' pour n'en remplacer qu'un seul). + + + + + + odbc_procedurecolumns + + Liste les paramètres des procédures + + + + + + + int odbc_procedurecolumns + int connection_id + string qualifier + string owner + string proc + string column + + + + odbc_procedurecolumns list les paramètres + d'entrée et de sortie, ainsi que les colonnes utilisées dans les procédures + désignées par les paramètres. Retourne un identifiant de résultat, ou + FALSE en cas d'erreur. + + + Le résultat possède les colonnes suivantes : + + PROCEDURE_QUALIFIER + PROCEDURE_OWNER + PROCEDURE_NAME + COLUMN_NAME + COLUMN_TYPE + DATA_TYPE + TYPE_NAME + PRECISION + LENGTH + SCALE + RADIX + NULLABLE + REMARKS + + + Le résultat est ordonné par PROCEDURE_QUALIFIER, PROCEDURE_OWNER, + PROCEDURE_NAME et COLUMN_TYPE. + + + Les paramètres owner, proc et + column acceptent des masques de recherche + ('%' pour remplacer zéro ou plus caractères, et '_' pour n'en + remplacer qu'un seul). + + + + + + odbc_specialcolumns + + Retourne l'ensemble optimal de colonnes, qui permettent de + définir uniquement une ligne dans une table + + + + + + + int odbc_specialcolumns + int connection_id + int type + string qualifier + string owner + string table + int scope + int nullable + + + + Lorsque le