-
Notifications
You must be signed in to change notification settings - Fork 42
/
construct.xml
164 lines (155 loc) · 4.85 KB
/
construct.xml
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: nobody Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 855bfee2f3db70d7dbb4c60c7c4a4efa567f1c60 Reviewer: samesch -->
<refentry xml:id="sqlite3.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SQLite3::__construct</refname>
<refpurpose>
Instanziiert ein SQLite3-Objekt und öffnet eine SQLite3-Datenbank
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<constructorsynopsis role="SQLite3">
<modifier>public</modifier> <methodname>SQLite3::__construct</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>encryptionKey</parameter><initializer>""</initializer></methodparam>
</constructorsynopsis>
<para>
Instanziiert ein SQLite3-Objekt und öffnet eine Verbindung zu einer
SQLite3-Datenbank. Wurde libsqlite3 mit Unterstützung für Verschlüsselung
kompiliert, wird versucht den angegebenen Schlüssel zu nutzen.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
Pfad zur SQLite-Datenbank oder <literal>:memory:</literal>, um eine im
Speicher befindliche Datenbank zu nutzen. Ist
<parameter>filename</parameter> eine leere Zeichenkette, dann wird eine
private, temporäre Datenbank auf der Festplatte erzeugt. Diese private
Datenbank wird automatisch gelöscht, sobald die Datenbankverbindung
geschlossen wird.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Optionale Schalter, die die Art bestimmen, wie die SQLite-Datenbank
geöffnet wird. Standardmäßig wird <literal>SQLITE3_OPEN_READWRITE |
SQLITE3_OPEN_CREATE</literal> zum Öffnen genutzt.
<itemizedlist>
<listitem>
<para>
<constant>SQLITE3_OPEN_READONLY</constant>: Öffnet die Datenbank im
"nur-lese"-Modus.
</para>
</listitem>
<listitem>
<para>
<constant>SQLITE3_OPEN_READWRITE</constant>: Öffnet die Datenbank
zum Lesen und Schreiben.
</para>
</listitem>
<listitem>
<para>
<constant>SQLITE3_OPEN_CREATE</constant>: erzeugt die Datenbank,
sollte diese nicht existieren.
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>encryptionKey</parameter></term>
<listitem>
<para>
Eine optionale Verschlüsselungs-Phrase, die zur Ver- und
Entschlüsselung der Datenbank genutzt wird. Ist das
SQLite-Verschlüsselungsmodul nicht installiert, dann hat dieser
Parameter keine Wirkung.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
Löst im Fehlerfall eine <classname>Exception</classname> aus.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.0.10</entry>
<entry>
Der Parameter <parameter>filename</parameter> kann nun leer sein, um eine
private, temporäre Datenbank auf der Festplatte zu verwenden.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>SQLite3::__construct</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
$db = new SQLite3('mysqlitedb.db');
$db->exec('CREATE TABLE foo (bar TEXT)');
$db->exec("INSERT INTO foo (bar) VALUES ('Dies ist ein Test')");
$result = $db->query('SELECT bar FROM foo');
var_dump($result->fetchArray());
?>
]]>
</programlisting>
</example>
</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
-->