Files
doc-fr/reference/sqlite/functions/sqlite-factory.xml
Jean-Sébastien Goupil 6f5ac4d5da sync with EN
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@187246 c90b9560-bf6c-de11-be94-00142212c4b1
2005-05-29 19:24:44 +00:00

125 lines
3.6 KiB
XML
Executable File

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- EN-Revision: 1.7 Maintainer: jsgoupil Status: ready -->
<refentry id="function.sqlite-factory">
<refnamediv>
<refname>sqlite_factory</refname>
<refpurpose>
Ouvre une base SQLite et crée un objet pour elle
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>SQLiteDatabase</type><methodname>sqlite_factory</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter role="reference">error_message</parameter></methodparam>
</methodsynopsis>
<para>
<function>sqlite_factory</function> fonctionne de la même façon que
<function>sqlite_open</function> dans le fait qu'il ouvre une base de données
SQLite ou tente de la créer si elle n'existe pas. Cependant, un objet
<link linkend="sqlite.class.sqlitedatabase">SQLiteDatabase</link> est retourné
plutôt qu'une ressource. Lisez la page de référence sur
<function>sqlite_open</function> pour son utilisation.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Le nom du fichier de la base de données SQLite.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Le mode du fichier. Devrait être utilisé pour ouvrir une base de
données en mode lecture seule. Présentement, ce paramètre est ignoré
par la bibliothèque sqlite. La valeur par défaut pour le mode est
<literal>0666</literal> en octal et cela est la valeur recommandée.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>error_message</parameter></term>
<listitem>
<para>
Passée par référence et est affectée afin de contenir la description du
message d'erreur qui explique pourquoi la base de données ne pouvait
pas être ouverte s'il y avait une erreur.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retourne un objet SQLiteDatabase en cas de succès, &null; en cas d'erreur.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>sqlite_factory</function></title>
<programlisting role="php">
<![CDATA[
<?php
$dbhandle = sqlite_factory('sqlitedb');
$dbhandle->query('SELECT user_id, username FROM users');
/* équivalent dans les fonctionnalités à : */
$dbhandle = new SQLiteDatabase('sqlitedb');
$dbhandle->query('SELECT user_id, username FROM users');
?>]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>sqlite_open</function></member>
<member><function>sqlite_popen</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
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
-->