-
Notifications
You must be signed in to change notification settings - Fork 40
/
mysql-db-query.xml
164 lines (149 loc) · 4.56 KB
/
mysql-db-query.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: 684a3c40c755f2a70e57df478a5d37d6c0f30ef9 Maintainer: simp Status: ready -->
<!-- Credits: hholzgra -->
<refentry xml:id="function.mysql-db-query" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysql_db_query</refname>
<refpurpose>Wählt eine Datenbank aus und führt darauf eine Abfrage aus</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
&mysql.alternative.note.5-3-0;
<simplelist role="alternatives">
<member><function>mysqli_select_db</function> then the query</member>
<member><methodname>PDO::__construct</methodname></member>
</simplelist>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>resource</type><type>bool</type></type><methodname>mysql_db_query</methodname>
<methodparam><type>string</type><parameter>database</parameter></methodparam>
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<function>mysql_db_query</function> wählt eine Datenbank aus und führt eine
Abfrage darauf aus.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
Der Name der auszuwählenden Datenbank.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
Die MySQL-Abfrage.
</para>
<para>
Die Daten innerhalb der Abfrage sollten
<link linkend="function.mysql-real-escape-string">korrekt maskiert
sein</link>.
</para>
</listitem>
</varlistentry>
&mysql.linkid.description;
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Gibt eine positive MySQL-Ergebnisressource für das Abfrageergebnis zurück
oder &false; im Fehlerfall. Diese Funktion gibt für
<literal>INSERT</literal>-, <literal>UPDATE</literal>- und
<literal>DELETE</literal>-Abfragen ebenfalls &true;/&false; zurück, um
Erfolg/Misserfolg anzuzeigen.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mysql_db_query</function>-Alternativbeispiel</title>
<programlisting role="php">
<![CDATA[
<?php
if (!$link = mysql_connect('mysql_host', 'mysql_user', 'mysql_password')) {
echo 'Keine Verbindung zu mysql';
exit;
}
if (!mysql_select_db('mysql_dbname', $link)) {
echo 'Konnte die Datenbank nicht auswählen';
exit;
}
$sql = 'SELECT foo FROM bar WHERE id = 42';
$result = mysql_query($sql, $link);
if (!$result) {
echo "DB-Fehler, konnte die Datenbank nicht abfragen\n";
echo 'MySQL Error: ' . mysql_error();
exit;
}
while ($row = mysql_fetch_assoc($result)) {
echo $row['foo'];
}
mysql_free_result($result);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
Beachten Sie, dass diese Funktion <emphasis role="strong">NICHT</emphasis>
zu der Datenbank zurückwechselt, mit der Sie sich zuvor verbunden hatten.
Mit anderen Worten ausgedrückt: Sie können diese Funktion nicht verwenden,
um <emphasis>temporär</emphasis> eine SQL-Abfrage auf einer anderen
Datenbank auszuführen. Sie müssen selbst (manuell) sicherstellen, dass Sie
wieder Ihre vorherige Datenbank verwenden. Sie sollten sich angewöhnen,
statt dieser Funktion in Ihren SQL-Abfragen die Schreibweise
<literal>datenbank.tabelle</literal> oder die Funktion
<function>mysql_select_db</function> zu verwenden.
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mysql_query</function></member>
<member><function>mysql_select_db</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
-->