Index: phpdoc/fr/functions/nis.xml diff -u phpdoc/fr/functions/nis.xml:1.7 phpdoc/fr/functions/nis.xml:1.8 --- phpdoc/fr/functions/nis.xml:1.7 Sat Jul 7 18:22:17 2001 +++ phpdoc/fr/functions/nis.xml Mon Nov 12 18:37:22 2001 @@ -1,377 +1 @@ - - NIS - NIS - - - NIS (feu Yellow Pages / Pages jaunes) permet la gestion par le - réseau de fichiers d'administration importants (tel un - fichier de mot de passe). Pour plus d'informations, reportez - vous au manuel NIS, ou à - Introduction to YP/NISIntroduction to YP/NIS - (en anglais). Il existe un livre en anglais - Managing NFS and NIS" par Hal Stern. - - - Pour ajouter ces fonctionnalitées, vous devez compiler PHP - avec l'option (PHP 3) ou - (PHP 4). - - - - - yp_get_default_domain - Retourne le domaine NIS par défaut. - - - Description - - - int yp_get_default_domain - void - - - - yp_get_default_domain retourne le nom de domaine NIS - par défaut. Ce nom de domaine peut être utilisé pour - les futurs appels NIS. - - - Un domaine NIS peut être décrit comme un regroupement - de cartes NIS. Tous les hôtes qui ont besoin d'informations, - s'attachent à un domaine. Référez vous aux documents - cités en début de document pour plus de détails. - - - - Exemple avec le domaine par défaut - -<?php - $domain = yp_get_default_domain(); - echo "Le domaine par défaut est : " . $domain; -?> - - - - - - - - - yp_order - Retourne le numéro d'ordre d'une carte. - - - Description - - - int yp_order - string domain - string map - - - - yp_order retourne le numéro d'ordre d'une - carte ou &false;. - - - - Exemple d'ordre NIS - -<?php - $number = yp_order($domain,$mapname); - echo "Le numéro d'ordre de cette carte est : " . $order; -?> - - - - - Voir aussi yp-get-default-domain. - - - - - - - yp_master - - Retourne le nom de la machine maître pour une carte. - - - - Description - - - string yp_master - string domain - string map - - - - yp_master retourne le nom de la machine maître - d'une carte. - - - - Exemple de maître NIS - -<?php - $number = yp_master($domain, $mapname); - echo "Master for this map is: " . $master; -?> - - - - - Voir aussi yp-get-default-domain. - - - - - - - yp_match - Retourne la ligne associée. - - - Description - - - string yp_match - string domain - string map - string key - - - - yp_match retourne la valeur associée - à la clé passée en argument, pour la carte - spécifiée, ou &false;. La clé doit exister et - être exacte. - - - - Exemple de recherche NIS - -<?php - $entry = yp_match($domain, "passwd.byname", "joe"); - echo "La valeur trouvée est: " . $entry; -?> - - - - - Dans le cas présent, ce pourrait être: - joe:##joe:11111:100:Joe User:/home/j/joe:/usr/local/bin/bash - - - Voir aussi yp-get-default-domain - - - - - - - yp_first - - Retourne le premier couple (clé ; valeur) d'une carte donnée. - - - - Description - - - array yp_first - string domain - string map - - - - yp_first retourne le premier couple - (clé ; valeur) d'une carte donnée, ou &false;. - - - - Exemple avec <function>yp_first</function> - -<?php -$entree = yp_first($domain, "passwd.byname"); -$cle = $entry ["key"]; -$valeur = $entry ["value"]; -echo "La première entrée de cette carte est " . $key - . " et sa valeur est " . $entry[$key]; -?> - - - - - Voir aussi yp-get-default-domain - - - - - - - yp_next - - Retourne le couple (clé ; valeur) suivant d'une carte donnée. - - - - Description - - - array yp_next - string domain - string map - string key - - - - yp_next retourne le couple (clé ; valeur) - suivant la clé donnée d'une carte donnée ou &false;. - - - - Exemple avec <function>yp_next</function> - -<?php - $entry = yp_next($domain, "passwd.byname", "joe"); - if(!$entry) { - echo "Plus d'autres entrées.\n"; - } - $key = key($entry); - echo "L'entrée suivante après "joe" a la clé " . $key - . " et la valeur " . $entry[$key]; -?> - - - - - Voir aussi yp-get-default-domain. - - - - - - - - + NIS NIS NIS (feu Yellow Pages / Pages jaunes) permet la gestion par le réseau de fichiers d'administration importants (tel un fichier de mot de passe). Pour plus d'informations, reportez vous au manuel NIS, ou à Introduction to YP/NISIntroduction to YP/NIS (en anglais). Il existe un livre en anglais Managing NFS and NIS" par Hal Stern. Pour ajouter ces fonctionnalitées, vous devez compiler PHP avec l'option (PHP 3) ou (PHP 4). yp_get_default_domain Retourne le domaine NIS par défaut. Description int yp_get_default_domain void yp_get_default_domain retourne le nom de domaine NIS par défaut. Ce nom de domaine peut être utilisé pour les futurs appels NIS. Un domaine NIS peut être décrit comme un regroupement de cartes NIS. Tous les hôtes qui ont besoin d'informations, s'attachent à un domaine. Référez-vous aux documents cités en début de document pour plus de détails. Exemple avec le domaine par défaut <?php $domain = yp_get_default_domain(); echo "Le domaine par défaut est : " . $domain;?> yp_order Retourne le numéro d'ordre d'une carte. Description int yp_order string domain string map yp_order retourne le numéro d'ordre d'une carte ou &false;. Exemple d'ordre NIS <?php$number = yp_order($domain,$mapname);echo "Le numéro d'ordre de cette carte est : " . $number;?> Voir aussi yp-get-default-domain. yp_master Retourne le nom de la machine maître pour une carte. Description string yp_master string domain string map yp_master retourne le nom de la machine maître d'une carte. Exemple de maître NIS <?php $number = yp_master($domain, $mapname); echo "Master for this map is: " . $master;?> Voir aussi yp-get-default-domain. yp_match Retourne la ligne associée. Description string yp_match string domain string map string key yp_match retourne la valeur associée à la clé passée en argument, pour la carte spécifiée, ou &false;. La clé doit exister et être exacte. Exemple de recherche NIS <?php $entry = yp_match($domain, "passwd.byname", "joe"); echo "La valeur trouvée est: " . $entry;?> Dans le cas présent, ce pourrait être: joe:##joe:11111:100:Joe User:/home/j/joe:/usr/local/bin/bash Voir aussi yp-get-default-domain. yp_first Retourne le premier couple (clé ; valeur) d'une carte donnée. Description array yp_first string domain string map yp_first retourne le premier couple (clé ; valeur) d'une carte donnée, ou &false;. Exemple avec <function>yp_first</function> <?php$entree = yp_first($domain, "passwd.byname");$cle = $entry ["key"];$valeur = $entry ["value"];echo "La première entrée de cette carte est " . $key . " et sa valeur est " . $entry[$key];?> Voir aussi yp-get-default-domain. yp_next Retourne le couple (clé ; valeur) suivant d'une carte donnée. Description array yp_next string domain string map string key yp_next retourne le couple (clé ; valeur) suivant la clé donnée d'une carte donnée ou &false;. Exemple avec <function>yp_next</function> <?php $entry = yp_next($domain, "passwd.byname", "joe"); if(!$entry) { echo "Plus d'autres entrées.\n"; } $key = key($entry); echo "L'entrée suivante après "joe" a la clé " . $key . " et la valeur " . $entry[$key];?> Voir aussi yp-get-default-domain. \ No newline at end of file Index: phpdoc/fr/functions/oci8.xml diff -u phpdoc/fr/functions/oci8.xml:1.14 phpdoc/fr/functions/oci8.xml:1.15 --- phpdoc/fr/functions/oci8.xml:1.14 Fri Jul 20 03:58:17 2001 +++ phpdoc/fr/functions/oci8.xml Mon Nov 12 18:37:22 2001 @@ -1,3 +1,5 @@ + + Oracle 8 oci8 @@ -383,7 +385,9 @@ - Voir aussi ociplogon et ocinlogon. + Voir aussi + ociplogon et + ocinlogon. @@ -412,7 +416,9 @@ connexion. - Voir aussi ocilogon et ocinlogon. + Voir aussi + ocilogon et + ocinlogon. @@ -523,7 +529,8 @@ - Voir aussi ocilogon et + Voir aussi + ocilogon et ociplogon. @@ -531,7 +538,7 @@ ociLogOff - Déconnexion d'un serveur Oracle + Déconnexion d'un serveur Oracle. Description @@ -549,7 +556,7 @@ ociexecute - Exécute une commande + Exécute une commande. Description @@ -594,7 +601,7 @@ ociRollback - Annule les transactions en cours + Annule les transactions en cours. Description @@ -633,14 +640,14 @@ oci_D_FILE, oci_D_LOB et oci_D_ROWID. - ociNewDescriptor + ocinewdescriptor <?php /* Ce script est fait pour être appelé dans un formulaire HTML * Il attends les variables $user, $password, $table, $where, et $commitsize * Le script efface alors les lignes sélectionnées avec ROWID et valide * l'effacement après chaque groupe de $commitsize lignes. - * (Utilisez avec prudences, car il n'y a pas d'annulation possible). + * (Utilisez avec prudence, car il n'y a pas d'annulation possible). */ $conn = ociLogon($user, $password); $stmt = ociparse($conn,"select rowid from $table $where"); @@ -697,6 +704,36 @@ ?> + + Exemple avec <function>ocinewdescriptor</function> + +<?php + /* Appel d'une procˇdure PL/SQL stockˇe qui prend un clobs en entrˇe + * (PHP 4 >= 4.0.6). + * Exemple de signateure de procˇdure stockˇe PL/SQL : + * + * PROCEDURE save_data + * Nom de l'argument Type In/Out Default? + * ------------------------------ ----------------------- ------ -------- + * KEY NUMBER(38) IN + * DATA CLOB IN + * + */ + + $conn = OCILogon($user, $password); + $stmt = OCIParse($conn, "begin save_data(:key, :data); end;"); + $clob = OCINewDescriptor($conn, OCI_D_LOB); + OCIBindByName($stmt, ':key', $key); + OCIBindByName($stmt, ':data', $clob, -1, OCI_B_CLOB); + $clob->WriteTemporary($data); + OCIExecute($stmt, OCI_DEFAULT); + OCICommit($conn); + $clob->close(); + $clob->free(); + OCIFreeStatement($stmt); +?> + + @@ -792,7 +829,7 @@ ociResult - Retourne la valeur d'une colonne dans une ligne lue + Retourne la valeur d'une colonne Description @@ -816,7 +853,7 @@ ociFetch - Modifie la prochaine ligne dans le pointeur interne de résultat. + Modifie la prochaine ligne dans le résultat. @@ -894,7 +931,7 @@ int ocifetchstatement resource stmt - array &variable + array &variable @@ -943,7 +980,7 @@ ociColumnIsNULL - Teste si la valeur d'une colonne est NULL + Teste si la valeur d'une colonne est NULL. Description @@ -1142,7 +1179,8 @@ - Voir aussi ocinumcols, + Voir aussi + ocinumcols, ocicolumnname et ocicolumnsize. @@ -1182,7 +1220,7 @@ ociStatementType - Retourne le type de commande oci. + Retourne le type de commande OCI. Description Index: phpdoc/fr/functions/oracle.xml diff -u phpdoc/fr/functions/oracle.xml:1.10 phpdoc/fr/functions/oracle.xml:1.11 --- phpdoc/fr/functions/oracle.xml:1.10 Sat Nov 10 16:49:50 2001 +++ phpdoc/fr/functions/oracle.xml Mon Nov 12 18:37:22 2001 @@ -1,5 +1,5 @@ - + Oracle Oracle @@ -266,8 +266,10 @@ ora_error et ora_errorcode. - Voir aussi ora_parse,ora_exec, - et ora_fetch. + Voir aussi + ora_parse, + ora_exec et + ora_fetch. @@ -378,8 +380,10 @@ Lit une ligne de données sur le pointeur cursor. - Voir aussi ora_parse,ora_exec, - et ora_do. + Voir aussi + ora_parse, + ora_exec et + ora_do. @@ -420,8 +424,11 @@ Notez que vous devez passer le tableau par référence; - Voir aussi ora_parse,ora_exec, - ora_fetch, et ora_do. + Voir aussi + ora_parse, + ora_exec, + ora_fetch et + ora_do. @@ -565,8 +572,11 @@ significative qu'après une requête parse/exec/fetch. - Voir aussi ora_parse,ora_exec, - ora_fetch, et ora_do. + Voir aussi + ora_parse, + ora_exec, + ora_fetch et + ora_do. Index: phpdoc/fr/functions/ovrimos.xml diff -u phpdoc/fr/functions/ovrimos.xml:1.5 phpdoc/fr/functions/ovrimos.xml:1.6 --- phpdoc/fr/functions/ovrimos.xml:1.5 Sat Jul 7 18:22:19 2001 +++ phpdoc/fr/functions/ovrimos.xml Mon Nov 12 18:37:22 2001 @@ -1,789 +1 @@ - - Ovrimos SQL - OvrimosSQL - - - Ovrimos SQL Server est une base de données relationnelle client/serveur - et transactionelle, combinée avec des fonctionnalités web, et des - transactions rapides. - - - Ovrimos SQL Server est disponible à www.ovrimos.com. Pour activer le support - ovrimos de PHP, il suffit de compiler PHP avec l'option '--with-ovrimos' - du script de configuration. Vous devrez aussi installer la librairie sqlcli - disponbile avec la distribution Ovrimos SQL Server. - - - - - Connection au serveur Ovrimos SQL Server et selectionn d'une table système - - -<?php -$conn = ovrimos_connect ("server.domain.com", "8001", "admin", "password"); -if ($conn != 0) { - echo ("Connection établie!"); - $res = ovrimos_exec ($conn, "select table_id, table_name from sys.tables"); - if ($res != 0) { - echo "Requête effectuée!"; - ovrimos_result_all ($res); - ovrimos_free_result ($res); - } - ovrimos_close($conn); -} -?> - - - Cet exemple effectue une connexion réussie. - - - - - ovrimos_connect - Connexion à un serveur - - - Description - - - int ovrimos_connect - string host - string db - string user - string password - - - - ovrimos_connect sert à se connecter à un serveur - Ovrimos. - - - ovrimos_connect retourne un identifiant de connexion, - supérieur à 0, ou 0 en cas d'échec.host est l'adresse - IP de l'hôte Ovrimos, et db est soit le nom d'une - base de donnes, soit une chaîne contenant le numéro de port. - - - - Exemple avec <function>ovrimos_connect</function> - -<?php -$conn = ovrimos_connect ("server.domain.com", "8001", "admin", "password"); -if ($conn != 0) { - echo "Connection établie!"; - $res=ovrimos_exec ($conn, "select table_id, table_name from sys.tables"); - if ($res != 0) { - echo "Requête effectuée!"; - ovrimos_result_all ($res); - ovrimos_free_result ($res); - } - ovrimos_close ($conn); -} -?> - - - L'exemple ci dessus montre comment se connecter à une base de donnée - et afficher le contenu d'une table. - - - - - - ovrimos_close - Ferme une connexion - - - Description - - - void ovrimos_close - int connection - - - - ovrimos_close sert à ferme une connexion - à un serveur Ovrimos. - - - ovrimos_close ferme la connexion au serveur - Ovrimos. Toutes les transactions non validées sont annulées. - - - - - - ovrimos_close_all - Ferme toutes les connexions aux serveur ovrimos - - - Description - - - void ovrimos_close_all - void - - - - ovrimos_close_all sert à ferme toutes les connexions. - - - ovrimos_close_all ferme toute les connexions à - Ovrimos. Toutes les transactions non validées sont annulées. - - - - - - ovrimos_longreadlen - - Indique la taille des données à lire dans une colonne de grande taille - - - - Description - - - int ovrimos_longreadlen - int result_id - int length - - - - ovrimos_longreadlen sert à lire la taille des - données qui sera lues lors de l'accès une colonne de grande taille. - - - ovrimos_longreadlen indique le nombre d'octets - qui seront lus dans une colonne de grande taille (long varchar et long - varbinary). Par défaut, 0. Indépendemment du fait que - ovrimos_longreadlen requiert result_id, - actuellement ovrimos_longreadlen affecte ce paramètre - pour tous les résultats. Retourne vrai. - - - - - - ovrimos_prepare - Prépare une requête SQL - - - Description - - - int ovrimos_prepare - int connection_id - string query - - - - ovrimos_prepare sert à préparer une requête SQL. - - - ovrimos_prepare prépare une requête SQL - et retourne un identifiant de résultat result_id (ou &false; en cas d'échec). - - - - Connexion à un serveur Ovrimos SQL Server et préparation d'une requête - -<?php -$conn=ovrimos_connect ("db_host", "8001", "admin", "password"); -if ($conn!=0) { - echo "Connection établie!"; - $res=ovrimos_prepare ($conn, "select table_id, table_name - from sys.tables where table_id=1"); - if ($res != 0) { - echo "Préparation faite!"; - if (ovrimos_execute ($res)) { - echo "Exécution réussie!\n"; - ovrimos_result_all ($res); - } else { - echo "Exécution manquée!"; - } - ovrimos_free_result ($res); - } else { - echo "Préparation manquée!\n"; - } - ovrimos_close ($conn); -} -?> - - - Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server, - comment préparer une requête SQL et l'exécuter. - - - - - - ovrimos_execute - Exécute une requête préparée - - - Description - - - int ovrimos_execute - int result_id - array - parameters_array - - - - - ovrimos_execute sert à exécuter une requête SQL. - - - ovrimos_execute exécute une requête préparée. - Retourne &true; ou &false;. Si la requête préparée contient des - paramètres (des points d'interrogations dans la requête), un nombre - correct de paramètre doit être passé dans le tableau - parameters_array. Notez que ovrimos_execute ne - suit pas les conventions PHP qui placent les noms des paramètres - entre crochets. L'auteur n'a pas pu s'y faire. - - - - - - ovrimos_cursor - Retourne le nom du curseur - - - Description - - - int ovrimos_cursor - int result_id - - - - ovrimos_cursor sert à lire le nom du curseur - - - ovrimos_cursor retourne le nom du curseur. - Pratique, lorsqu'on veut faire des modifications ou des effacements - avec des curseurs déjà positionnés. - - - - - - ovrimos_exec - Exécute une requĶte SQL - - - Description - - - int ovrimos_exec - int connection_id - string query - - - - ovrimos_exec sert à exécuter une requête SQL. - - - ovrimos_exec exécute une requête SQL - (selection ou modification), et retourne un identifiant de résultat - result_id (ou bien &false;, en cas d'échec). Evidemment, la requête - SQL ne doit pas contenir de paramètres. - - - - - - ovrimos_fetch_into - Lit une ligne dans un résultat - - - Description - - - int ovrimos_fetch_into - int result_id - array result_array - string - how - - int - rownumber - - - - - ovrimos_fetch_into lit une ligne dans un résultat SQL. - - - ovrimos_fetch_into lit une ligne dans le - résultat result_id, qui doit être passé - en référence. La ligne qui sera lue est déterminée par les deux - paramètres how et - rownumber. - how peut prendre les valeurs de - 'Next' (suivant, valeur par défaut), 'Prev' (précédent), 'First' (premier), - 'Last' (dernier), 'Absolute' (position absolue). La casse de how - n'est pas prise en compte. rownumber - est optionne, sauf dans le cas d''Absolute'. Retourne &true; ou &false;. - - - - Lit un exemple - -<?php -$conn=ovrimos_connect ("neptune", "8001", "admin", "password"); -if ($conn!=0) { - echo "Connection établie!"; - $res=ovrimos_exec ($conn,"SELECT table_id, table_name FROM sys.tables"); - if ($res != 0) { - echo "Requête effectuée!"; - if (ovrimos_fetch_into ($res, &$row)) { - list ($table_id, $table_name) = $row; - echo "table_id=".$table_id.", table_name=".$table_name."\n"; - if (ovrimos_fetch_into ($res, &$row)) { - list ($table_id, $table_name) = $row; - echo "table_id=".$table_id.", table_name=".$table_name."\n"; - } else { - echo "Next: erreur\n"; - } - } else { - echo "First: erreur\n"; - } - ovrimos_free_result ($res); - } - ovrimos_close ($conn); -} -?> - - - Cet exemple lis une ligne. - - - - - - ovrimos_fetch_row - Lit une ligne dans un résultat - - - Description - - - int ovrimos_fetch_row - int result_id - int - how - - int - row_number - - - - - ovrimos_fetch_row lit une ligne dans un résultat SQL. - - - ovrimos_fetch_row lit une ligne dans un résultat. - Les colonnes doivent être lues par un autre appel. Retourne &true; ou &false;. - - - - Exemple de lecture de ligne - -<?php -$conn = ovrimos_connect ("remote.host", "8001", "admin", "password"); -if ($conn != 0) { - echo "Connection établie!"; - $res=ovrimos_exec ($conn, "select table_id, table_name from sys.tables"); - if ($res != 0) { - echo "Requête effectuée!"; - if (ovrimos_fetch_row ($res, "First")) { - $table_id = ovrimos_result ($res, 1); - $table_name = ovrimos_result ($res, 2); - echo "table_id=".$table_id.", table_name=".$table_name."\n"; - if (ovrimos_fetch_row ($res, "Next")) { - $table_id = ovrimos_result ($res, "table_id"); - $table_name = ovrimos_result ($res, "table_name"); - echo "table_id=".$table_id.", table_name=".$table_name."\n"; - } else { - echo "Next: erreur\n"; - } - } else { - echo "First: erreur\n"; - } - ovrimos_free_result ($res); - } - ovrimos_close ($conn); -} -?> - - - Cet exemple lit une ligne et l'affiche. - - - - - - ovrimos_result - Lit le contenu d'une colonne - - - Description - - - int ovrimos_result - int result_id - mixed field - - - - ovrimos_result sert à lire le contenu d'une - colonne. - - - ovrimos_result lit le contenu de la colonne - field dans le résultat result_id. - field peut être le nom de la colonne (une chaîne) - ou bien le numéro de la colonne (la première colonne est alors - 1). - - - - - - ovrimos_result_all - - Affiche un résultat sous forme de table HTML - - - - Description - - - int ovrimos_result_all - int result_id - string - format - - - - - ovrimos_result_all sert à afficher tout le résultat - d'une requête. - - - ovrimos_result_all affiche le résultat de la requête - représentée par result_id. Retourne &true; ou &false;. - - - - Prépare une requête, l'éxécute, et affiche le résultat - -<?php -$conn = ovrimos_connect ("db_host", "8001", "admin", "password"); -if ($conn != 0) { - echo "Connection établie!"; - $res = ovrimos_prepare ($conn, "select table_id, table_name - from sys.tables where table_id = 7"); - if ($res != 0) { - echo "Préparation faite!"; - if (ovrimos_execute ($res, array(3))) { - echo "Exécution réussie!\n"; - ovrimos_result_all ($res); - } else { - echo "Exécution manquée!"; - } - ovrimos_free_result ($res); - } else { - echo "Préparation manquée!\n"; - } - ovrimos_close ($conn); -} -?> - - - Cet exemple exécute une requête SQL et affiche le résultat sous forme - d'une table HTML. - - - - <function>ovrimos_result_all</function> avec meta-information - -<?php -$conn = ovrimos_connect ("db_host", "8001", "admin", "password"); -if ($conn != 0) { - echo "Connection établie!"; - $res = ovrimos_exec ($conn, "select table_id, table_name - from sys.tables where table_id = 1") - if ($res != 0) { - echo "Requête effectuée! cursor=".ovrimos_cursor ($res)."\n"; - $colnb = ovrimos_num_fields ($res); - echo "Output columns=".$colnb."\n"; - for ($i=1; $i<=$colnb; $i++) { - $name = ovrimos_field_name ($res, $i); - $type = ovrimos_field_type ($res, $i); - $len = ovrimos_field_len ($res, $i); - echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; - } - ovrimos_result_all ($res); - ovrimos_free_result ($res); - } - ovrimos_close ($conn); -} -?> - - - - - - Exemple avec <function>ovrimos_result_all</function> - -<?php -$conn = ovrimos_connect ("db_host", "8001", "admin", "password"); -if ($conn != 0) { - echo "Connection établie!"; - $res = ovrimos_exec ($conn, "update test set i=5"); - if ($res != 0) { - echo "Requête effectuée!"; - echo ovrimos_num_rows ($res)." lignes affectées\n"; - ovrimos_free_result ($res); - } - ovrimos_close ($conn); -} -?> - - - - - - - - ovrimos_num_rows - - Retourne le nombre de lignes affectées par une modification - - - - Description - - - int ovrimos_num_rows - int result_id - - - - ovrimos_num_rows retourne le nombre de lignes - affectées par une modification - - - - - - ovrimos_num_fields - Retourne le nombre de colonnes - - - Description - - - int ovrimos_num_fields - int result_id - - - - ovrimos_num_fields indique le nombre de colonnes - du résultat result_id. - - - - - - ovrimos_field_name - Retourne le nom d'une colonne - - - Description - - - int ovrimos_field_name - int result_id - int field_number - - - - ovrimos_field_name sert à obtenir le nom d'une - colonne. - - - ovrimos_field_name retourne le nom d'une colonne - à partir de son numéro de colonne field_number, - (la première colonne est à 1). - - - - - - ovrimos_field_type - - Retourne le type numérique d'une colonne - - - - Description - - - int ovrimos_field_type - int result_id - int field_number - - - - ovrimos_field_type sert à connaitre le type - numérique d'une colonne. - - - ovrimos_field_type retourne le type numérique - d'une colonne, identifiée par son numéro field_number - dans le résultat field_number. - - - - - - ovrimos_field_len - Retourne la taille d'une colonne - - - Description - - - int ovrimos_field_len - int result_id - int field_number - - - - ovrimos_field_len sert à connaître la taille - d'une colonne. - - - ovrimos_field_len retourne la taille de la - colonne field_number, dans le résultat - field_number. - - - - - - ovrimos_field_num - - Retourne le numéro de colonne - - - - Description - - - int ovrimos_field_num - int result_id - string field_name - - - - ovrimos_field_num sert à connaître le nuémro de - colonne, à partir de son nom. - - - ovrimos_field_num retourne le numéro de la colonne - field_name (la numérotation commence à 1), dans - result_id. - - - - - - ovrimos_free_result - Libère les ressources utilisées par un résultat - - - Description - - - int ovrimos_free_result - int result_id - - - - ovrimos_free_result sert à effacer un résultat. - - - ovrimos_free_result libère toutes les ressources prises - par le résultat result_id. Retourne &true;. - - - - - - ovrimos_commit - Valide une transaction - - - Description - - - int ovrimos_commit - int connection_id - - - - ovrimos_commit sert à exécuter une - transaction. - - - ovrimos_commit exécute la transaction préparée - sur la connexion connection_id. - - - - - - ovrimos_rollback - Annule une transaction - - - Description - - - int ovrimos_rollback - int connection_id - - - - ovrimos_rollback sert à annuler une transaction. - - - ovrimos_rollback annule la transaction préparée sur - la connexion connection_id. - - - - - + Ovrimos SQL OvrimosSQL Ovrimos SQL Server est une base de données relationnelle client/serveur et transactionnelle, combinée avec des fonctionnalités web, et des transactions rapides. Ovrimos SQL Server est disponible à www.ovrimos.com. Pour activer le support ovrimos de PHP, il suffit de compiler PHP avec l'option du script de configuration. Vous devrez aussi installer la librairie sqlcli disponible avec la distribution Ovrimos SQL Server. Connection au serveur Ovrimos SQL Server et sélection d'une table système <?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");if ($conn != 0) { echo ("Connection établie!"); $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> Cet exemple effectue une connexion réussie. ovrimos_connect Connexion à un serveur Description int ovrimos_connect string host string db string user string password ovrimos_connect sert à se connecter à un serveur Ovrimos. ovrimos_connect retourne un identifiant de connexion, supérieur à 0, ou 0 en cas d'échec.host est l'adresse IP de l'hôte Ovrimos, et db est soit le nom d'une base de données, soit une chaîne contenant le numéro de port. Exemple avec <function>ovrimos_connect</function> <?php$conn = ovrimos_connect("server.domain.com", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> L'exemple ci-dessus montre comment se connecter à une base de données et afficher le contenu d'une table. ovrimos_close Ferme une connexion Description void ovrimos_close int connection ovrimos_close sert à ferme une connexion à un serveur Ovrimos. ovrimos_close ferme la connexion au serveur Ovrimos. Toutes les transactions non validées sont annulées. ovrimos_longreadlen Indique la taille des données à lire dans une colonne de grande taille Description int ovrimos_longreadlen int result_id int length ovrimos_longreadlen sert à lire la taille des données qui sera lues lors de l'accès une colonne de grande taille. ovrimos_longreadlen indique le nombre d'octets qui seront lus dans une colonne de grande taille (long varchar et long varbinary). Par défaut, 0. Indépendemment du fait que ovrimos_longreadlen requiert result_id, actuellement ovrimos_longreadlen affecte ce paramètre pour tous les résultats. ovrimos_prepare Prépare une requête SQL Description int ovrimos_prepare int connection_id string query ovrimos_prepare sert à préparer une requête SQL. ovrimos_prepare prépare une requête SQL et retourne un identifiant de résultat result_id (ou &false; en cas d'échec). Connexion à un serveur Ovrimos SQL Server et préparation d'une requête <?php$conn=ovrimos_connect("db_host", "8001", "admin", "password");if ($conn!=0) { echo "Connection établie!"; $res=ovrimos_prepare($conn, "select table_id, table_name from sys.tables where table_id=1"); if ($res != 0) { echo "Préparation faite!"; if (ovrimos_execute($res)) { echo "Exécution réussie!\n"; ovrimos_result_all($res); } else { echo "Exécution manquée!"; } ovrimos_free_result($res); } else { echo "Préparation manquée!\n"; } ovrimos_close($conn);}?> Cet exemple montre comment se connecter à un serveur Ovrimos SQL Server, comment préparer une requête SQL et l'exécuter. ovrimos_execute Exécute une requête préparée Description boolean ovrimos_execute int result_id array parameters_array ovrimos_execute sert à exécuter une requête SQL. ovrimos_execute exécute une requête préparée. ovrimos_execute retourne &true; ou &false;. Si la requête préparée contient des paramètres (des points d'interrogations dans la requête), un nombre correct de paramètre doit être passé dans le tableau parameters_array. Notez que ovrimos_execute ne suit pas les conventions PHP qui placent les noms des paramètres entre crochets. L'auteur n'a pas pu s'y faire. ovrimos_cursor Retourne le nom du curseur Description int ovrimos_cursor int result_id ovrimos_cursor sert à lire le nom du curseur ovrimos_cursor retourne le nom du curseur. Pratique, lorsqu'on veut faire des modifications ou des effacements avec des curseurs déjà positionnés. ovrimos_exec Exécute une requête SQL Description int ovrimos_exec int connection_id string query ovrimos_exec sert à exécuter une requête SQL. ovrimos_exec exécute une requête SQL (selection ou modification), et retourne un identifiant de résultat result_id (ou bien &false;, en cas d'échec). Evidemment, la requête SQL ne doit pas contenir de paramètres. ovrimos_fetch_into Lit une ligne dans un résultat Description boolean ovrimos_fetch_into int result_id array result_array string how int rownumber ovrimos_fetch_into lit une ligne dans un résultat SQL. ovrimos_fetch_into lit une ligne dans le résultat result_id, qui doit être passé en référence. La ligne qui sera lue est déterminée par les deux paramètres how et rownumber. how peut prendre les valeurs de 'Next' (suivant, valeur par défaut), 'Prev' (précédent), 'First' (premier), 'Last' (dernier), 'Absolute' (position absolue). La casse de how n'est pas prise en compte. rownumber est optionnel, sauf dans le cas d''Absolute'. ovrimos_fetch_into retourne &true; ou &false;. Lit un exemple <?php$conn=ovrimos_connect("neptune", "8001", "admin", "password");if ($conn!=0) { echo "Connection établie!"; $res=ovrimos_exec($conn,"SELECT table_id, table_name FROM sys.tables"); if ($res != 0) { echo "Requête effectuée!"; if (ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; if (ovrimos_fetch_into($res, &$row)) { list ($table_id, $table_name) = $row; echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { echo "Next: erreur\n"; } } else { echo "First: erreur\n"; } ovrimos_free_result($res); } ovrimos_close($conn);}?> Cet exemple lis une ligne. ovrimos_fetch_row Lit une ligne dans un résultat Description boolean ovrimos_fetch_row int result_id int how int row_number ovrimos_fetch_row lit une ligne dans un résultat SQL. ovrimos_fetch_row lit une ligne dans un résultat. Les colonnes doivent être lues par un autre appel. Retourne &true; en cas de succ¸s et &false; sinon. Exemple de lecture de ligne <?php$conn = ovrimos_connect("remote.host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res=ovrimos_exec($conn, "select table_id, table_name from sys.tables"); if ($res != 0) { echo "Requête effectuée!"; if (ovrimos_fetch_row($res, "First")) { $table_id = ovrimos_result($res, 1); $table_name = ovrimos_result($res, 2); echo "table_id=".$table_id.", table_name=".$table_name."\n"; if (ovrimos_fetch_row($res, "Next")) { $table_id = ovrimos_result($res, "table_id"); $table_name = ovrimos_result($res, "table_name"); echo "table_id=".$table_id.", table_name=".$table_name."\n"; } else { echo "Next: erreur\n"; } } else { echo "First: erreur\n"; } ovrimos_free_result($res); } ovrimos_close($conn);}?> Cet exemple lit une ligne et l'affiche. ovrimos_result Lit le contenu d'une colonne Description int ovrimos_result int result_id mixed field ovrimos_result sert à lire le contenu de l;a colonne field dans le rˇsultat result_id. ovrimos_result lit le contenu de la colonne field dans le résultat result_id. field peut être le nom de la colonne (une chaîne) ou bien le numéro de la colonne (la première colonne est alors 1). ovrimos_result_all Affiche un résultat sous forme de table HTML Description boolean ovrimos_result_all int result_id string format ovrimos_result_all sert à afficher tout le résultat d'une requête. ovrimos_result_all affiche le résultat de la requête représentée par result_id. ovrimos_result_all retourne &true; ou &false;. Prépare une requête, l'éxécute, et affiche le résultat <?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_prepare($conn, "select table_id, table_name from sys.tables where table_id = 7"); if ($res != 0) { echo "Préparation faite!"; if (ovrimos_execute($res, array(3))) { echo "Exécution réussie!\n"; ovrimos_result_all($res); } else { echo "Exécution manquée!"; } ovrimos_free_result($res); } else { echo "Préparation manquée!\n"; } ovrimos_close($conn);}?> Cet exemple exécute une requête SQL et affiche le résultat sous forme d'une table HTML. <function>ovrimos_result_all</function> avec meta-information <?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_exec($conn, "select table_id, table_name from sys.tables where table_id = 1") if ($res != 0) { echo "Requête effectuée! cursor=".ovrimos_cursor($res)."\n"; $colnb = ovrimos_num_fields($res); echo "Output columns=".$colnb."\n"; for ($i=1; $i<=$colnb; $i++) { $name = ovrimos_field_name($res, $i); $type = ovrimos_field_type($res, $i); $len = ovrimos_field_len($res, $i); echo "Colonne ".$i." nom=".$name." type=".$type." longueur=".$len."\n"; } ovrimos_result_all($res); ovrimos_free_result($res); } ovrimos_close($conn);}?> Exemple avec <function>ovrimos_result_all</function> <?php$conn = ovrimos_connect("db_host", "8001", "admin", "password");if ($conn != 0) { echo "Connection établie!"; $res = ovrimos_exec($conn, "update test set i=5"); if ($res != 0) { echo "Requête effectuée!"; echo ovrimos_num_rows($res)." lignes affectées\n"; ovrimos_free_result($res); } ovrimos_close($conn);}?> ovrimos_num_rows Retourne le nombre de lignes affectées par une modification Description int ovrimos_num_rows int result_id ovrimos_num_rows retourne le nombre de lignes affectées par une modification ovrimos_num_fields Retourne le nombre de colonnes Description int ovrimos_num_fields int result_id ovrimos_num_fields indique le nombre de colonnes du résultat result_id. ovrimos_field_name Retourne le nom d'une colonne Description int ovrimos_field_name int result_id int field_number ovrimos_field_name sert à obtenir le nom d'une colonne. ovrimos_field_name retourne le nom d'une colonne à partir de son numéro de colonne field_number, (la première colonne est à 1). ovrimos_field_type Retourne le type numérique d'une colonne Description int ovrimos_field_type int result_id int field_number ovrimos_field_type sert à connaître le type numérique d'une colonne. ovrimos_field_type retourne le type numérique d'une colonne, identifiée par son numéro field_number dans le résultat field_number. ovrimos_field_len Retourne la taille d'une colonne Description int ovrimos_field_len int result_id int field_number ovrimos_field_len sert à connaître la taille d'une colonne. ovrimos_field_len retourne la taille de la colonne field_number, dans le résultat field_number. ovrimos_field_num Retourne le numéro de colonne Description int ovrimos_field_num int result_id string field_name ovrimos_field_num sert à connaître le nuémro de colonne, à partir de son nom. ovrimos_field_num retourne le numéro de la colonne field_name (la numérotation commence à 1), dans result_id. ovrimos_free_result Libère les ressources utilisées par un résultat Description int ovrimos_free_result int result_id ovrimos_free_result sert à effacer un résultat. ovrimos_free_result libère toutes les ressources prises par le résultat result_id. ovrimos_free_result retourne &true;. ovrimos_commit Valide une transaction Description int ovrimos_commit int connection_id ovrimos_commit sert à exécuter une transaction. ovrimos_commit exécute la transaction préparée sur la connexion connection_id. ovrimos_rollback Annule une transaction Description int ovrimos_rollback int connection_id ovrimos_rollback sert à annuler une transaction. ovrimos_rollback annule la transaction préparée sur la connexion connection_id. \ No newline at end of file Index: phpdoc/fr/functions/mysql.xml diff -u phpdoc/fr/functions/mysql.xml:1.17 phpdoc/fr/functions/mysql.xml:1.18 --- phpdoc/fr/functions/mysql.xml:1.17 Sat Jul 7 18:22:16 2001 +++ phpdoc/fr/functions/mysql.xml Mon Nov 12 18:37:22 2001 @@ -1,1632 +1 @@ - - MySQL - MySQL - - - Ces fonctions vous permettent d'accéder aux bases de données MySQL. - Afin de pouvoir les utiliser, vous devez compiler PHP avec le support - MySQL, en utilisant l'option . - Si vous utilisez cette fonction sans préciser le chemin - d'accès à la base MySQL, PHP utilisera les librairies cliente MySQL - fournies en standard. Les utilisateurs qui font tourner d'autres - applications qui utilisent elles-mêmes MySQL (par exemple, PHP 3 et - PHP 4 utilisés comme des modules concurents apache, ou encore - auth-mysql), devrait toujours spécifier le chemin jusqu'à MySQL : - . - Cela va forcer PHP à utiliser les librairies clientes installées par - MySQL et évitera les conflits. - - - Plus d'informations sont disponibles à - http://www.mysql.com/. - - - La documentation de MySQL est disponibles à &url.mysql.docs;, ainsi qu'en français - chez nexen. - - - - - mysql_affected_rows - - Retourne le nombre de lignes affectées lors de la dernière - requête SQL. - - - - Description - - int mysql_affected_rows - resource - - link_identifier - - - - - mysql_affected_rows retourne le nombre de lignes affectées - lors de la dernière requête INSERT, UPDATE ou DELETE sur le serveur - associé à l'identifiant de connexion. Si cet identifiant n'est pas - précisé, mysql_affected_rows utilise la - dernière connexion ouverte. - - - - Si vous utilisez les transactions, vous devez appeler - mysql_affected_rows après votre INSERT, - UPDATE, ou DELETE et non après la validation. - - - - Si la dernière requête était un DELETE sans clause WHERE, tous - les enregistrements ont été effacés, mais - mysql_affected_rows va retourner 0. - - - mysql_affected_rows n'est pas possible après un - SELECT, car elle ne fonctionne qu'après des commandes qui modifient - les enregistrements. Pour connaître le nombre de lignes - retournées par un SELECT, utilisez mysql_num_rows. - - - Si la dernière requête a échoué, - mysql_affected_rows retourne -1. - - - - - - mysql_change_user - - Change le nom de session de l'utilisateur actif. - - - - Description - - int mysql_change_user - string user - string password - string - - database - - - resource - - link_identifier - - - - - mysql_change_user change l'utilisateur en cours de la session - active, ou sur la connexion spécifiée avec l'option - link_identifier. - Si une base est spécifiée, elle deviendra la base par - défaut de l'utilisateur. Si une erreur de connexion survient, - la connexion en cours restera active. - - - - mysql_change_user a été introduite - en PHP 3.0.13 et requiert MySQL 3.23.3 ou plus récent. - - - - - - mysql_close - Ferme la connexion MySQL. - - - Description - - bool mysql_close - resource - - link_identifier - - - - - mysql_close retourne &true; en cas - de succès et &false; sinon. - - - mysql_close ferme la connexion au serveur MySQL - associée à l'identifiant link_identifier. - Si cet identifiant n'est pas spécifié, cette commande s'applique - à la dernière connexion ouverte. - - - - Notez que cette commande n'es