mirror of
https://github.com/macintoshplus/doc-fr.git
synced 2026-03-27 02:12:19 +01:00
3b8ae85f09
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@218923 c90b9560-bf6c-de11-be94-00142212c4b1
368 lines
14 KiB
XML
368 lines
14 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision: 1.19 $ -->
|
|
<!-- EN-Revision: 1.23 Maintainer: yannick Status: ready -->
|
|
<!-- Purpose: database.vendors -->
|
|
<!-- Membership: bundled -->
|
|
<!-- Reviewed: no -->
|
|
|
|
<reference id="ref.sqlite">
|
|
<title>Fonctions SQLite</title>
|
|
<titleabbrev>SQLite</titleabbrev>
|
|
|
|
<partintro>
|
|
<section id="sqlite.intro">
|
|
&reftitle.intro;
|
|
<para>
|
|
Cette extension fait l'interface avec le moteur de base
|
|
<productname>SQLite Embeddable SQL Database Engine</productname>.
|
|
<productname>SQLite</productname> est une bibliothèque C qui
|
|
implémente un moteur de bases de données SQL embarqué.
|
|
Les programmes qui utilisent <productname>SQLite</productname>
|
|
peuvent disposer d'un accès à une base de données SQL, sans avoir à
|
|
faire tourner d'autre processus serveur.
|
|
</para>
|
|
<para>
|
|
<productname>SQLite</productname> n'est pas un logiciel client pour se
|
|
connecter à un grand nom des bases de données. <productname>SQLite</productname>
|
|
est le serveur. La bibliothèque <productname>SQLite</productname>
|
|
lit et écrit directement dans les fichiers de bases de données
|
|
sur le disque.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
Pour plus d'informations sur <productname>SQLite</productname>, voyez
|
|
le site web <ulink url="&url.sqlite;">&url.sqlite;</ulink>.
|
|
</para>
|
|
</note>
|
|
</section>
|
|
|
|
<section id="sqlite.install">
|
|
&reftitle.install;
|
|
<para>
|
|
Lisez le fichier d'installation, qui est fourni avec la distribution.
|
|
Ou bien, utilisez simplement l'installeur PEAR :
|
|
<command>pear install sqlite</command>.
|
|
<productname>SQLite</productname> est déjà fourni avec &php; et vous
|
|
n'avez pas besoin de télécharger d'autres logiciels.
|
|
</para>
|
|
<para>
|
|
Les utilisateurs de Windows peuvent télécharger la version DLL de l'extension
|
|
<productname>SQLite</productname> ici :
|
|
<ulink url="&url.pecl.get.win;php_sqlite.dll">php_sqlite.dll</ulink>.
|
|
</para>
|
|
<para>
|
|
Dans la version 5 de &php;, l'extension SQLite ainsi que le moteur sont intégrés et
|
|
compilés par défaut. Cependant, depuis &php; 5.1.0, vous devez activer manuellement
|
|
cette extension dans le &php.ini; (parcequ'il est maintenant inclus en
|
|
tant que partagé). De plus, depuis &php; 5.1.0, SQLite dépend de <link
|
|
linkend="ref.pdo">PDO</link>, alors il doit être aussi activé,
|
|
en ajoutant les lignes suivantes au &php.ini; (dans l'ordre) :
|
|
<informalexample>
|
|
<programlisting role="ini">
|
|
<![CDATA[
|
|
extension=php_pdo.dll
|
|
extension=php_sqlite.dll
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
Sous les systèmes Lunix ou Unix, si vous compilez PDO en tant qu'extension partagée,
|
|
vous devez également compilez SQLite en tant qu'extension partagée en utilisant l'option
|
|
de configuration <command>--with-sqlite=shared</command>.
|
|
</para>
|
|
<para>
|
|
SQLite 3 est supportée à travers <link linkend="ref.pdo-sqlite">PDO
|
|
SQLite</link>.
|
|
</para>
|
|
<note>
|
|
<title>Installation sur Windows pour les comptes sans privilèges</title>
|
|
<para>
|
|
Sur les systèmes d'exploitation Windows, les comptes sans privilèges
|
|
n'ont pas la variable d'environnement <varname>TMP</varname>
|
|
d'initialisée par défaut. Cela fera créer des fichiers temporaires par
|
|
sqlite dans le dossier de windows, ce qui n'est pas voulu. Alors, vous
|
|
devriez initialiser la variable d'environnement <varname>TMP</varname>
|
|
pour le serveur web ou dans le compte utilisateur où le serveur web
|
|
fonctionne. Si Apache est votre serveur web, vous pouvez accomplir cela
|
|
via une directive <command>SetEnv</command> dans votre fichier
|
|
&httpd.conf;. Par exemple :
|
|
<informalexample>
|
|
<programlisting role="apache-conf">
|
|
<![CDATA[
|
|
SetEnv TMP c:/temp
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
Si vous êtes incapable d'établir cette configuration à ce niveau du
|
|
serveur, vous pouvez implémenter cette configuration dans votre script :
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
putenv('TMP=C:/temp');
|
|
]]>
|
|
</programlisting>
|
|
</informalexample>
|
|
La configuration doit référer à un répertoire à l'intérieur duquel le serveur web a la
|
|
permission de créer des fichiers et bien sûr d'y écrire et
|
|
supprimer les fichiers créés.
|
|
Autrement, vous recevrez le message d'erreur suivant :
|
|
<computeroutput>
|
|
malformed database schema -
|
|
unable to open a temporary database file for storing temporary tables
|
|
</computeroutput>
|
|
</para>
|
|
</note>
|
|
</section>
|
|
<section id="sqlite.requirements">
|
|
&reftitle.required;
|
|
<para>
|
|
Afin de disposer de ces fonctions, vous devez compiler &php;
|
|
avec le support <productname>SQLite</productname>, ou charger
|
|
dynamiquement l'extension <productname>SQLite</productname> depuis
|
|
votre fichier &php.ini;.
|
|
</para>
|
|
</section>
|
|
|
|
<section id="sqlite.resources">
|
|
&reftitle.resources;
|
|
<para>
|
|
Il y a deux ressources, utilisées par l'extension <productname>SQLite</productname>.
|
|
La première est une connexion à la base et
|
|
la seconde est un résultat de requête.
|
|
</para>
|
|
</section>
|
|
|
|
&reference.sqlite.constants;
|
|
|
|
<section id="sqlite.classes">
|
|
&reftitle.classes;
|
|
|
|
<section id="sqlite.class.sqlitedatabase">
|
|
<title><classname>SQLiteDatabase</classname></title>
|
|
<para>
|
|
Représente une base de données SQLite ouverte.
|
|
</para>
|
|
<section id='sqlite.class.sqlitedatabase.constructor'>
|
|
&reftitle.constructor;
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-open'>__construct</link> - construit un nouvel
|
|
objet SQLiteDatabase</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
<section id='sqlite.class.sqlitedatabase.methods'>
|
|
&reftitle.methods;
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-query'>query</link> - Exécute une
|
|
requête</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-exec'>queryExec</link> - Exécute une requête de
|
|
résultat</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-array-query'>arrayQuery</link> - Exécute une
|
|
requête et retourne les résultats dans un tableau</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-single-query'>singleQuery</link> - Exécute une
|
|
requête et retourne soit un tableau pour une seule colonne, soit la valeur de la
|
|
première ligne</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-unbuffered-query'>unbufferedQuery</link> -
|
|
Exécute une requête non bufférisée</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-last-insert-rowid'>lastInsertRowid</link> -
|
|
Retourne l'identifiant de la dernière ligne insérée</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-changes'>changes</link> - Retourne le
|
|
nombre de lignes modifiées par la dernière requête</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-create-aggregate'>createAggregate</link> -
|
|
Enregistre une UDF agrégeante pour les requêtes SQLite</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-create-function'>createFunction</link> -
|
|
Enregistre une fonction utilisateur "classique" UDF pour SQLite</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-busy-timeout'>busyTimeout</link> -
|
|
Configure ou désactive le délai d'attente d'une base SQLite occupée</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-last-error'>lastErorr</link> - Retourne
|
|
le dernier code erreur de la dernière erreur rencontrée</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-column-types'>fetchColumnTypes</link> -
|
|
Retourne un tableau de types de colonnes depuis une table particulière</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
</section>
|
|
|
|
<section id="sqlite.class.sqliteresult">
|
|
<title><classname>SQLiteResult</classname></title>
|
|
<para>
|
|
Représente un jeu de résultats SQLite bufférisé.
|
|
</para>
|
|
<section id='sqlite.class.sqliteresult.methods'>
|
|
&reftitle.methods;
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-array'>fetch</link> - Récupère la ligne
|
|
suivante depuis un jeu de résultats en tant que tableau</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-object'>fetchObject</link> - Récupère
|
|
la ligne suivante depuis un jeu de résultats en tant qu'objet</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-single'>fetchSingle</link> - Récupère la
|
|
première ligne depuis le jeu de résultats en tant que chaîne de caractères</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-all'>fetchAll</link> - Récupère toutes les
|
|
lignes depuis le jeu de résultats en tant que tableau de tableaux</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-column'>column</link> - Récupère une colonne
|
|
depuis la ligne courante du jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-num-fields'>numFields</link> - Retourne
|
|
le numéro du champ depuis un jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-field-name'>fieldName</link> - Retourne
|
|
le nom d'un champ particulier depuis le jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-current'>current</link> - Récupère la ligne
|
|
courante depuis le jeu de résultat en tant que tableau</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-key'>key</link> - Retourne l'index de la ligne
|
|
courante</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-next'>next</link> - Déplace le pointeur
|
|
sur le numéro de ligne suivante</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-valid'>valid</link> - Retourne si oui ou non
|
|
il reste des lignes de disponibles</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-rewind'>rewind</link> - Déplace le pointeur
|
|
sur le numéro de la première ligne d'un jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-prev'>prev</link> - Déplace le pointeur
|
|
sur le numéro de ligne précédent du jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-has-prev'>hasPrev</link> - Retourne si oui ou
|
|
non une ligne précédente est disponible</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-num-rows'>numRows</link> - Retourne le
|
|
nombre de lignes dans le jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-seek'>seek</link> - Déplace le pointeur
|
|
vers un numéro de ligne précis</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
</section>
|
|
|
|
<section id="sqlite.class.sqliteunbuffered">
|
|
<title><classname>SQLiteUnbuffered</classname></title>
|
|
<para>
|
|
Représente un jeu de résultats SQLite non-bufférisé. Les jeux de résultats
|
|
non-bufférisés sont séquentiels, déplacement du pointeur uniquement vers
|
|
le numéro suivant.
|
|
</para>
|
|
<section id='sqlite.class.sqliteunbuffered.methods'>
|
|
&reftitle.methods;
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-array'>fetch</link> - Récupère
|
|
la ligne suivante depuis un jeu de résultats en tant que tableau</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-object'>fetchObject</link> - Récupère
|
|
la ligne suivante depuis un jeu de résultats en tant qu'objet</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-single'>fetchSingle</link> - Récupère
|
|
la première colonne depuis un jeu de résultats en tant que chaîne de caractères</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-fetch-all'>fetchAll</link> - Récupère toutes les
|
|
lignes depuis le jeu de résultats en tant que tableau de tableaux</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-column'>column</link> - Récupère une colonne
|
|
depuis la ligne courante d'un jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-num-fields'>numFields</link> - Retourne
|
|
le nombre de champs dans le jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-field-name'>fieldName</link> - Retourne le
|
|
nom d'un champ en particulier depuis le jeu de résultats</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-current'>current</link> - Récupère la ligne
|
|
courante depuis le jeu de résultats en tant que tableau</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-next'>next</link> - Déplace le pointeur
|
|
vers un numéro de ligne suivant</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para><link linkend='function.sqlite-valid'>valid</link> - Retourne si oui ou non
|
|
il reste des lignes de disponibles</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</section>
|
|
</section>
|
|
|
|
</section>
|
|
|
|
&reference.sqlite.ini;
|
|
</partintro>
|
|
|
|
&reference.sqlite.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:"../../../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
|
|
-->
|