cvs: phpdoc-fr /reference/sesam reference.xml /reference/sesam/functions sesam-affected-rows.xml sesam-commit.xml sesam-connect.xml
sesam-diagnostic.xml sesam-disconnect.xml sesam-errormsg.xml sesam-execimm.xml sesam-fetch-array.xml sesam-fetch-result.xml sesam-fetch-row.xml
sesam-field-array.xml sesam-free-result.xml sesam-num-fields.xml sesam-query.xml sesam-rollback.xml sesam-settransaction.xml
| From: | Damien Seguy | Date: | Fri, 18 Apr 2003 14:46:33 +0000 |
| Subject: | cvs: phpdoc-fr /reference/sesam reference.xml /reference/sesam/functions sesam-affected-rows.xml sesam-commit.xml sesam-connect.xml sesam-diagnostic.xml sesam-disconnect.xml sesam-errormsg.xml sesam-execimm.xml sesam-fetch-array.xml sesam-fetch-result.xml sesam-fetch-row.xml sesam-field-array.xml sesam-free-result.xml sesam-num-fields.xml sesam-query.xml sesam-rollback.xml sesam-settransaction.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-288@lists.php.net to get a copy of this message | ||
dams Fri Apr 18 10:46:33 2003 EDT
Modified files:
/phpdoc-fr/reference/sesam reference.xml
/phpdoc-fr/reference/sesam/functions sesam-affected-rows.xml
sesam-commit.xml
sesam-connect.xml
sesam-diagnostic.xml
sesam-disconnect.xml
sesam-errormsg.xml
sesam-execimm.xml
sesam-fetch-array.xml
sesam-fetch-result.xml
sesam-fetch-row.xml
sesam-field-array.xml
sesam-free-result.xml
sesam-num-fields.xml
sesam-query.xml
sesam-rollback.xml
sesam-settransaction.xml
Log:
update for links
Index: phpdoc-fr/reference/sesam/reference.xml diff -u phpdoc-fr/reference/sesam/reference.xml:1.3 phpdoc-fr/reference/sesam/reference.xml:1.4 --- phpdoc-fr/reference/sesam/reference.xml:1.3 Sun Apr 13 09:27:15 2003 +++ phpdoc-fr/reference/sesam/reference.xml Fri Apr 18 10:46:32 2003 @@ -2,7 +2,10 @@ <reference id="ref.sesam"> <title>SESAM</title> <titleabbrev>SESAM</titleabbrev> + <partintro> + <section id="sesam.intro"> + &reftitle.intro; <para> SESAM/SQL-Server est une base de données mainframe, développée par Fujitsu Siemens Computers, Allemagne. Elle fonctionne sur les @@ -213,7 +216,7 @@ Lorsque vous utilisez les curseurs à défilement, le curseur peut être positionné librement dans le résultat. Pour chaque requête à défilement, il existe des valeurs globales de - types de défilement (initialisée à :<literal>SESAM_SEEK_NEXT</literal>) + types de défilement (initialisée à : <constant>SESAM_SEEK_NEXT</constant>) et la position peut être fixée une seule fois par <function>sesam_seek_row</function> ou bien à chaque appel, avec la fonction <function>sesam_fetch_row</function>. Lorsque @@ -271,7 +274,7 @@ <literal>SESAM_SEEK_RELATIVE</literal> </entry> <entry> - aucune. conserve les valeurs globales par défaut de + aucune. Conserve les valeurs globales par défaut de position, ce qui permet, par exemple de lire toutes les 10 lignes, en arrière. </entry> @@ -281,10 +284,11 @@ </table> </para> </note> - <note> - <title> - Porting note - </title> + </section> + + <section id="sesam.porting-note"> + <title>Portage</title> + <para> En PHP, il est naturel de commencer les index à zéro (plutôt que 1), et quelques adaptations ont été faite pour l'interface @@ -299,8 +303,9 @@ c'est nécessaire, la description d'une fonction PHP SESAM indique que l'index du tableau commence à 0. </para> - </note> - <note> + </section> + + <section id="sesam.security"> <title>Sécurité</title> <para> Lorsque vous autorisez l'accès à une base de données SESAM, le @@ -312,8 +317,9 @@ scripts PHP qui doivent administrer la base en utilisant un mot de passe et/ou une sécurisation SSL. </para> - </note> - <note> + </section> + + <section id="sesam.migration"> <title>Migration d'une autre base SQL</title> <para> Deux langage SQL ne sont jamais 100% compatibles. Lorsque vous portez @@ -414,11 +420,10 @@ </listitem> </itemizedlist> </para> - </note> - <note> - <title> - Notes sur l'utilisation de types SQL divers - </title> + </section> + + <section id="sesam.sql-types"> + <title>Notes sur l'utilisation de types SQL divers</title> <para> SESAM ne supporte pas le type BLOB. Une future version de SESAM devra le faire. @@ -463,8 +468,9 @@ l'utilisateur sur l'apparence des champs que si les champs vides étaient représenté par des chaînes vides). </para> - </note> - <note> + </section> + + <section id="sesam.multiple-fields"> <title>Support des "champs multiples" de SESAM</title> <para> La fonctionnalité spéciale des "champs multiples" de SESAM permet @@ -473,19 +479,22 @@ <example> <title>Création d'une colonne de champs multiples</title> <programlisting role="sesam"> -CREATE TABLE multi_field_test -( - pkey CHAR(20) PRIMARY KEY, - multi(3) CHAR(12) +<![CDATA[ +CREATE TABLE multi_field_test ( + pkey CHAR(20) PRIMARY KEY, + multi(3) CHAR(12) ) +]]> </programlisting> </example> et peut être remplie avec : <example> <title>Affectation d'une colonne de type "champs multiple"</title> <programlisting role="sesam"> -INSERT INTO multi_field_test ( pkey, multi(2..3) ) - VALUES ( 'Second', <'first_val','second_val>) +<![CDATA[ +INSERT INTO multi_field_test (pkey, multi(2..3) ) + VALUES ('Second', <'first_val', 'second_val'>) +]]> </programlisting> </example> Notez que (comme c'est le cas ci-dessus), les sous-champs vides @@ -498,13 +507,17 @@ Dans l'exemple ci-dessu, "pkey" prend l'index 0, et les trois colonnes "multi(1..3)" sont accessibles depuis les index 1 à 3. </para> - </note> - <para> + </section> + + <section id="sesam.seealso"> + &reftitle.seealso; + <para> Pour de plus amples détails sur SESAM, reportez vous à la documentation <ulink url="&url.sesam.en;">SESAM/SQL-Server</ulink> en anglais ou <ulink url="&url.sesam.de;">SESAM/SQL-Server</ulink> en allemand, disponibles toutes deux en ligne, ou en manuels. - </para> + </para> + </section> </partintro> &reference.sesam.functions; Index: phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml:1.1 Sun Apr 14 20:38:05 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml Fri Apr 18 10:46:33 2003 @@ -26,21 +26,24 @@ car SESAM ne fournit aucune information de nombre de lignes affectées pour les requêtes de selection. </para> - <para> - Voir aussi : <function>sesam_query</function> et - <function>sesam_execimm</function> - </para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $result = sesam_execimm ("DELETE FROM PHONE WHERE LASTNAME = '".strtoupper($name)."'"); if (! $result) { ... error ... } print sesam_affected_rows($result)." entries with last name ".$name." deleted.\n"; -?> +?> +]]> </programlisting> </informalexample> + <para> + Voir aussi + <function>sesam_query</function> et + <function>sesam_execimm</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-commit.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-commit.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-commit.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-commit.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-commit.xml Fri Apr 18 10:46:33 2003 @@ -28,23 +28,26 @@ annulées par un appel implicite à <function>sesam_rollback</function>. </para> <para> - </para> - <para> - Voir aussi : <function>sesam_rollback</function>. <example> <title>Valider une transaction SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("moncatalogue", "monschema", "toto")) { - if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) - die("insertion manquée"); + if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) + die("Insertion manquée"); if (!sesam_commit()) - die("insertion réussie"); + die("Insertion réussie"); } -?> +?> +]]> </programlisting> </example> </para> + <para> + Voir aussi + <function>sesam_rollback</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-connect.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-connect.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-connect.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-connect.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-connect.xml Fri Apr 18 10:46:33 2003 @@ -47,10 +47,12 @@ <example> <title>Connexion à une base SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (! sesam_connect ("moncatalogue", "monschema", "toto") die("Impossible de se connecter à SESAM"); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml Fri Apr 18 10:46:33 2003 @@ -73,7 +73,8 @@ <example> <title>Afficher une erreur SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Fonction qui affiche un message d'erreur formaté // en affichant la position de l'erreur dans le message d'erreur function PrintReturncode($exec_str) @@ -86,11 +87,11 @@ --$colspan; if ($err["rowcount"] == 0) --$colspan; - echo "<TABLE BORDER>\n"; - echo "<TR><TH COLSPAN=".$colspan."><FONT COLOR=red>ERROR:</FONT> ". - htmlspecialchars($err["errmsg"])."</TH></TR>\n"; - if ($err["errcol"] >= 0) { - echo "<TR><TD COLSPAN=".$colspan."><PRE>\n"; + echo "<TABLE BORDER>\n"; + echo "<TR><TH COLSPAN=".$colspan."><FONT COLOR=red>ERROR:</FONT> ". + htmlspecialchars($err["errmsg"])."</TH></TR>\n"; + if ($err["errcol"] >= 0) { + echo "<TR><TD COLSPAN=".$colspan."><PRE>\n"; $errstmt = $exec_str."\n"; for ($lin=0; $errstmt != ""; ++$lin) { if ($lin != $err["errlin"]) { // $lin is less or greater than errlin @@ -106,27 +107,27 @@ $i = ""; $line = substr($errstmt, 0, strlen($errstmt)-strlen($i)+1); $errstmt = substr($i, 1); - for ($col=0; $col < $err["errcol"]; ++$col) + for ($col=0; $col < $err["errcol"]; ++$col) echo (substr($line, $col, 1) == "\t") ? "\t" : "."; - echo "<FONT COLOR=RED><BLINK>\\</BLINK></FONT>\n"; - print "<FONT COLOR=\"#880000\">".htmlspecialchars($line)."</FONT>"; - for ($col=0; $col < $err["errcol"]; ++$col) + echo "<FONT COLOR=RED><BLINK>\\</BLINK></FONT>\n"; + print "<FONT COLOR=\"#880000\">".htmlspecialchars($line)."</FONT>"; + for ($col=0; $col < $err["errcol"]; ++$col) echo (substr($line, $col, 1) == "\t") ? "\t" : "."; - echo "<FONT COLOR=RED><BLINK>/</BLINK></FONT>\n"; + echo "<FONT COLOR=RED><BLINK>/</BLINK></FONT>\n"; } } - echo "</PRE></TD></TR>\n"; + echo "</PRE></TD></TR>\n"; } - echo "<TR>\n"; - echo " <TD>sqlstate=" . $err["sqlstate"] . "</TD>\n"; + echo "<TR>\n"; + echo " <TD>sqlstate=" . $err["sqlstate"] . "</TD>\n"; if ($err["errlin"] != -1) - echo " <TD>errlin=" . $err["errlin"] . "</TD>\n"; + echo " <TD>errlin=" . $err["errlin"] . "</TD>\n"; if ($err["errcol"] != -1) - echo " <TD>errcol=" . $err["errcol"] . "</TD>\n"; + echo " <TD>errcol=" . $err["errcol"] . "</TD>\n"; if ($err["rowcount"] != 0) - echo " <TD>rowcount=" . $err["rowcount"] . "</TD>\n"; - echo "</TR>\n"; - echo "</TABLE>\n"; + echo " <TD>rowcount=" . $err["rowcount"] . "</TD>\n"; + echo "</TR>\n"; + echo "</TABLE>\n"; } if (!sesam_connect("moncatalogue", "phoneno", "toto")) die("cannot connect"); @@ -135,12 +136,14 @@ " ORDER BY FIRSTNAME"; if (! ($result = sesam_query($stmt))) PrintReturncode($stmt); -?> +?> +]]> </programlisting> </example> </para> <para> - Voir aussi : <function>sesam_errormsg</function> pour un accès + Voir aussi + <function>sesam_errormsg</function> pour un accès simplifié aux messages d'erreur. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml Fri Apr 18 10:46:33 2003 @@ -34,18 +34,24 @@ que les prochains appels à des fonctions SESAM échouent. </para> <para> - Voir aussi : <function>sesam_connect</function>. <example> <title>Déconnexion d'une base SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("moncatalogue", "monschema", "toto")) { -... quelques requêtes et d'autres trucs ... + //... quelques requêtes et d'autres trucs ... +} sesam_disconnect(); } -?> +?> +]]> </programlisting> </example> + </para> + <para> + Voir aussi + <function>sesam_connect</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml Fri Apr 18 10:46:33 2003 @@ -18,14 +18,17 @@ </para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (!sesam_execimm($stmt)) - printf("%s<br>\n", sesam_errormsg()); -?> + printf("%s<BR>\n", sesam_errormsg()); +?> +]]> </programlisting> </informalexample> <para> - Voir aussi : <function>sesam_diagnostic</function> pour la liste + Voir aussi + <function>sesam_diagnostic</function> pour la liste complète des états de requêtes SQL. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-execimm.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-execimm.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-execimm.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-execimm.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-execimm.xml Fri Apr 18 10:46:33 2003 @@ -43,14 +43,16 @@ <para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $stmt = "INSERT INTO matable VALUES('un', 'deux')"; $result = sesam_execimm ($stmt); $err = sesam_diagnostic(); print("sqlstate = ".$err["sqlstate"]."\n". "Nombre de lignes affectées = ".$err["rowcount"]." == ". sesam_affected_rows($result)."\n"); -?> +?> +]]> </programlisting> </informalexample> Voir aussi : <function>sesam_query</function> et Index: phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml Fri Apr 18 10:46:33 2003 @@ -45,16 +45,20 @@ sont convertis en minuscules. </para> <para> - Les colonnes sans noms (par exemple, les résultats d'opérations + Les colonnes sans nom (par exemple, les résultats d'opérations arithmétiques) et les champs vides ne sont pas stockés dans ce tableau. De plus, si deux colonnes ont le même noms, la dernière colonne écrasera la précédente. Dans cette situation, utilisez de préférence <function>sesam_fetch_row</function> ou bien, faîtes un alias de la colonne. - <informalexample> + <example> + <title>Alias de colonnes avec SESAM</title> <programlisting role="sesam"> +<![CDATA[ SELECT TBL1.COL AS FOO, TBL2.COL AS BAR FROM TBL1, TBL2</programlisting> - </informalexample> +]]> + </programlisting> + </example> </para> <para> Une gestion spéciale permet de lire les champs multiples, qui @@ -64,7 +68,9 @@ indices sont numérotés à partir de 1. <informalexample> <programlisting role="sesam"> +<![CDATA[ CREATE TABLE ... ( ... MULTI(3) INT ) +]]> </programlisting> </informalexample> Les index associatifs utilisé pour les valeurs individuelles @@ -80,29 +86,32 @@ <example> <title>Exemple avec <function>sesam_fetch_array</function></title> <programlisting role="php"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 1); +<![CDATA[ +<?php +$result = sesam_query ("SELECT * FROM phone\n". + " WHERE LASTNAME='".strtoupper($name)."'\n". + " ORDER BY FIRSTNAME", 1); if (! $result) { ... error ... } // Affiche la table -print "<TABLE BORDER>\n"; -while (($row = sesam_fetch_array ($result)) && count($row) > 0) { - print " <TR>\n"; - print " <TD>".htmlspecialchars($row["firstname"])."</TD>\n"; - print " <TD>".htmlspecialchars($row["lastname"])."</TD>\n"; - print " <TD>".htmlspecialchars($row["phoneno"])."</TD>\n"; - print " </TR>\n"; +print "<TABLE BORDER>\n"; +while (($row = sesam_fetch_array ($result)) && count($row) > 0) { + print " <TR>\n"; + print " <TD>".htmlspecialchars($row["firstname"])."</TD>\n"; + print " <TD>".htmlspecialchars($row["lastname"])."</TD>\n"; + print " <TD>".htmlspecialchars($row["phoneno"])."</TD>\n"; + print " </TR>\n"; } -print "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </programlisting> </example> <para> - Voir aussi : <function>sesam_fetch_row</function> qui retourne + Voir aussi + <function>sesam_fetch_row</function> qui retourne un tableau numérique. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml Fri Apr 18 10:46:33 2003 @@ -80,9 +80,11 @@ pas toute la mémoire disponible. </para> <para> - Voir aussi : <function>sesam_fetch_row</function>, et + Voir aussi + <function>sesam_fetch_row</function> et <function>sesam_field_array</function> pour vérifier les - champs multiples. Voyez <function>sesam_query</function> pour une + champs multiples. + Voyez <function>sesam_query</function> pour un exemple complet avec <function>sesam_fetch_result</function>. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml Fri Apr 18 10:46:33 2003 @@ -139,33 +139,37 @@ <example> <title>Exemple avec <function>sesam_fetch_row</function></title> <programlisting role="php"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 1); +<![CDATA[ +<?php +$result = sesam_query ("SELECT * FROM phone\n". + " WHERE LASTNAME='".strtoupper($name)."'\n". + " ORDER BY FIRSTNAME", 1); if (! $result) { ... erreur ... } // Affiche la table dans l'ordre inverse -print "<TABLE BORDER>\n"; +print "<TABLE BORDER>\n"; $row = sesam_fetch_row ($result, SESAM_SEEK_LAST); while (is_array($row)) { - print " <TR>\n"; - for($col = 0; $col < $row["count"]; ++$col) { - print " <TD>".htmlspecialchars($row[$col])."</TD>\n"; + print " <TR>\n"; + for($col = 0; $col < $row["count"]; ++$col) { + print " <TD>".htmlspecialchars($row[$col])."</TD>\n"; } - print " </TR>\n"; + print " </TR>\n"; // utilise la valeur implicite de SESAM_SEEK_PRIOR $row = sesam_fetch_row ($result); } -print "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </programlisting> </example> <para> - Voir aussi : <function>sesam_fetch_array</function> qui retourne un - tableau associatif, et <function>sesam_fetch_result</function> + Voir aussi + <function>sesam_fetch_array</function> qui retourne un + tableau associatif et + <function>sesam_fetch_result</function> qui retourne plusieurs lignes en même temps. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-field-array.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-field-array.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-field-array.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-field-array.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-field-array.xml Fri Apr 18 10:46:33 2003 @@ -179,7 +179,8 @@ </table> </para> <para> - Voir aussi <function>sesam_query</function>, pour un exemple + Voir aussi + <function>sesam_query</function>, pour un exemple d'utilisation de <function>sesam_field_array</function>. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-free-result.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-free-result.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-free-result.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-free-result.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-free-result.xml Fri Apr 18 10:46:33 2003 @@ -4,7 +4,7 @@ <refentry id="function.sesam-free-result"> <refnamediv> <refname>sesam_free_result</refname> - <refpurpose>Libère les ressources</refpurpose> + <refpurpose>Libère les ressources SESAM</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml Fri Apr 18 10:46:33 2003 @@ -25,7 +25,8 @@ comme trois colonne. </para> <para> - Voir aussi : <function>sesam_query</function> et + Voir aussi + <function>sesam_query</function> et <function>sesam_field_array</function> pour savoir distinguer les champs multiples des colonnes standard. </para> Index: phpdoc-fr/reference/sesam/functions/sesam-query.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-query.xml:1.2 phpdoc-fr/reference/sesam/functions/sesam-query.xml:1.3 --- phpdoc-fr/reference/sesam/functions/sesam-query.xml:1.2 Wed Aug 14 19:11:35 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-query.xml Fri Apr 18 10:46:33 2003 @@ -56,7 +56,8 @@ Liste toutes les lignes de table "phone" sous forme de table HTML </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (!sesam_connect("phonedb", "demo", "toto")) die("cannot connect"); $result = sesam_query("select * from phone"); @@ -64,42 +65,43 @@ $err = sesam_diagnostic(); die($err["errmsg"]); } -echo "<TABLE BORDER>\n"; +echo "<TABLE BORDER>\n"; // Ajoute l'entête de titre comme nom de colonne if ($cols = sesam_field_array($result)) { - echo " <TR><TH COLSPAN=".$cols["count"].">Result:</TH></TR>\n"; - echo " <TR>\n"; - for ($col = 0; $col < $cols["count"]; ++$col) { + echo " <TR><TH COLSPAN=".$cols["count"].">Result:</TH></TR>\n"; + echo " <TR>\n"; + for ($col = 0; $col < $cols["count"]; ++$col) { $colattr = $cols[$col]; /* étend les entêtes de la table au dessus des champs multiples */ - if ($colattr["count"] > 1) { - echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. - "(1..".$colattr["count"].")</TH>\n"; + if ($colattr["count"] > 1) { + echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. + "(1..".$colattr["count"].")</TH>\n"; $col += $colattr["count"] - 1; } else - echo " <TH>" . $colattr["name"] . "</TH>\n"; + echo " <TH>" . $colattr["name"] . "</TH>\n"; } - echo " </TR>\n"; + echo " </TR>\n"; } do { // Lit les résultats par bloc de 100 $ok = sesam_fetch_result($result,100); - for ($row=0; $row < $ok["rows"]; ++$row) { - echo " <TR>\n"; - for ($col = 0; $col < $ok["cols"]; ++$col) { + for ($row=0; $row < $ok["rows"]; ++$row) { + echo " <TR>\n"; + for ($col = 0; $col < $ok["cols"]; ++$col) { if (isset($ok[$col][$row])) - echo " <TD>" . $ok[$col][$row] . "</TD>\n"; + echo " <TD>" . $ok[$col][$row] . "</TD>\n"; else - echo " <TD>-empty-</TD>\n"; + echo " <TD>-empty-</TD>\n"; } - echo " </TR>\n"; + echo " </TR>\n"; } } while ($ok["truncated"]); // tant qu'il a y encore des données -echo "</TABLE>\n"; +echo "</TABLE>\n"; // libère les ressources sesam_free_result($result); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/sesam/functions/sesam-rollback.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-rollback.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-rollback.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-rollback.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-rollback.xml Fri Apr 18 10:46:33 2003 @@ -27,22 +27,27 @@ <function>sesam_rollback</function> est fait, annulant toutes les transactions non validées dans la base. </para> + <para> - Voir aussi : <function>sesam_commit</function>. <example> <title>Annulation d'une transaction SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("moncatalogue", "monschema", "toto")) { - if (sesam_execimm("INSERT INTO matable VALUES (*, 'Petit Test', <0, 8, 15>)") - && sesam_execimm("INSERT INTO autretable VALUES (*, 'Autre Test', 1)")) + if (sesam_execimm("INSERT INTO matable VALUES (*, 'Petit Test', <0, 8, 15>)") + && sesam_execimm("INSERT INTO autretable VALUES (*, 'Autre Test', 1)")) sesam_commit(); else sesam_rollback(); } -?> +?> +]]> </programlisting> </example> + </para> + <para> + Voir aussi <function>sesam_commit</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml Fri Apr 18 10:46:33 2003 @@ -50,22 +50,22 @@ <tbody> <row> <entry>1</entry> - <entry><literal>SESAM_TXISOL_READ_UNCOMMITTED</literal></entry> + <entry><constant>SESAM_TXISOL_READ_UNCOMMITTED</constant></entry> <entry>Lecture sans validation</entry> </row> <row> <entry>2</entry> - <entry><literal>SESAM_TXISOL_READ_COMMITTED</literal></entry> + <entry><constant>SESAM_TXISOL_READ_COMMITTED</constant></entry> <entry>Lecutre avec validation</entry> </row> <row> <entry>3</entry> - <entry><literal>SESAM_TXISOL_REPEATABLE_READ</literal></entry> + <entry><constant>SESAM_TXISOL_REPEATABLE_READ</constant></entry> <entry>Lecture récurente</entry> </row> <row> <entry>4</entry> - <entry><literal>SESAM_TXISOL_SERIALIZABLE</literal></entry> + <entry><constant>SESAM_TXISOL_SERIALIZABLE</constant></entry> <entry>Sérialisable</entry> </row> </tbody> @@ -86,12 +86,12 @@ <tbody> <row> <entry>0</entry> - <entry><literal>SESAM_TXREAD_READWRITE</literal></entry> + <entry><constant>SESAM_TXREAD_READWRITE</constant></entry> <entry>Lecture/écriture</entry> </row> <row> <entry>1</entry> - <entry><literal>SESAM_TXREAD_READONLY</literal></entry> + <entry><constant>SESAM_TXREAD_READONLY</constant></entry> <entry>Lecture seule</entry> </row> </tbody> @@ -101,16 +101,17 @@ <para> Les valeurs modifiées par <function>sesam_settransaction</function> remplaceront les valeurs par défaut spécifiée dans - <link linkend="ini.sesam-configfile">le fichier de configuration SESAM</link>. + le fichier de configuration SESAM. </para> <para> <example> <title>Modifier les paramètres de configuration SESAM</title> <programlisting role="php"> -<?php -sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, - SESAM_TXREAD_READONLY); -?> +<![CDATA[ +<?php + sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, SESAM_TXREAD_READONLY); +?> +]]> </programlisting> </example> </para>
Index: phpdoc-fr/reference/sesam/reference.xml diff -u phpdoc-fr/reference/sesam/reference.xml:1.3 phpdoc-fr/reference/sesam/reference.xml:1.4 --- phpdoc-fr/reference/sesam/reference.xml:1.3 Sun Apr 13 09:27:15 2003 +++ phpdoc-fr/reference/sesam/reference.xml Fri Apr 18 10:46:32 2003 @@ -2,7 +2,10 @@ <reference id="ref.sesam"> <title>SESAM</title> <titleabbrev>SESAM</titleabbrev> + <partintro> + <section id="sesam.intro"> + &reftitle.intro; <para> SESAM/SQL-Server est une base de données mainframe, développée par Fujitsu Siemens Computers, Allemagne. Elle fonctionne sur les @@ -213,7 +216,7 @@ Lorsque vous utilisez les curseurs à défilement, le curseur peut être positionné librement dans le résultat. Pour chaque requête à défilement, il existe des valeurs globales de - types de défilement (initialisée à :<literal>SESAM_SEEK_NEXT</literal>) + types de défilement (initialisée à : <constant>SESAM_SEEK_NEXT</constant>) et la position peut être fixée une seule fois par <function>sesam_seek_row</function> ou bien à chaque appel, avec la fonction <function>sesam_fetch_row</function>. Lorsque @@ -271,7 +274,7 @@ <literal>SESAM_SEEK_RELATIVE</literal> </entry> <entry> - aucune. conserve les valeurs globales par défaut de + aucune. Conserve les valeurs globales par défaut de position, ce qui permet, par exemple de lire toutes les 10 lignes, en arrière. </entry> @@ -281,10 +284,11 @@ </table> </para> </note> - <note> - <title> - Porting note - </title> + </section> + + <section id="sesam.porting-note"> + <title>Portage</title> + <para> En PHP, il est naturel de commencer les index à zéro (plutôt que 1), et quelques adaptations ont été faite pour l'interface @@ -299,8 +303,9 @@ c'est nécessaire, la description d'une fonction PHP SESAM indique que l'index du tableau commence à 0. </para> - </note> - <note> + </section> + + <section id="sesam.security"> <title>Sécurité</title> <para> Lorsque vous autorisez l'accès à une base de données SESAM, le @@ -312,8 +317,9 @@ scripts PHP qui doivent administrer la base en utilisant un mot de passe et/ou une sécurisation SSL. </para> - </note> - <note> + </section> + + <section id="sesam.migration"> <title>Migration d'une autre base SQL</title> <para> Deux langage SQL ne sont jamais 100% compatibles. Lorsque vous portez @@ -414,11 +420,10 @@ </listitem> </itemizedlist> </para> - </note> - <note> - <title> - Notes sur l'utilisation de types SQL divers - </title> + </section> + + <section id="sesam.sql-types"> + <title>Notes sur l'utilisation de types SQL divers</title> <para> SESAM ne supporte pas le type BLOB. Une future version de SESAM devra le faire. @@ -463,8 +468,9 @@ l'utilisateur sur l'apparence des champs que si les champs vides étaient représenté par des chaînes vides). </para> - </note> - <note> + </section> + + <section id="sesam.multiple-fields"> <title>Support des "champs multiples" de SESAM</title> <para> La fonctionnalité spéciale des "champs multiples" de SESAM permet @@ -473,19 +479,22 @@ <example> <title>Création d'une colonne de champs multiples</title> <programlisting role="sesam"> -CREATE TABLE multi_field_test -( - pkey CHAR(20) PRIMARY KEY, - multi(3) CHAR(12) +<![CDATA[ +CREATE TABLE multi_field_test ( + pkey CHAR(20) PRIMARY KEY, + multi(3) CHAR(12) ) +]]> </programlisting> </example> et peut être remplie avec : <example> <title>Affectation d'une colonne de type "champs multiple"</title> <programlisting role="sesam"> -INSERT INTO multi_field_test ( pkey, multi(2..3) ) - VALUES ( 'Second', <'first_val','second_val>) +<![CDATA[ +INSERT INTO multi_field_test (pkey, multi(2..3) ) + VALUES ('Second', <'first_val', 'second_val'>) +]]> </programlisting> </example> Notez que (comme c'est le cas ci-dessus), les sous-champs vides @@ -498,13 +507,17 @@ Dans l'exemple ci-dessu, "pkey" prend l'index 0, et les trois colonnes "multi(1..3)" sont accessibles depuis les index 1 à 3. </para> - </note> - <para> + </section> + + <section id="sesam.seealso"> + &reftitle.seealso; + <para> Pour de plus amples détails sur SESAM, reportez vous à la documentation <ulink url="&url.sesam.en;">SESAM/SQL-Server</ulink> en anglais ou <ulink url="&url.sesam.de;">SESAM/SQL-Server</ulink> en allemand, disponibles toutes deux en ligne, ou en manuels. - </para> + </para> + </section> </partintro> &reference.sesam.functions; Index: phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml:1.1 Sun Apr 14 20:38:05 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-affected-rows.xml Fri Apr 18 10:46:33 2003 @@ -26,21 +26,24 @@ car SESAM ne fournit aucune information de nombre de lignes affectées pour les requêtes de selection. </para> - <para> - Voir aussi : <function>sesam_query</function> et - <function>sesam_execimm</function> - </para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $result = sesam_execimm ("DELETE FROM PHONE WHERE LASTNAME = '".strtoupper($name)."'"); if (! $result) { ... error ... } print sesam_affected_rows($result)." entries with last name ".$name." deleted.\n"; -?> +?> +]]> </programlisting> </informalexample> + <para> + Voir aussi + <function>sesam_query</function> et + <function>sesam_execimm</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-commit.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-commit.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-commit.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-commit.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-commit.xml Fri Apr 18 10:46:33 2003 @@ -28,23 +28,26 @@ annulées par un appel implicite à <function>sesam_rollback</function>. </para> <para> - </para> - <para> - Voir aussi : <function>sesam_rollback</function>. <example> <title>Valider une transaction SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("moncatalogue", "monschema", "toto")) { - if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) - die("insertion manquée"); + if (!sesam_execimm("INSERT INTO mytable VALUES (*, 'Small Test', <0, 8, 15>)")) + die("Insertion manquée"); if (!sesam_commit()) - die("insertion réussie"); + die("Insertion réussie"); } -?> +?> +]]> </programlisting> </example> </para> + <para> + Voir aussi + <function>sesam_rollback</function>. + </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-connect.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-connect.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-connect.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-connect.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-connect.xml Fri Apr 18 10:46:33 2003 @@ -47,10 +47,12 @@ <example> <title>Connexion à une base SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (! sesam_connect ("moncatalogue", "monschema", "toto") die("Impossible de se connecter à SESAM"); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-diagnostic.xml Fri Apr 18 10:46:33 2003 @@ -73,7 +73,8 @@ <example> <title>Afficher une erreur SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Fonction qui affiche un message d'erreur formaté // en affichant la position de l'erreur dans le message d'erreur function PrintReturncode($exec_str) @@ -86,11 +87,11 @@ --$colspan; if ($err["rowcount"] == 0) --$colspan; - echo "<TABLE BORDER>\n"; - echo "<TR><TH COLSPAN=".$colspan."><FONT COLOR=red>ERROR:</FONT> ". - htmlspecialchars($err["errmsg"])."</TH></TR>\n"; - if ($err["errcol"] >= 0) { - echo "<TR><TD COLSPAN=".$colspan."><PRE>\n"; + echo "<TABLE BORDER>\n"; + echo "<TR><TH COLSPAN=".$colspan."><FONT COLOR=red>ERROR:</FONT> ". + htmlspecialchars($err["errmsg"])."</TH></TR>\n"; + if ($err["errcol"] >= 0) { + echo "<TR><TD COLSPAN=".$colspan."><PRE>\n"; $errstmt = $exec_str."\n"; for ($lin=0; $errstmt != ""; ++$lin) { if ($lin != $err["errlin"]) { // $lin is less or greater than errlin @@ -106,27 +107,27 @@ $i = ""; $line = substr($errstmt, 0, strlen($errstmt)-strlen($i)+1); $errstmt = substr($i, 1); - for ($col=0; $col < $err["errcol"]; ++$col) + for ($col=0; $col < $err["errcol"]; ++$col) echo (substr($line, $col, 1) == "\t") ? "\t" : "."; - echo "<FONT COLOR=RED><BLINK>\\</BLINK></FONT>\n"; - print "<FONT COLOR=\"#880000\">".htmlspecialchars($line)."</FONT>"; - for ($col=0; $col < $err["errcol"]; ++$col) + echo "<FONT COLOR=RED><BLINK>\\</BLINK></FONT>\n"; + print "<FONT COLOR=\"#880000\">".htmlspecialchars($line)."</FONT>"; + for ($col=0; $col < $err["errcol"]; ++$col) echo (substr($line, $col, 1) == "\t") ? "\t" : "."; - echo "<FONT COLOR=RED><BLINK>/</BLINK></FONT>\n"; + echo "<FONT COLOR=RED><BLINK>/</BLINK></FONT>\n"; } } - echo "</PRE></TD></TR>\n"; + echo "</PRE></TD></TR>\n"; } - echo "<TR>\n"; - echo " <TD>sqlstate=" . $err["sqlstate"] . "</TD>\n"; + echo "<TR>\n"; + echo " <TD>sqlstate=" . $err["sqlstate"] . "</TD>\n"; if ($err["errlin"] != -1) - echo " <TD>errlin=" . $err["errlin"] . "</TD>\n"; + echo " <TD>errlin=" . $err["errlin"] . "</TD>\n"; if ($err["errcol"] != -1) - echo " <TD>errcol=" . $err["errcol"] . "</TD>\n"; + echo " <TD>errcol=" . $err["errcol"] . "</TD>\n"; if ($err["rowcount"] != 0) - echo " <TD>rowcount=" . $err["rowcount"] . "</TD>\n"; - echo "</TR>\n"; - echo "</TABLE>\n"; + echo " <TD>rowcount=" . $err["rowcount"] . "</TD>\n"; + echo "</TR>\n"; + echo "</TABLE>\n"; } if (!sesam_connect("moncatalogue", "phoneno", "toto")) die("cannot connect"); @@ -135,12 +136,14 @@ " ORDER BY FIRSTNAME"; if (! ($result = sesam_query($stmt))) PrintReturncode($stmt); -?> +?> +]]> </programlisting> </example> </para> <para> - Voir aussi : <function>sesam_errormsg</function> pour un accès + Voir aussi + <function>sesam_errormsg</function> pour un accès simplifié aux messages d'erreur. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-disconnect.xml Fri Apr 18 10:46:33 2003 @@ -34,18 +34,24 @@ que les prochains appels à des fonctions SESAM échouent. </para> <para> - Voir aussi : <function>sesam_connect</function>. <example> <title>Déconnexion d'une base SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("moncatalogue", "monschema", "toto")) { -... quelques requêtes et d'autres trucs ... + //... quelques requêtes et d'autres trucs ... +} sesam_disconnect(); } -?> +?> +]]> </programlisting> </example> + </para> + <para> + Voir aussi + <function>sesam_connect</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml:1.1 Sun Apr 14 20:38:06 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-errormsg.xml Fri Apr 18 10:46:33 2003 @@ -18,14 +18,17 @@ </para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (!sesam_execimm($stmt)) - printf("%s<br>\n", sesam_errormsg()); -?> + printf("%s<BR>\n", sesam_errormsg()); +?> +]]> </programlisting> </informalexample> <para> - Voir aussi : <function>sesam_diagnostic</function> pour la liste + Voir aussi + <function>sesam_diagnostic</function> pour la liste complète des états de requêtes SQL. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-execimm.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-execimm.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-execimm.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-execimm.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-execimm.xml Fri Apr 18 10:46:33 2003 @@ -43,14 +43,16 @@ <para> <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php $stmt = "INSERT INTO matable VALUES('un', 'deux')"; $result = sesam_execimm ($stmt); $err = sesam_diagnostic(); print("sqlstate = ".$err["sqlstate"]."\n". "Nombre de lignes affectées = ".$err["rowcount"]." == ". sesam_affected_rows($result)."\n"); -?> +?> +]]> </programlisting> </informalexample> Voir aussi : <function>sesam_query</function> et Index: phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-fetch-array.xml Fri Apr 18 10:46:33 2003 @@ -45,16 +45,20 @@ sont convertis en minuscules. </para> <para> - Les colonnes sans noms (par exemple, les résultats d'opérations + Les colonnes sans nom (par exemple, les résultats d'opérations arithmétiques) et les champs vides ne sont pas stockés dans ce tableau. De plus, si deux colonnes ont le même noms, la dernière colonne écrasera la précédente. Dans cette situation, utilisez de préférence <function>sesam_fetch_row</function> ou bien, faîtes un alias de la colonne. - <informalexample> + <example> + <title>Alias de colonnes avec SESAM</title> <programlisting role="sesam"> +<![CDATA[ SELECT TBL1.COL AS FOO, TBL2.COL AS BAR FROM TBL1, TBL2</programlisting> - </informalexample> +]]> + </programlisting> + </example> </para> <para> Une gestion spéciale permet de lire les champs multiples, qui @@ -64,7 +68,9 @@ indices sont numérotés à partir de 1. <informalexample> <programlisting role="sesam"> +<![CDATA[ CREATE TABLE ... ( ... MULTI(3) INT ) +]]> </programlisting> </informalexample> Les index associatifs utilisé pour les valeurs individuelles @@ -80,29 +86,32 @@ <example> <title>Exemple avec <function>sesam_fetch_array</function></title> <programlisting role="php"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 1); +<![CDATA[ +<?php +$result = sesam_query ("SELECT * FROM phone\n". + " WHERE LASTNAME='".strtoupper($name)."'\n". + " ORDER BY FIRSTNAME", 1); if (! $result) { ... error ... } // Affiche la table -print "<TABLE BORDER>\n"; -while (($row = sesam_fetch_array ($result)) && count($row) > 0) { - print " <TR>\n"; - print " <TD>".htmlspecialchars($row["firstname"])."</TD>\n"; - print " <TD>".htmlspecialchars($row["lastname"])."</TD>\n"; - print " <TD>".htmlspecialchars($row["phoneno"])."</TD>\n"; - print " </TR>\n"; +print "<TABLE BORDER>\n"; +while (($row = sesam_fetch_array ($result)) && count($row) > 0) { + print " <TR>\n"; + print " <TD>".htmlspecialchars($row["firstname"])."</TD>\n"; + print " <TD>".htmlspecialchars($row["lastname"])."</TD>\n"; + print " <TD>".htmlspecialchars($row["phoneno"])."</TD>\n"; + print " </TR>\n"; } -print "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </programlisting> </example> <para> - Voir aussi : <function>sesam_fetch_row</function> qui retourne + Voir aussi + <function>sesam_fetch_row</function> qui retourne un tableau numérique. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-fetch-result.xml Fri Apr 18 10:46:33 2003 @@ -80,9 +80,11 @@ pas toute la mémoire disponible. </para> <para> - Voir aussi : <function>sesam_fetch_row</function>, et + Voir aussi + <function>sesam_fetch_row</function> et <function>sesam_field_array</function> pour vérifier les - champs multiples. Voyez <function>sesam_query</function> pour une + champs multiples. + Voyez <function>sesam_query</function> pour un exemple complet avec <function>sesam_fetch_result</function>. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml:1.1 Sun Apr 14 20:38:07 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-fetch-row.xml Fri Apr 18 10:46:33 2003 @@ -139,33 +139,37 @@ <example> <title>Exemple avec <function>sesam_fetch_row</function></title> <programlisting role="php"> -<?php -$result = sesam_query ("SELECT * FROM phone\n". - " WHERE LASTNAME='".strtoupper($name)."'\n". - " ORDER BY FIRSTNAME", 1); +<![CDATA[ +<?php +$result = sesam_query ("SELECT * FROM phone\n". + " WHERE LASTNAME='".strtoupper($name)."'\n". + " ORDER BY FIRSTNAME", 1); if (! $result) { ... erreur ... } // Affiche la table dans l'ordre inverse -print "<TABLE BORDER>\n"; +print "<TABLE BORDER>\n"; $row = sesam_fetch_row ($result, SESAM_SEEK_LAST); while (is_array($row)) { - print " <TR>\n"; - for($col = 0; $col < $row["count"]; ++$col) { - print " <TD>".htmlspecialchars($row[$col])."</TD>\n"; + print " <TR>\n"; + for($col = 0; $col < $row["count"]; ++$col) { + print " <TD>".htmlspecialchars($row[$col])."</TD>\n"; } - print " </TR>\n"; + print " </TR>\n"; // utilise la valeur implicite de SESAM_SEEK_PRIOR $row = sesam_fetch_row ($result); } -print "</TABLE>\n"; +print "</TABLE>\n"; sesam_free_result ($result); -?> +?> +]]> </programlisting> </example> <para> - Voir aussi : <function>sesam_fetch_array</function> qui retourne un - tableau associatif, et <function>sesam_fetch_result</function> + Voir aussi + <function>sesam_fetch_array</function> qui retourne un + tableau associatif et + <function>sesam_fetch_result</function> qui retourne plusieurs lignes en même temps. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-field-array.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-field-array.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-field-array.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-field-array.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-field-array.xml Fri Apr 18 10:46:33 2003 @@ -179,7 +179,8 @@ </table> </para> <para> - Voir aussi <function>sesam_query</function>, pour un exemple + Voir aussi + <function>sesam_query</function>, pour un exemple d'utilisation de <function>sesam_field_array</function>. </para> </refsect1> Index: phpdoc-fr/reference/sesam/functions/sesam-free-result.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-free-result.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-free-result.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-free-result.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-free-result.xml Fri Apr 18 10:46:33 2003 @@ -4,7 +4,7 @@ <refentry id="function.sesam-free-result"> <refnamediv> <refname>sesam_free_result</refname> - <refpurpose>Libère les ressources</refpurpose> + <refpurpose>Libère les ressources SESAM</refpurpose> </refnamediv> <refsect1> <title>Description</title> Index: phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-num-fields.xml Fri Apr 18 10:46:33 2003 @@ -25,7 +25,8 @@ comme trois colonne. </para> <para> - Voir aussi : <function>sesam_query</function> et + Voir aussi + <function>sesam_query</function> et <function>sesam_field_array</function> pour savoir distinguer les champs multiples des colonnes standard. </para> Index: phpdoc-fr/reference/sesam/functions/sesam-query.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-query.xml:1.2 phpdoc-fr/reference/sesam/functions/sesam-query.xml:1.3 --- phpdoc-fr/reference/sesam/functions/sesam-query.xml:1.2 Wed Aug 14 19:11:35 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-query.xml Fri Apr 18 10:46:33 2003 @@ -56,7 +56,8 @@ Liste toutes les lignes de table "phone" sous forme de table HTML </title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (!sesam_connect("phonedb", "demo", "toto")) die("cannot connect"); $result = sesam_query("select * from phone"); @@ -64,42 +65,43 @@ $err = sesam_diagnostic(); die($err["errmsg"]); } -echo "<TABLE BORDER>\n"; +echo "<TABLE BORDER>\n"; // Ajoute l'entête de titre comme nom de colonne if ($cols = sesam_field_array($result)) { - echo " <TR><TH COLSPAN=".$cols["count"].">Result:</TH></TR>\n"; - echo " <TR>\n"; - for ($col = 0; $col < $cols["count"]; ++$col) { + echo " <TR><TH COLSPAN=".$cols["count"].">Result:</TH></TR>\n"; + echo " <TR>\n"; + for ($col = 0; $col < $cols["count"]; ++$col) { $colattr = $cols[$col]; /* étend les entêtes de la table au dessus des champs multiples */ - if ($colattr["count"] > 1) { - echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. - "(1..".$colattr["count"].")</TH>\n"; + if ($colattr["count"] > 1) { + echo " <TH COLSPAN=".$colattr["count"].">".$colattr["name"]. + "(1..".$colattr["count"].")</TH>\n"; $col += $colattr["count"] - 1; } else - echo " <TH>" . $colattr["name"] . "</TH>\n"; + echo " <TH>" . $colattr["name"] . "</TH>\n"; } - echo " </TR>\n"; + echo " </TR>\n"; } do { // Lit les résultats par bloc de 100 $ok = sesam_fetch_result($result,100); - for ($row=0; $row < $ok["rows"]; ++$row) { - echo " <TR>\n"; - for ($col = 0; $col < $ok["cols"]; ++$col) { + for ($row=0; $row < $ok["rows"]; ++$row) { + echo " <TR>\n"; + for ($col = 0; $col < $ok["cols"]; ++$col) { if (isset($ok[$col][$row])) - echo " <TD>" . $ok[$col][$row] . "</TD>\n"; + echo " <TD>" . $ok[$col][$row] . "</TD>\n"; else - echo " <TD>-empty-</TD>\n"; + echo " <TD>-empty-</TD>\n"; } - echo " </TR>\n"; + echo " </TR>\n"; } } while ($ok["truncated"]); // tant qu'il a y encore des données -echo "</TABLE>\n"; +echo "</TABLE>\n"; // libère les ressources sesam_free_result($result); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/sesam/functions/sesam-rollback.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-rollback.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-rollback.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-rollback.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-rollback.xml Fri Apr 18 10:46:33 2003 @@ -27,22 +27,27 @@ <function>sesam_rollback</function> est fait, annulant toutes les transactions non validées dans la base. </para> + <para> - Voir aussi : <function>sesam_commit</function>. <example> <title>Annulation d'une transaction SESAM</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (sesam_connect ("moncatalogue", "monschema", "toto")) { - if (sesam_execimm("INSERT INTO matable VALUES (*, 'Petit Test', <0, 8, 15>)") - && sesam_execimm("INSERT INTO autretable VALUES (*, 'Autre Test', 1)")) + if (sesam_execimm("INSERT INTO matable VALUES (*, 'Petit Test', <0, 8, 15>)") + && sesam_execimm("INSERT INTO autretable VALUES (*, 'Autre Test', 1)")) sesam_commit(); else sesam_rollback(); } -?> +?> +]]> </programlisting> </example> + </para> + <para> + Voir aussi <function>sesam_commit</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml diff -u phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml:1.1 phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml:1.2 --- phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml:1.1 Sun Apr 14 20:38:08 2002 +++ phpdoc-fr/reference/sesam/functions/sesam-settransaction.xml Fri Apr 18 10:46:33 2003 @@ -50,22 +50,22 @@ <tbody> <row> <entry>1</entry> - <entry><literal>SESAM_TXISOL_READ_UNCOMMITTED</literal></entry> + <entry><constant>SESAM_TXISOL_READ_UNCOMMITTED</constant></entry> <entry>Lecture sans validation</entry> </row> <row> <entry>2</entry> - <entry><literal>SESAM_TXISOL_READ_COMMITTED</literal></entry> + <entry><constant>SESAM_TXISOL_READ_COMMITTED</constant></entry> <entry>Lecutre avec validation</entry> </row> <row> <entry>3</entry> - <entry><literal>SESAM_TXISOL_REPEATABLE_READ</literal></entry> + <entry><constant>SESAM_TXISOL_REPEATABLE_READ</constant></entry> <entry>Lecture récurente</entry> </row> <row> <entry>4</entry> - <entry><literal>SESAM_TXISOL_SERIALIZABLE</literal></entry> + <entry><constant>SESAM_TXISOL_SERIALIZABLE</constant></entry> <entry>Sérialisable</entry> </row> </tbody> @@ -86,12 +86,12 @@ <tbody> <row> <entry>0</entry> - <entry><literal>SESAM_TXREAD_READWRITE</literal></entry> + <entry><constant>SESAM_TXREAD_READWRITE</constant></entry> <entry>Lecture/écriture</entry> </row> <row> <entry>1</entry> - <entry><literal>SESAM_TXREAD_READONLY</literal></entry> + <entry><constant>SESAM_TXREAD_READONLY</constant></entry> <entry>Lecture seule</entry> </row> </tbody> @@ -101,16 +101,17 @@ <para> Les valeurs modifiées par <function>sesam_settransaction</function> remplaceront les valeurs par défaut spécifiée dans - <link linkend="ini.sesam-configfile">le fichier de configuration SESAM</link>. + le fichier de configuration SESAM. </para> <para> <example> <title>Modifier les paramètres de configuration SESAM</title> <programlisting role="php"> -<?php -sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, - SESAM_TXREAD_READONLY); -?> +<![CDATA[ +<?php + sesam_settransaction(SESAM_TXISOL_REPEATABLE_READ, SESAM_TXREAD_READONLY); +?> +]]> </programlisting> </example> </para>