com doc/fr: Apply commit 09024d16473f8817ca84b3e2cdb4ef44681a705f: appendices/ini.list.xml install/windows/legacy/extensions.xml reference/dbx/book.xml reference/dbx/configure.xml reference/dbx/constants.xml reference/dbx/functions/dbx-close.xml reference/dbx/functions/dbx-compare.xml reference/dbx/functions/dbx-connect.xml reference/dbx/functions/dbx-error.xml reference/dbx/functions/dbx-escape-string.xml reference/dbx/functions/dbx-fetch-row.xm
[email protected] (George Peter Banyard) Wed, 24 Feb 2021 17:45:14 +0000
| Newsgroups | php.doc.fr |
|---|---|
| Message-ID | <[email protected]> |
Commit: db83888f14be3e23a5eebcce0fab66a49c8a3ba4 Author: George Peter Banyard <[email protected]> Wed, 24 Feb 2021 16:43:50 +0000 Parents: 045423bfbec06482e6a617a950a13932470d2d4f Branches: master Link: http://git.php.net/?p=doc/fr.git;a=commitdiff;h=db83888f14be3e23a5eebcce0fab66a49c8a3ba4 Log: Apply commit 09024d16473f8817ca84b3e2cdb4ef44681a705f Remove dbx documentation Changed paths: M appendices/ini.list.xml M install/windows/legacy/extensions.xml D reference/dbx/book.xml D reference/dbx/configure.xml D reference/dbx/constants.xml D reference/dbx/functions/dbx-close.xml D reference/dbx/functions/dbx-compare.xml D reference/dbx/functions/dbx-connect.xml D reference/dbx/functions/dbx-error.xml D reference/dbx/functions/dbx-escape-string.xml D reference/dbx/functions/dbx-fetch-row.xml D reference/dbx/functions/dbx-query.xml D reference/dbx/functions/dbx-sort.xml D reference/dbx/ini.xml D reference/dbx/reference.xml D reference/dbx/setup.xml
diff_db83888f14be3e23a5eebcce0fab66a49c8a3ba4.txt
(text/plain, 58.6 KB)
diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml
index 0b0667378e..70c8527c7b 100644
--- a/appendices/ini.list.xml
+++ b/appendices/ini.list.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 8465ce5fc83b9ad9442aaae1797ca9efd42a4757 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 09024d16473f8817ca84b3e2cdb4ef44681a705f Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Liste des directives du &php.ini;</title>
@@ -388,12 +388,6 @@
<entry></entry>
</row>
<row>
- <entry><link linkend="ini.dbx.colnames-case">dbx.colnames_case</link></entry>
- <entry>"unchanged"</entry>
- <entry>PHP_INI_SYSTEM</entry>
- <entry>&php.version.retired; 5.1.0.</entry>
- </row>
- <row>
<entry><link linkend="ini.default-charset">default_charset</link></entry>
<entry>"UTF-8"</entry>
<entry>PHP_INI_ALL</entry>
diff --git a/install/windows/legacy/extensions.xml b/install/windows/legacy/extensions.xml
index e22a9cf47c..dea490b863 100644
--- a/install/windows/legacy/extensions.xml
+++ b/install/windows/legacy/extensions.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: f7eec8e460993235c050632502bc84d4c077cd17 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 09024d16473f8817ca84b3e2cdb4ef44681a705f Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<sect2 xml:id="install.windows.legacy.extensions" xmlns="http://docbook.org/ns/docbook">
@@ -165,11 +165,6 @@ extension=php_bz2.dll
<entry>Non</entry>
</row>
<row>
- <entry>php_dbx.dll</entry>
- <entry>Fonctions <link linkend="book.dbx">dbx</link></entry>
- <entry></entry>
- </row>
- <row>
<entry>php_exif.dll</entry>
<entry>Fonctions <link linkend="book.exif">EXIF</link></entry>
<entry>
diff --git a/reference/dbx/book.xml b/reference/dbx/book.xml
deleted file mode 100644
index b5f14ba209..0000000000
--- a/reference/dbx/book.xml
+++ /dev/null
@@ -1,54 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<book xml:id="book.dbx" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>dbx</title>
-
- <!-- {{{ preface -->
- <preface xml:id="intro.dbx">
- &reftitle.intro;
- <para>
- Le module dbx est une couche d'abstraction de base de données
- (db 'X', où 'X' est la base de données supportées). Les fonctions
- dbx vous permettent d'accéder à toutes les bases de données supportées
- en utilisant un simple appel. Les fonctions dbx elles-mêmes
- ne s'interfacent pas directement sur les bases de données,
- mais plutôt avec le module qui est utilisé pour supporter
- la base de données.
- </para>
- <note>
- <para>
- &pecl.moved-ver;5.1.0.
- </para>
- </note>
- </preface>
- <!-- }}} -->
-
- &reference.dbx.setup;
- &reference.dbx.constants;
- &reference.dbx.reference;
-
-</book>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/configure.xml b/reference/dbx/configure.xml
deleted file mode 100644
index fefdab04d4..0000000000
--- a/reference/dbx/configure.xml
+++ /dev/null
@@ -1,44 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 8c1cbb0cd3868c7fbe00cea554e3e4238fe2e313 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<section xml:id="dbx.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- &reftitle.install;
- <para>
- &pecl.moved-ver;5.1.0
- </para>
- <para>
- &pecl.info;
- <link xlink:href="&url.pecl.package;dbx">&url.pecl.package;dbx</link>.
- </para>
- <para>
- Il vous faut avoir ces fonctions compilées avec PHP (option
- de configuration <option role="configure">--enable-dbx</option>
- et toutes les bases que vous souhaitez utiliser. Par exemple, si
- vous voulez accéder à MySQL depuis dbx, vous devez aussi configurer
- PHP avec
- <option role="configure">--with-mysql=[DIR]</option>.
- </para>
- </section>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
diff --git a/reference/dbx/constants.xml b/reference/dbx/constants.xml
deleted file mode 100644
index cb954caedb..0000000000
--- a/reference/dbx/constants.xml
+++ /dev/null
@@ -1,263 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: girgias Status: ready -->
-<!-- Reviewed: yes -->
-
-<appendix xml:id="constants.dbx" xmlns="http://docbook.org/ns/docbook">
- &reftitle.constants;
- &extension.constants;
- <variablelist>
- <varlistentry xml:id="constant.dbx-mysql">
- <term>
- <constant>DBX_MYSQL</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-odbc">
- <term>
- <constant>DBX_ODBC</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-pgsql">
- <term>
- <constant>DBX_PGSQL</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-mssql">
- <term>
- <constant>DBX_MSSQL</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-fbsql">
- <term>
- <constant>DBX_FBSQL</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-oci8">
- <term>
- <constant>DBX_OCI8</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-sybasect">
- <term>
- <constant>DBX_SYBASECT</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-sqlite">
- <term>
- <constant>DBX_SQLITE</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-persistent">
- <term>
- <constant>DBX_PERSISTENT</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-result-info">
- <term>
- <constant>DBX_RESULT_INFO</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-result-index">
- <term>
- <constant>DBX_RESULT_INDEX</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-result-assoc">
- <term>
- <constant>DBX_RESULT_ASSOC</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-result-unbuffered">
- <term>
- <constant>DBX_RESULT_UNBUFFERED</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-colnames-unchanged">
- <term>
- <constant>DBX_COLNAMES_UNCHANGED</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-colnames-uppercase">
- <term>
- <constant>DBX_COLNAMES_UPPERCASE</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-colnames-lowercase">
- <term>
- <constant>DBX_COLNAMES_LOWERCASE</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-cmp-native">
- <term>
- <constant>DBX_CMP_NATIVE</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-cmp-text">
- <term>
- <constant>DBX_CMP_TEXT</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-cmp-number">
- <term>
- <constant>DBX_CMP_NUMBER</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-cmp-asc">
- <term>
- <constant>DBX_CMP_ASC</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry xml:id="constant.dbx-cmp-desc">
- <term>
- <constant>DBX_CMP_DESC</constant>
- (&integer;)
- </term>
- <listitem>
- <simpara>
-
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
-</appendix>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-close.xml b/reference/dbx/functions/dbx-close.xml
deleted file mode 100644
index 8bcccf54a2..0000000000
--- a/reference/dbx/functions/dbx-close.xml
+++ /dev/null
@@ -1,102 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-close" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_close</refname>
- <refpurpose>Ferme une connexion à une base DBX</refpurpose>
- </refnamediv>
-
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>int</type><methodname>dbx_close</methodname>
- <methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
- </methodsynopsis>
- </refsect1>
-
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>link_identifier</parameter></term>
- <listitem>
- <para>
- L'objet DBX à fermer.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
-
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Retourne 1 en cas de succès, 0 si une erreur survient.
- </para>
- </refsect1>
-
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Exemple avec <function>dbx_close</function></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password")
- or die("Could not connect");
-
-echo "Connected successfully";
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
-
- <refsect1 role="notes">
- &reftitle.notes;
- <note>
- <para>
- Reportez-vous aussi à la documentation de la base de données que vous
- utilisez.
- </para>
- </note>
- </refsect1>
-
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_connect</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-compare.xml b/reference/dbx/functions/dbx-compare.xml
deleted file mode 100644
index 15a70389c2..0000000000
--- a/reference/dbx/functions/dbx-compare.xml
+++ /dev/null
@@ -1,169 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-compare" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_compare</refname>
- <refpurpose>Compare deux lignes DBX afin de les trier</refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>int</type><methodname>dbx_compare</methodname>
- <methodparam><type>array</type><parameter>row_a</parameter></methodparam>
- <methodparam><type>array</type><parameter>row_b</parameter></methodparam>
- <methodparam><type>string</type><parameter>column_key</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>DBX_CMP_ASC | DBX_CMP_NATIVE</initializer></methodparam>
- </methodsynopsis>
- <para>
- <function>dbx_compare</function> est une fonction d'aide pour
- <function>dbx_sort</function>, afin d'aider aux tris.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>row_a</parameter></term>
- <listitem>
- <para>
- Première ligne
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>row_b</parameter></term>
- <listitem>
- <para>
- Seconde ligne
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>column_key</parameter></term>
- <listitem>
- <para>
- La colonne comparée
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- Le paramètre <parameter>flags</parameter> peut prendre plusieurs valeurs :
- <itemizedlist>
- <listitem>
- <simpara>
- <constant>DBX_CMP_ASC</constant> - ordre ascendant
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_CMP_DESC</constant> - ordre descendant
- </simpara>
- </listitem>
- </itemizedlist>
- et le type utilisé pour la comparaison :
- <itemizedlist>
- <listitem>
- <simpara>
- <constant>DBX_CMP_NATIVE</constant> - pas de conversion de type
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_CMP_TEXT</constant> - compare les lignes comme des chaînes
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_CMP_NUMBER</constant> - compare les lignes comme des nombres
- </simpara>
- </listitem>
- </itemizedlist>
- Une direction de tri et un type de comparaison peuvent être combinés
- avec l'opérateur OR (|).
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Retourne <literal>0</literal> si
- <literal>row_a[$column_key]</literal> est égale à
- <literal>row_b[$column_key]</literal>, et <literal>1</literal> ou
- <literal>-1</literal> si le premier est plus grand ou plus petit que le
- dernier, respectivement, ou bien le contraire si l'option
- <parameter>flags</parameter> est configurée à <constant>DBX_CMP_DESC</constant>.
- </para>
- </refsect1>
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Exemple avec <function>dbx_compare</function></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-function user_re_order($a, $b)
-{
- $rv = dbx_compare($a, $b, "parentid", DBX_CMP_DESC);
- if (!$rv) {
- $rv = dbx_compare($a, $b, "id", DBX_CMP_NUMBER);
- }
- return $rv;
-}
-
-$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
- or die("Impossible de se connecter");
-
-$result = dbx_query($link, "SELECT id, parentid, description FROM table ORDER BY id");
- // les données de $result sont désormais classées par id
-
-dbx_sort($result, "user_re_order");
- // la date dans $result est maintenant ordonnée par parentid (descending), puis par id
-
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_sort</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-connect.xml b/reference/dbx/functions/dbx-connect.xml
deleted file mode 100644
index e3c29f43d8..0000000000
--- a/reference/dbx/functions/dbx-connect.xml
+++ /dev/null
@@ -1,248 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: e41806c30bf6975e452c0d4ce35ab0984c2fa68c Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-connect" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_connect</refname>
- <refpurpose>Ouvre une connexion à une base de données</refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>object</type><methodname>dbx_connect</methodname>
- <methodparam><type>mixed</type><parameter>module</parameter></methodparam>
- <methodparam><type>string</type><parameter>host</parameter></methodparam>
- <methodparam><type>string</type><parameter>database</parameter></methodparam>
- <methodparam><type>string</type><parameter>username</parameter></methodparam>
- <methodparam><type>string</type><parameter>password</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>persistent</parameter></methodparam>
- </methodsynopsis>
- <para>
- Ouvre une connexion à une base de données.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>module</parameter></term>
- <listitem>
- <para>
- Le paramètre <parameter>module</parameter> peut être soit une
- chaîne, soit une constante. Les valeurs possibles de
- <parameter>module</parameter> sont listées ci-dessous, mais n'oubliez pas
- que cela fonctionnera que si le module associé est chargé.
- </para>
- <para>
- <itemizedlist>
- <listitem>
- <simpara>
- <constant>DBX_MYSQL</constant> ou <literal>"mysql"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_ODBC</constant> ou <literal>"odbc"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_PGSQL</constant> ou <literal>"pgsql"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_MSSQL</constant> ou <literal>"mssql"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_FBSQL</constant> ou <literal>"fbsql"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_SYBASECT</constant> ou <literal>"sybase_ct"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_OCI8</constant> ou <literal>"oci8"</literal>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_SQLITE</constant> ou <literal>"sqlite"</literal>
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>host</parameter></term>
- <listitem>
- <para>
- L'hôte serveur SQL
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>database</parameter></term>
- <listitem>
- <para>
- Le nom de la base de données
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>username</parameter></term>
- <listitem>
- <para>
- Le nom d'utilisateur
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>password</parameter></term>
- <listitem>
- <para>
- Le mot de passe
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>persistent</parameter></term>
- <listitem>
- <para>
- Le paramètre <parameter>persistent</parameter> peut prendre la
- valeur <constant>DBX_PERSISTENT</constant>,
- pour créer une connexion persistante.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- Les paramètres <parameter>host</parameter>, <parameter>database</parameter>,
- <parameter>username</parameter> et <parameter>password</parameter> sont
- attendus, mais ne sont pas toujours utiles, suivant la fonction de connexion
- de la base de données utilisée.
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Retourne un objet en cas de succès, &false; si une erreur survient. Si une
- connexion a été faîte mais la base de données n'a pu être sélectionnée,
- la connexion sera fermée et &false; sera retourné.
- </para>
- <para>
- L'objet retourné <varname>object</varname> a trois propriétés :
- <variablelist>
- <varlistentry>
- <term>
- <property>database</property>
- </term>
- <listitem>
- <simpara>
- Nom de la base de données sélectionnées
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>handle</property>
- </term>
- <listitem>
- <para>
- Ressource de connexion de la base de données, et donc, elle peut être utilisée
- dans les fonctions spécifiques au module (si requis).
- <informalexample>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
-mysql_close($link->handle); // dbx_close($link) serait plus appropriée ici.
-?>
-]]>
- </programlisting>
- </informalexample>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>module</property>
- </term>
- <listitem>
- <simpara>
- Utiliser en interne par dbx uniquement et actuellement, correspond
- au numéro du module mentionné ci-dessus.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
-
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Exemple avec <function>dbx_connect</function></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
- or die("Impossible de se connecter");
-
-echo "Connexion réussie";
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="notes">
- &reftitle.notes;
- <note>
- <para>
- Reportez-vous à la documentation du module utilisé.
- </para>
- </note>
- </refsect1>
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_close</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-error.xml b/reference/dbx/functions/dbx-error.xml
deleted file mode 100644
index c6f34e0da6..0000000000
--- a/reference/dbx/functions/dbx-error.xml
+++ /dev/null
@@ -1,109 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-error" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_error</refname>
- <refpurpose>
- Rapporte le message d'erreur du dernier appel de fonction DBX
- </refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>string</type><methodname>dbx_error</methodname>
- <methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>dbx_error</function> retourne une chaîne contenant le
- dernier message d'erreur du module sélectionné.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>link_identifier</parameter></term>
- <listitem>
- <para>
- L'objet DBX retourné par la fonction
- <function>dbx_connect</function>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Retourne une chaîne contenant le dernier message d'erreur du module
- sélectionné. S'il y a des connexions multiples sur le même module,
- seule la dernière erreur est fournie. S'il a des connexions sur différents
- modules, la dernière erreur du module est retourné (le module est alors
- représenté par <parameter>link_identifier</parameter>).
- </para>
- </refsect1>
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Exemple avec <function>dbx_error</function></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password")
- or die("Impossible de se connecter");
-
-$result = dbx_query($link, "select id from non_existing_table");
-if ($result == 0) {
- echo dbx_error($link);
-}
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="notes">
- &reftitle.notes;
- <note>
- <para>
- Reportez-vous aussi à la documentation de la base de données que vous
- utilisez.
- </para>
- <para>
- Le message de <productname>Microsoft SQL Server</productname> est en fait le résultat de
- la fonction <function>mssql_get_last_message</function>.
- </para>
- <para>
- Le support des messages d'erreur Oracle ne sont pas implémentés pour le moment.
- </para>
- </note>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-escape-string.xml b/reference/dbx/functions/dbx-escape-string.xml
deleted file mode 100644
index 3acfa5bafa..0000000000
--- a/reference/dbx/functions/dbx-escape-string.xml
+++ /dev/null
@@ -1,107 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-escape-string" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_escape_string</refname>
- <refpurpose>
- Protège une chaîne de caractères pour l'utiliser dans une requête
- </refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>string</type><methodname>dbx_escape_string</methodname>
- <methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
- <methodparam><type>string</type><parameter>text</parameter></methodparam>
- </methodsynopsis>
- <para>
- Protège une chaîne de caractères pour l'utiliser dans une requête.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>link_identifier</parameter></term>
- <listitem>
- <para>
- L'objet DBX retourné par la fonction <function>dbx_connect</function>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>text</parameter></term>
- <listitem>
- <para>
- La chaîne à échapper
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Retourne le texte <parameter>text</parameter>
- dont les caractères spéciaux ont été protégés (les guillemets, les
- antislash...). Si une erreur survient, &null; sera retourné.
- </para>
- </refsect1>
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Exemple avec <function>dbx_escape_string</function></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password")
- or die("Impossible de se connecter");
-
-$text = dbx_escape_string($link, "It\'s quoted and backslashed (\\).");
-$result = dbx_query($link, "insert into tbl (txt) values ('" . $text . "')");
-if ($result == 0) {
- echo dbx_error($link);
-}
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_query</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-fetch-row.xml b/reference/dbx/functions/dbx-fetch-row.xml
deleted file mode 100644
index db97b7f21f..0000000000
--- a/reference/dbx/functions/dbx-fetch-row.xml
+++ /dev/null
@@ -1,116 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-fetch-row" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_fetch_row</refname>
- <refpurpose>Lit une ligne dans un résultat DBX ayant l'option
- <constant>DBX_RESULT_UNBUFFERED</constant> activée</refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>mixed</type><methodname>dbx_fetch_row</methodname>
- <methodparam><type>object</type><parameter>result_identifier</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>dbx_fetch_row</function> récupère les lignes depuis le jeu
- de résultats dont le drapeau <constant>DBX_RESULT_UNBUFFERED</constant>
- est défini.
- </para>
- <para>
- Lorsque l'option <constant>DBX_RESULT_UNBUFFERED</constant> n'est pas activée
- dans la requête, <function>dbx_fetch_row</function> va échouer car toutes
- les lignes auront été déjà lues dans le membre <property>data</property>.
- </para>
- <para>
- De plus, le membre <property>rows</property> de l'objet de résultat
- est incrémenté à chaque lecture réussie de <function>dbx_fetch_row</function>.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>result_identifier</parameter></term>
- <listitem>
- <para>
- Un jeu de résultats retourné par la fonction
- <function>dbx_query</function>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- Retourne un objet en cas de succès qui contient les mêmes informations que n'importe
- quelle ligne d'un résultat dbx, placé dans le membre <property>data</property>,
- incluant l'accès aux colonnes par index ou par nom, suivant l'utilisation
- des options avec <function>dbx_guery</function>.
- </para>
- <para>
- Si une erreur survient, la fonction retournera <literal>0</literal> (e.g. lorsqu'aucune ligne n'est
- disponible).
- </para>
- </refsect1>
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Comment gérer la valeur retournée</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$result = dbx_query($link, 'SELECT id, parentid, description FROM table', DBX_RESULT_UNBUFFERED);
-
-echo "<table>\n";
-while ($row = dbx_fetch_row($result)) {
- echo "<tr>\n";
- foreach ($row as $field) {
- echo "<td>$field</td>";
- }
- echo "</tr>\n";
-}
-echo "</table>\n";
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_query</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-query.xml b/reference/dbx/functions/dbx-query.xml
deleted file mode 100644
index eb6df05f06..0000000000
--- a/reference/dbx/functions/dbx-query.xml
+++ /dev/null
@@ -1,408 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: b824e2b1086e94a1077bd071964547283616030a Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-query" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_query</refname>
- <refpurpose>Envoie une requête et lit tous les résultats DBX</refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>mixed</type><methodname>dbx_query</methodname>
- <methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
- <methodparam><type>string</type><parameter>sql_statement</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
- </methodsynopsis>
- <para>
- Envoie une requête et lit tous les résultats.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>link_identifier</parameter></term>
- <listitem>
- <para>
- L'objet DBX retournée par la fonction <function>dbx_connect</function>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>sql_statement</parameter></term>
- <listitem>
- <para>
- La requête SQL.
- </para>
- <para>
- Les données à l'intérieur de la requête doivent être <link
- linkend="function.dbx-escape-string">proprement échappées</link>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>flags</parameter></term>
- <listitem>
- <para>
- Le paramètre <parameter>flags</parameter> sert à contrôler la quantité
- d'informations retournée. Il peut être n'importe quelle
- combinaisons par l'opérateur OR des constantes ci-après. Les constantes
- remplacent la configuration du &php.ini;.
- <variablelist>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_INDEX</constant>
- </term>
- <listitem>
- <simpara>
- Ce paramètre est <emphasis>toujours</emphasis> activé,
- c'est à dire que l'objet retourné dispose du membre
- <property>data</property> qui est un tableau à deux dimensions,
- indexé numériquement. Par exemple, dans l'expression
- <literal>data[2][3]</literal> <literal>2</literal> représente
- le numéro de ligne et <literal>3</literal> représente
- le numéro de colonne. Les premières lignes et colonnes
- sont indexées à 0.
- </simpara>
- <simpara>
- Si <constant>DBX_RESULT_ASSOC</constant> est aussi spécifié, l'objet
- retourné contient en plus les informations liées à
- <constant>DBX_RESULT_INFO</constant>, même s'il n'a pas été spécifié.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_INFO</constant>
- </term>
- <listitem>
- <simpara>
- Cette option fournit des informations sur les colonnes, comme
- les noms des champs et leur type.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_ASSOC</constant>
- </term>
- <listitem>
- <simpara>
- Cette option fait que la valeur des champs peut être accessible
- avec le nom de la colonne, utilisé comme clé dans le tableau du
- membre <property>data</property>.
- </simpara>
- <simpara>
- Les résultats ainsi associés sont des références sur les valeurs
- identifiées par les index numériques, ce qui fait que modifier
- <literal>data[0][0]</literal> fait que
- <literal>data[0]['nom_de_la_premiere_colonne']</literal> sera aussi
- modifié.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_RESULT_UNBUFFERED</constant>
- </term>
- <listitem>
- <simpara>
- Cet option ne crée pas de propriété <property>data</property> et
- la propriété <property>rows</property> sera initialement
- positionnée à 0. Utilisez ce flag pour des jeux d'enregistrements importants
- et utilisez <function>dbx_fetch_row</function> pour retrouver le résultat
- ligne par ligne.
- </simpara>
- <simpara>
- <function>dbx_fetch_row</function> retournera les lignes qui se conforment
- au flag de la requête. Par ailleurs, cela mettra à jour les lignes à chaque
- appel de la fonction.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_COLNAMES_UNCHANGED</constant>
- </term>
- <listitem>
- <simpara>
- La casse du nom des colonnes retournées ne sera pas modifiée.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_COLNAMES_UPPERCASE</constant>
- </term>
- <listitem>
- <simpara>
- Les noms de colonnes seront mis en majuscules.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_COLNAMES_LOWERCASE</constant>
- </term>
- <listitem>
- <simpara>
- Les noms de colonnes seront mis en minuscules.
- </simpara>
- </listitem>
- </varlistentry>
- </variablelist>
- Notez que <constant>DBX_RESULT_INDEX</constant> est toujours active,
- indépendamment de la valeur de <parameter>flags</parameter>. Cela signifie
- que seules les combinaisons suivantes sont utiles :
- <itemizedlist>
- <listitem>
- <simpara>
- <constant>DBX_RESULT_INDEX</constant>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_RESULT_INDEX</constant> |
- <constant>DBX_RESULT_INFO</constant>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <constant>DBX_RESULT_INDEX</constant> |
- <constant>DBX_RESULT_INFO</constant> |
- <constant>DBX_RESULT_ASSOC</constant> - c'est la valeur par défaut,
- si <parameter>flags</parameter> est omis.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- <function>dbx_query</function> retourne un objet dbx_result_object ou
- <literal>1</literal> en cas de succès (un objet de résultat
- ne sera retourné que pour les requêtes SQL qui retournent un
- résultat), ou <literal>0</literal> en cas d'erreur. L'objet résultant n'est retourné que si la requête
- donnée par <parameter>sql_statement</parameter> produit un jeu d'enregistrements.
- (i.e. une requête SELECT, même si le résultat est vide).
- </para>
- <para>
- L'objet retourné a 5 membres (éventuellement 4, suivant
- les valeurs de <parameter>flags</parameter>) :
- <variablelist>
- <varlistentry>
- <term>
- <property>handle</property>
- </term>
- <listitem>
- <para>
- Ceci est une ressource représentant la connexion à la
- base de données, et il peut être utilisé (si nécessaire) avec
- les fonctions spécialisées de la base.
- <informalexample>
- <programlisting role="php">
-<![CDATA[
-<?php
-$result = dbx_query($link, "SELECT id FROM table");
-mysql_field_len($result->handle, 0);
-?>
-]]>
- </programlisting>
- </informalexample>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>cols</property> et <property>rows</property>
- </term>
- <listitem>
- <para>
- Ces deux membres contiennent respectivement
- le nombre de colonnes et de lignes.
- <informalexample>
- <programlisting role="php">
-<![CDATA[
-<?php
-$result = dbx_query($link, 'SELECT id FROM table');
-echo $result->rows; // nombre de lignes
-echo $result->cols; // nombre de champs
-?>
-]]>
- </programlisting>
- </informalexample>
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>info</property> (optionnel)
- </term>
- <listitem>
- <simpara>
- Ce membre est retourné uniquement si <constant>DBX_RESULT_INFO</constant> ou
- <constant>DBX_RESULT_ASSOC</constant> sont spécifiés dans le paramètre
- <parameter>flags</parameter>. C'est un tableau à deux dimensions,
- avec deux lignes (<literal>name</literal> et
- <literal>type</literal>) pour lire les informations de colonnes.
- </simpara>
- <example>
- <title>Listes les types et noms de colonnes</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$result = dbx_query($link, 'SELECT id FROM table',
- DBX_RESULT_INDEX | DBX_RESULT_INFO);
-
-for ($i = 0; $i < $result->cols; $i++ ) {
- echo $result->info['name'][$i] . "\n";
- echo $result->info['type'][$i] . "\n";
-}
-?>
-]]>
- </programlisting>
- </example>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <property>data</property>
- </term>
- <listitem>
- <simpara>
- Ce membre contient les résultats obtenus, possiblement associés
- avec le nom de colonne, en fonction de la valeur du paramètre
- <parameter>flags</parameter>. Si <constant>DBX_RESULT_ASSOC</constant>
- est activé, il est possible d'utiliser aussi
- <literal>$result->data[2]["nom_de_la_colonne"]</literal>.
- </simpara>
- <example>
- <title>Afficher le contenu d'une base</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$result = dbx_query($link, 'SELECT id, parentid, description FROM table');
-
-echo "<table>\n";
-foreach ($result->data as $row) {
- echo "<tr>\n";
- foreach ($row as $field) {
- echo "<td>$field</td>";
- }
- echo "</tr>\n";
-}
-echo "</table>\n";
-?>
-]]>
- </programlisting>
- </example>
- <example>
- <title>Comment utiliser les requêtes UNBUFFERED</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-
-$result = dbx_query ($link, 'SELECT id, parentid, description FROM table', DBX_RESULT_UNBUFFERED);
-
-echo "<table>\n";
-while ($row = dbx_fetch_row($result)) {
- echo "<tr>\n";
- foreach ($row as $field) {
- echo "<td>$field</td>";
- }
- echo "</tr>\n";
-}
-echo "</table>\n";
-
-?>
-]]>
- </programlisting>
- </example>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
-
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Comment gérer la valeur retournée</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
- or die("Impossible de se connecter");
-
-$result = dbx_query($link, 'SELECT id, parentid, description FROM table');
-
-if (is_object($result) ) {
- // ... faîtes des actions ici, voir les exemples détaillés ci-dessus ...
- // tout d'abord, afficher les noms et types de champs
- // puis, afficher un tableau contenant les valeurs retournées
-} else {
- exit("Échec de la requête");
-}
-
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="notes">
- &reftitle.notes;
- <note>
- <para>
- Reportez-vous aussi à la documentation de la base de données que vous
- utilisez.
- </para>
- <para>
- Les noms des colonnes pour les requêtes sur des bases de données Oracle sont
- retournés en minuscules.
- </para>
- </note>
- </refsect1>
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_escape_string</function></member>
- <member><function>dbx_fetch_row</function></member>
- <member><function>dbx_connect</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/functions/dbx-sort.xml b/reference/dbx/functions/dbx-sort.xml
deleted file mode 100644
index aa09aaf728..0000000000
--- a/reference/dbx/functions/dbx-sort.xml
+++ /dev/null
@@ -1,129 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<refentry xml:id="function.dbx-sort" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>dbx_sort</refname>
- <refpurpose>
- Trie un résultat avec une fonction utilisateur
- </refpurpose>
- </refnamediv>
- <refsect1 role="description">
- &reftitle.description;
- <methodsynopsis>
- <type>bool</type><methodname>dbx_sort</methodname>
- <methodparam><type>object</type><parameter>result</parameter></methodparam>
- <methodparam><type>string</type><parameter>user_compare_function</parameter></methodparam>
- </methodsynopsis>
- <para>
- Trie un résultat depuis un appel à la fonction <function>dbx_query</function>
- avec une fonction de trie personnalisée.
- </para>
- </refsect1>
- <refsect1 role="parameters">
- &reftitle.parameters;
- <para>
- <variablelist>
- <varlistentry>
- <term><parameter>result</parameter></term>
- <listitem>
- <para>
- Un jeu de résultats retourné par la fonction
- <function>dbx_query</function>.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><parameter>user_compare_function</parameter></term>
- <listitem>
- <para>
- La fonction de comparaison définie par l'utilisateur. Elle doit accepter
- deux arguments et retourner un entier, inférieur à, égal à, ou
- supérieur à &zero; si le premier argument est considéré comme,
- respectivement, inférieur à, égal à ou supérieur au second.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- </refsect1>
- <refsect1 role="returnvalues">
- &reftitle.returnvalues;
- <para>
- &return.success;
- </para>
- </refsect1>
- <refsect1 role="examples">
- &reftitle.examples;
- <para>
- <example>
- <title>Exemple avec <function>dbx_sort</function></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-function user_re_order($a, $b)
-{
- $rv = dbx_compare($a, $b, "parentid", DBX_CMP_DESC);
- if (!$rv) {
- $rv = dbx_compare($a, $b, "id", DBX_CMP_NUMBER);
- }
- return $rv;
-}
-
-$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
- or die("Impossible de se connecter");
-
-$result = dbx_query($link, "SELECT id, parentid, description FROM tbl ORDER BY id");
- // Les données sont maintenant triées par id
-
-dbx_sort($result, "user_re_order");
- // Les données sont maintenant triées par parentid décroissant, puis par id
-
-dbx_close($link);
-?>
-]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- <refsect1 role="notes">
- &reftitle.notes;
- <note>
- <para>
- Il est toujours plus intéressant d'utiliser la clause <literal>SQL</literal>
- <literal>ORDER BY</literal> que la fonction <function>dbx_sort</function>, si possible.
- </para>
- </note>
- </refsect1>
- <refsect1 role="seealso">
- &reftitle.seealso;
- <para>
- <simplelist>
- <member><function>dbx_compare</function></member>
- </simplelist>
- </para>
- </refsect1>
-</refentry>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
\ No newline at end of file
diff --git a/reference/dbx/ini.xml b/reference/dbx/ini.xml
deleted file mode 100644
index 053a660a4a..0000000000
--- a/reference/dbx/ini.xml
+++ /dev/null
@@ -1,74 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: b824e2b1086e94a1077bd071964547283616030a Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<section xml:id="dbx.configuration" xmlns="http://docbook.org/ns/docbook">
- &reftitle.runtime;
- &extension.runtime;
- <para>
- <table>
- <title>&ConfigureOptions; DBX</title>
- <tgroup cols="4">
- <thead>
- <row>
- <entry>&Name;</entry>
- <entry>&Default;</entry>
- <entry>&Changeable;</entry>
- <entry>&Changelog;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry><link linkend="ini.dbx.colnames-case">dbx.colnames_case</link></entry>
- <entry>"unchanged"</entry>
- <entry>PHP_INI_SYSTEM</entry>
- <entry>Supprimé en PHP 5.1.0.</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- &ini.php.constants;
- </para>
- &ini.descriptions.title;
- <para>
- <variablelist>
- <varlistentry xml:id="ini.dbx.colnames-case">
- <term>
- <parameter>dbx.colnames_case</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Les noms de colonnes peuvent être retournés comme "inchangés"
- ("unchanged"), ou bien "majuscules" ("uppercase") ou encore
- "minuscules" ("lowercase"). Cette directive peut être reconfigurée
- par une option de <function>dbx_query</function>.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
-</section>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
-
diff --git a/reference/dbx/reference.xml b/reference/dbx/reference.xml
deleted file mode 100644
index 89be848bda..0000000000
--- a/reference/dbx/reference.xml
+++ /dev/null
@@ -1,29 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<reference xml:id="ref.dbx" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>&Functions; dbx</title>
-
- &reference.dbx.entities.functions;
-
-</reference>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
\ No newline at end of file
diff --git a/reference/dbx/setup.xml b/reference/dbx/setup.xml
deleted file mode 100644
index b8cd093a4d..0000000000
--- a/reference/dbx/setup.xml
+++ /dev/null
@@ -1,98 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 6fe0f9389b85c7b574f818acb7aa5192d31ac949 Maintainer: yannick Status: ready -->
-<!-- Reviewed: no -->
-
-<chapter xml:id="dbx.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- &reftitle.setup;
-
- <!-- {{{ Requirements -->
- <section xml:id="dbx.requirements">
- &reftitle.required;
- <para>
- Afin de pouvoir utiliser une base de données avec le module dbx,
- le module doit être lié ou chargé dans PHP, et le mode de base de données
- doit être supporté par le module dbx. Actuellement, les bases de données
- suivantes sont supportées, mais d'autres devraient suivre :
- <itemizedlist>
- <listitem>
- <simpara>
- <link linkend="ref.fbsql">FrontBase</link>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <link linkend="ref.mysql">MySQL</link>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <link linkend="ref.uodbc">ODBC</link>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <link linkend="ref.pgsql">PostgreSQL</link>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <link linkend="ref.oci8">Oracle (oci8)</link>
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- SQLite
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- La documentation permettant l'ajout du support d'autres bases de
- données à dbx peut être trouvée sur
- <link xlink:href="&url.dbx.docs;">&url.dbx.docs;</link>.
- </para>
- </section>
- <!-- }}} -->
-
- <!-- {{{ Installation -->
- &reference.dbx.configure;
- <!-- }}} -->
-
- <!-- {{{ Configuration -->
- &reference.dbx.ini;
- <!-- }}} -->
-
- <!-- {{{ Resources -->
- <section xml:id="dbx.resources">
- &reftitle.resources;
- <para>
- Il y a deux types de ressources utilisées par le module dbx. La première est
- l'objet lié à la connexion avec la base de données, la deuxième est
- le résultat d'une requête.
- </para>
- </section>
- <!-- }}} -->
-
-</chapter>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->