1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.4 $ -->
<chapter xml:id="sqlite.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="sqlite.requirements">
&reftitle.required;
<para>
In order to have these functions available, you must compile PHP with
SQLite support, or load the SQLite extension dynamically from your
&php.ini;.
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
<section xml:id="sqlite.installation">
&reftitle.install;
<para>
Read the INSTALL file, which comes with the package. Or just use the PEAR
installer with <command>pecl install sqlite</command>.
SQLite itself is already included, You do not need to install
any additional software.
</para>
<para>
Windows users will enable <filename>php_sqlite.dll</filename> inside
of &php.ini; in order to use these functions.
&pecl.windows.download;
</para>
<para>
In PHP 5, the SQLite extension and the engine itself are bundled and
compiled by default. However, since PHP 5.1.0 you need to manually
activate the extension in &php.ini; (because it is now bundled as
shared). Moreover, since PHP 5.1.0 SQLite depends on <link
linkend="intro.pdo">PDO</link> it must be enabled too, by adding the
following lines to &php.ini; (in order):
<informalexample>
<programlisting role="ini">
<![CDATA[
extension=php_pdo.dll
extension=php_sqlite.dll
]]>
</programlisting>
</informalexample>
On Linux or Unix operating systems, if you build PDO as a shared
extension, you must build SQLite as a shared extension using the
<command>--with-sqlite=shared</command> configure option.
</para>
<para>
SQLite 3 is supported through <link
linkend="ref.pdo-sqlite">PDO SQLite</link>.
</para>
<note>
<title>Windows installation for unprivileged accounts</title>
<para>
On Windows operating systems, unprivileged accounts don't have the
<varname>TMP</varname> environment variable set by default. This will
make sqlite create temporary files in the windows directory, which is
not desirable. So, you should set the <varname>TMP</varname> environment
variable for the web server or the user account the web server is
running under. If Apache is your web server, you can accomplish this via
a <command>SetEnv</command> directive in your &httpd.conf; file. For
example:
<informalexample>
<programlisting role="apache-conf">
<![CDATA[
SetEnv TMP c:/temp
]]>
</programlisting>
</informalexample>
If you are unable to establish this setting at the server
level, you can implement the setting in your script:
<informalexample>
<programlisting role="php">
<![CDATA[
putenv('TMP=C:/temp');
]]>
</programlisting>
</informalexample>
The setting must refer to a directory that the web server
has permission to create files in and subsequently write
to and delete the files it created.
Otherwise, you may receive the following error message:
<computeroutput>
malformed database schema -
unable to open a temporary database file for storing temporary tables
</computeroutput>
</para>
</note>
</section>
<!-- }}} -->
<!-- {{{ Configuration -->
&reference.sqlite.ini;
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="sqlite.resources">
&reftitle.resources;
<para>
There are two resources used in the SQLite Interface. The first one is the
database connection, the second one the result set.
</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:"../../../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
-->
|