cvs: phpdoc-da /reference/mysql/functions mysql-affected-rows.xml mysql-fetch-lengths.xml mysql-field-flags.xml mysql-list-tables.xml mysql-query.xml mysql-stat.xml
[email protected] ("Mads N. Vestergaard") Sat, 05 Mar 2005 11:02:47 -0000
| Newsgroups | php.doc.da |
|---|---|
| Message-ID | <cvsmnv1110020567@cvsserver> |
mnv Sat Mar 5 06:02:47 2005 EDT
Modified files:
/phpdoc-da/reference/mysql/functions mysql-affected-rows.xml
mysql-fetch-lengths.xml
mysql-field-flags.xml
mysql-list-tables.xml
mysql-query.xml mysql-stat.xml
Log:
Sync with EN
mnv-20050305060247.txt
(text/plain, 20.4 KB)
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml:1.4 phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml:1.5
--- phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml:1.4 Mon Oct 11 15:13:56 2004
+++ phpdoc-da/reference/mysql/functions/mysql-affected-rows.xml Sat Mar 5 06:02:44 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.15 Maintainer: mnv Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.17 Maintainer: mnv Status: ready -->
<refentry id="function.mysql-affected-rows">
<refnamediv>
<refname>mysql_affected_rows</refname>
@@ -33,13 +33,16 @@
<note>
<para>
Når du bruger UPDATE, vil MySQL ikke opdatere kolonner, hvor den nye værdi er det samme som den gamle. Dette giver mulighed for at <function>mysql_affected_rows</function> ikke gengiver det præcise nummer af matchende rækker, men kun det antal af rækker der blev påvirket af forespørgslen.
- </para>
+ </para>
+ <para>
+ REPLACE forspørgslen sletter først rækker med samme primære nøgle og
+ indsætter derefter de nye rækker. Denne funktion returnerer derfor nummeret
+ af de slettede rækker plus antalet af de nye rækker.
+ </para>
</note>
<para>
- <function>mysql_affected_rows</function> virker ikke med SELECT
- forespørgsler, kun med forespørgsler der ændrer noget. For at finde ud af
- hvor mange rækker der er blevet returneret af en SELECT forespørgsel,
- brug da <function>mysql_num_rows</function>.
+ For at finde ud af hvor mange rækker der blev returneret fra en SELECT forspørgsel,
+ kan du bruge <function>mysql_num_rows</function>.
</para>
<para>
Hvis den sidste forespørgsel ikke blev udført korrekt, vil denne funktion returnere -1.
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-fetch-lengths.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-fetch-lengths.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-fetch-lengths.xml:1.2 phpdoc-da/reference/mysql/functions/mysql-fetch-lengths.xml:1.3
--- phpdoc-da/reference/mysql/functions/mysql-fetch-lengths.xml:1.2 Sat Aug 7 21:21:31 2004
+++ phpdoc-da/reference/mysql/functions/mysql-fetch-lengths.xml Sat Mar 5 06:02:44 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.5 Maintainer: mnv Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.6 Maintainer: mnv Status: ready -->
<refentry id="function.mysql-fetch-lengths">
<refnamediv>
<refname>mysql_fetch_lengths</refname>
@@ -40,8 +40,12 @@
print_r($row);
print_r($lengths);
-
-/* Output vil ligne:
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
Array
(
[id] => 42
@@ -52,11 +56,8 @@
[0] => 2
[1] => 16
)
-
-*/
-?>
]]>
- </programlisting>
+ </screen>
</example>
</para>
<para>
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-field-flags.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-field-flags.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-field-flags.xml:1.4 phpdoc-da/reference/mysql/functions/mysql-field-flags.xml:1.5
--- phpdoc-da/reference/mysql/functions/mysql-field-flags.xml:1.4 Thu Dec 16 13:35:57 2004
+++ phpdoc-da/reference/mysql/functions/mysql-field-flags.xml Sat Mar 5 06:02:44 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.4 Maintainer: mnv Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.6 Maintainer: mnv Status: ready -->
<refentry id="function.mysql-field-flags">
<refnamediv>
<refname>mysql_field_flags</refname>
@@ -40,13 +40,16 @@
echo 'Kunne ikke eksekvere forespørgslen: ' . mysql_error();
exit;
}
-$flags = mysql_field_flags($result, 'id');
+$flags = mysql_field_flags($result, 0);
-print $flags;
+echo $flags;
print_r(explode(' ', $flags));
-
-/* Output vil ligne dette:
-
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
not_null primary_key auto_increment
Array
(
@@ -55,10 +58,8 @@
[2] => auto_increment
)
-*/
-?>
]]>
- </programlisting>
+ </screen>
</example>
</para>
<para>
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-list-tables.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-list-tables.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-list-tables.xml:1.2 phpdoc-da/reference/mysql/functions/mysql-list-tables.xml:1.3
--- phpdoc-da/reference/mysql/functions/mysql-list-tables.xml:1.2 Thu Dec 16 13:35:57 2004
+++ phpdoc-da/reference/mysql/functions/mysql-list-tables.xml Sat Mar 5 06:02:44 2005
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
-<!-- EN-Revision: 1.10 Maintainer: mnv Status: ready -->
+<!-- $Revision: 1.3 $ -->
+<!-- EN-Revision: 1.12 Maintainer: mnv Status: ready -->
<refentry id="function.mysql-list-tables">
<refnamediv>
<refname>mysql_list_tables</refname>
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-query.xml?r1=1.4&r2=1.5&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-query.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-query.xml:1.4 phpdoc-da/reference/mysql/functions/mysql-query.xml:1.5
--- phpdoc-da/reference/mysql/functions/mysql-query.xml:1.4 Thu Dec 16 13:35:57 2004
+++ phpdoc-da/reference/mysql/functions/mysql-query.xml Sat Mar 5 06:02:44 2005
@@ -1,44 +1,100 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
-<!-- EN-Revision: 1.10 Maintainer: mnv Status: ready -->
+<!-- $Revision: 1.5 $ -->
+<!-- EN-Revision: 1.14 Maintainer: mnv Status: ready -->
<refentry id="function.mysql-query">
<refnamediv>
<refname>mysql_query</refname>
- <refpurpose>Sender en MySQL-forespørgsel</refpurpose>
+ <refpurpose>Sender en MySQL forespørgsel</refpurpose>
</refnamediv>
- <refsect1>
- <title>Beskrivelse</title>
- <methodsynopsis>
- <type>resource</type><methodname>mysql_query</methodname>
- <methodparam><type>string</type><parameter>query</parameter></methodparam>
- <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>mysql_query</function> sender en forespørgsel til den nuværende aktive database, på
- serveren der er forbundet med den pågældende link_identifier.
- Hvis <parameter>link_identifier</parameter> ikke er specificeret, vil funktionen benytte det sidste åbne
- link. Hvis intet link er åbnet, vil funktionen forsøge at etablere et link, som hvis
- <function>mysql_connect</function> var blevet kaldt uden nogle parametre,
- og bruge denne. Resultatet af forespørgselen er buffered.
- </para>
- <note>
- <para>
- Forespørgslen bør ikke ende med et semikolon </para>
- </note>
- <para>
- <function>mysql_query</function> returnerer kun en ressource X for SELECT,SHOW,EXPLAIN eller
- DESCRIBE-udtrykkene, eller &false; hvis forespørgslen ikke blev udført korrekt. For andre
- typer SQL-udtryk returnerer <function>mysql_query</function> &true;, når den er succesfuld,
- og &false; ved fejl. En ikke-&false; returværdi betyder, at forespørgslen var korrekt,
- og kunne blive eksekveret af serveren. Det indikerer intet om antallet af rækker, der er påvirket
- eller returneret. Det er muligt for en forespørgsel at blive udført succesfuldt
- uden at påvirke eller returnere nogen rækker.
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>resource</type><methodname>mysql_query</methodname>
+ <methodparam><type>string</type><parameter>query</parameter></methodparam>
+ <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>mysql_query</function> sender en forespørgsel (til den nuværende
+ aktive database på den server der er specificeret med
+ <parameter>link_identifier</parameter>).
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>query</parameter></term>
+ <listitem>
+ <para>
+ En SQL query
+ </para>
+ <para>
+ Forespørgsels strengen skal ikke ende med et semikolon.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>link_identifier</parameter></term>
+ <listitem>
+ <para>
+ En link beskriver, er returneret af <function>mysql_connect</function>.
+ </para>
+ <para>
+ Hvis <parameter>link_identifier</parameter> ikke er specifiveret, vil
+ det sidste åbne link blive valgt. Hvis intet link er åbent, vil funktionen
+ forsøge at etablere en forbindelse, som om <function>mysql_connect</function> blev
+ kaldt uden argumenter, og bruge denne. Resultatet af forespørgslen er gemt i en buffer.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ For SELECT, SHOW, DESCRIBE eller EXPLAIN forespørgslerne, vil
+ <function>mysql_query</function>
+ returnere en <type>resource</type> ved succes, eller &false; ved
+ fejl.
+ </para>
+ <para>
+ For andre SQL forespørgsler, UPDATE, DELETE, DROP, osv, vil
+ <function>mysql_query</function> returnere &true; ved succes
+ og &false; ved fejl.
+ </para>
+ <para>
+ Den returnerede resource, bør blive brugt sammen med
+ <function>mysql_fetch_array</function>, og andre
+ funktioner, der arbejder med resulterende rabeller, for at tilgå den returnerede data.
</para>
<para>
- Den følgende forespørgsel er syntaksmæssigt ukorrekt, derfor vil
- <function>mysql_query</function> fejle, og returnere &false;:
+ Brug <function>mysql_num_rows</function> for at finde ud af hvor mane rækker,
+ der vlev returneret af en SELECT forespørgsel eller
+ <function>mysql_affected_rows</function> for at finde ud af hvor mange rækker
+ der blev påvirket af DELETE, INSERT, REPLACE, eller UPDATE
+ forespørgslerne.
+ </para>
+ <para>
+ <function>mysql_query</function> vil også fejle og returnere &false;
+ hvis brugeren, ikke har rettigheder til de tabeller, der blev refereret til af
+ forespørgslen.
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
<example>
- <title><function>mysql_query</function> eksempel</title>
+ <title>Ugylding forespørgsel</title>
+ <para>
+ Den følgende forespørgsel, er syntax mæssigt ugyldigt, så
+ <function>mysql_query</function> vil fejle og returnere &false;.
+ </para>
<programlisting role="php">
<![CDATA[
<?php
@@ -46,66 +102,76 @@
if (!$result) {
die('Ugyldig forespørgsel: ' . mysql_error());
}
+
?>
]]>
</programlisting>
</example>
</para>
<para>
- Den følgende forespørgsel er semantisk ukorrekt hvis
- <literal>my_col</literal> ikke er en kolonne i tabellen
- <literal>my_tbl</literal>, derfor vil <function>mysql_query</function>
- fejle og returnere &false;:
<example>
- <title><function>mysql_query</function></title>
+ <title>Gyldig forespørgsel</title>
+ <para>
+ Den følgende forespørgsel er gyldig, så <function>mysql_query</function>
+ vil returnere en <type>resource</type>.
+ </para>
<programlisting role="php">
<![CDATA[
<?php
-$result = mysql_query('SELECT my_col FROM my_tbl');
+// Dette skal suppleres med en bruger f.eks.
+$firstname = 'fred';
+$lastname = 'fox';
+
+// Formuler forespørgslen
+// Dette er den bedste måde at udføre en SQL forespørgslen
+// For flere eksempler, se mysql_real_escape_string()
+$query = sprintf("SELECT firstname, lastname, address, age FROM friends WHERE firstname='%s' AND lastname='%s'",
+ mysql_real_escape_string($firstname),
+ mysql_real_escape_string($lastname));
+
+// Udfør forespørgslen
+$result = mysql_query($query);
+
+// Tjek resultatet
+// Dette er den aktuelle forespørgsel, sendt til MySQL, og fejlen. Brugbart til fejlfindding.
if (!$result) {
- die('Ugyldig forespørgsel: ' . mysql_error());
+ $message = 'Ugyldig forespørgsel: ' . mysql_error() . "\n";
+ $message .= 'Hele forespørgslen: ' . $query;
+ die($message);
+}
+
+// Brug resultatet
+// Et forsøg på at printe $result vil ikke give adgang til informationen i resourcen
+// En af MySQL resultat funktionerne skal bruges
+// Se også mysql_result(), mysql_fetch_array(), mysql_fetch_row(), etc.
+while ($row = mysql_fetch_assoc($result)) {
+ echo $row['firstname'];
+ echo $row['lastname'];
+ echo $row['address'];
+ echo $row['age'];
}
+
+// Befri resourcerne associeret med resultat sættet
+// Dette vil automatisk blive gjort, når scriptet er eksekveret
+mysql_free_result($result);
?>
]]>
</programlisting>
</example>
</para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- <function>mysql_query</function> vil også fejle og returnere &false;,
- hvis du ikke har rettigheder til at tilgå de, i forespørgslen omtalte,
- tabel(ler).
- </para>
- <para>
- Forudsat at forespørgslen bliver udført korrekt, kan man bruge
- <function>mysql_num_rows</function> for at finde ud af hvor mange
- rækker, der blev returneret ved et SELECT-udtryk, samt
- <function>mysql_affected_rows</function> for at finde ud af hvor mange
- rækker, der er blevet påvirket ved et DELETE, INSERT, REPLACE, eller
- UPDATE-udtryk.
- </para>
- <para>
- Kun for SELECT,SHOW,DESCRIBE eller EXPLAIN-udtrykkene vil
- <function>mysql_query</function>
- returnere en ny resultat-beskriver, som man kan give til
- <function>mysql_fetch_array</function> og andre
- funktioner, der har med tabelresultater at gøre.
- Når du er færdig med at bruge resultatet,
- kan du frigive ressourcerne, der er associeret med kaldet, ved at bruge
- <function>mysql_free_result</function>. Dog, ressourcerne vil automatisk
- blive frigivet, når scriptet er færdigt med at eksekvere.
- </para>
- <para>
- Se også
- <function>mysql_num_rows</function>,
- <function>mysql_affected_rows</function>,
- <function>mysql_unbuffered_query</function>,
- <function>mysql_free_result</function>,
- <function>mysql_fetch_array</function>,
- <function>mysql_fetch_row</function>,
- <function>mysql_fetch_assoc</function>,
- <function>mysql_result</function>,
- <function>mysql_select_db</function> og
- <function>mysql_connect</function>.
+ <simplelist>
+ <member><function>mysql_connect</function></member>
+ <member><function>mysql_error</function></member>
+ <member><function>mysql_real_escape_string</function></member>
+ <member><function>mysql_result</function></member>
+ <member><function>mysql_fetch_assoc</function></member>
+ <member><function>mysql_unbuffered_query</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/diff.php/phpdoc-da/reference/mysql/functions/mysql-stat.xml?r1=1.1&r2=1.2&ty=u
Index: phpdoc-da/reference/mysql/functions/mysql-stat.xml
diff -u phpdoc-da/reference/mysql/functions/mysql-stat.xml:1.1 phpdoc-da/reference/mysql/functions/mysql-stat.xml:1.2
--- phpdoc-da/reference/mysql/functions/mysql-stat.xml:1.1 Sun Oct 10 08:57:13 2004
+++ phpdoc-da/reference/mysql/functions/mysql-stat.xml Sat Mar 5 06:02:44 2005
@@ -1,44 +1,61 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
-<!-- EN-Revision: 1.8 Maintainer: mnv Status: ready -->
- <refentry id="function.mysql-stat">
- <refnamediv>
- <refname>mysql_stat</refname>
- <refpurpose>Returnerer den nuværende system status</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beskrivelse</title>
- <methodsynopsis>
- <type>string</type><methodname>mysql_stat</methodname>
- <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>mysql_stat</function> returnerer den nuværende system status.
- </para>
- <note>
- <para>
- <function>mysql_stat</function> returnerer kun status for uptime,
- tråde, forespørgsler, åbne tabeller, genindlæste tabeller og
- forespørgsler per sekond. For en komplet liste over andre status
- variabler, skal du bruge SHOW STATUS SQL forespørgslen.
- </para>
- </note>
- <para>
- <example>
- <title><function>mysql_stat</function> eksempel</title>
- <programlisting role="php">
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.10 Maintainer: mnv Status: ready -->
+<refentry id="function.mysql-stat">
+ <refnamediv>
+ <refname>mysql_stat</refname>
+ <refpurpose>Den nuværende system status</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>string</type><methodname>mysql_stat</methodname>
+ <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>mysql_stat</function> returnerer den nuværende server status.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>link_identifier</parameter></term>
+ <listitem>
+ <para>
+ Link til en MySQL forbindelse.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Returnerer en streng med status for uptime, tråde, forespørgsler, åbne tabeller,
+ flush tabeller and forespørgsler per second. For en komplet liste og andre status
+ variabler, kan du bruge <literal>SHOW STATUS</literal> SQL kommandoen.
+ Hvis <parameter>link_identifier</parameter> er ugyldig, &null; er returneret.
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>mysql_stat</function> eksempel</title>
+ <programlisting role="php">
<![CDATA[
<?php
-$link = mysql_connect('localhost', "mysql_bruger", "mysql_kode");
+$link = mysql_connect('localhost', 'mysql_bruger', 'mysql_kode');
$status = explode(' ', mysql_stat($link));
print_r($status);
?>
]]>
- </programlisting>
- <para>
- Ovenstående eksempel, vil give følgende output:
- </para>
- <screen>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
<![CDATA[
Array
(
@@ -52,16 +69,51 @@
[7] => Queries per second avg: 245.595
)
]]>
- </screen>
- </example>
- </para>
- <para>
- Se også
- <function>mysql_get_server_info</function> og
- <function>mysql_list_processes</function>.
- </para>
- </refsect1>
- </refentry>
+ </screen>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Alternativ <function>mysql_stat</function> eksempel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$link = mysql_connect('localhost', 'mysql_bruger', 'mysql_kode');
+$result = mysql_query('SHOW VARIABLES', $link);
+while ($row = mysql_fetch_assoc($result)) {
+ echo $row['Variable_name'] . ' = ' . $row['Value'] . "\n";
+}
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+back_log = 50
+basedir = /usr/local/
+bdb_cache_size = 8388600
+bdb_log_buffer_size = 32768
+bdb_home = /var/db/mysql/
+bdb_max_lock = 10000
+bdb_logdir =
+bdb_shared_data = OFF
+bdb_tmpdir = /var/tmp/
+...
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>mysql_get_server_info</function></member>
+ <member><function>mysql_list_processes</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables: