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
| From: | Mads N. Vestergaard | Date: | Sat, 05 Mar 2005 11:02:47 +0000 |
| Subject: | 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 |
||
| Groups: | php.doc.da | ||
| Request: | Send a blank email to doc-da+get-336@lists.php.net to get a copy of this message | ||
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
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:
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: