cvs: phpdoc-de /reference/misc/functions exit.xml get-browser.xml
| From: | Martin Samesch | Date: | Mon, 13 Aug 2007 21:44:15 +0000 |
| Subject: | cvs: phpdoc-de /reference/misc/functions exit.xml get-browser.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2224@lists.php.net to get a copy of this message | ||
samesch Mon Aug 13 21:44:15 2007 UTC
Modified files:
/phpdoc-de/reference/misc/functions exit.xml get-browser.xml
Log:
syncing with EN
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/exit.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/misc/functions/exit.xml diff -u phpdoc-de/reference/misc/functions/exit.xml:1.5 phpdoc-de/reference/misc/functions/exit.xml:1.6 --- phpdoc-de/reference/misc/functions/exit.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/exit.xml Mon Aug 13 21:44:14 2007 @@ -1,26 +1,127 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.exit" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>exit</refname> - <refpurpose>Beenden des aktuellen Skripts</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>void</type><methodname>exit</methodname> - <void/> - </methodsynopsis> - <simpara> - Mit <function>exit</function> beenden sie - ohne - Möglichkeit der Rückkehr - die Skriptausführung. - </simpara> - <simpara> - Beachten sie auch die Funktion <function>die</function>. - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.16 Maintainer: nobody Status: ready --> +<refentry xml:id="function.exit" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>exit</refname> + <refpurpose>Gibt eine Meldung aus und beendet das aktuelle Skript</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>exit</methodname> + <methodparam choice="opt"><type>string</type><parameter>Status</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>exit</methodname> + <methodparam><type>int</type><parameter>Status</parameter></methodparam> + </methodsynopsis> + <para> + Beendet die Ausführung des Skripts. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Status</parameter></term> + <listitem> + <para> + Falls <parameter>Status</parameter> eine Zeichenkette ist, gibt diese + Funktion beim Beenden den <parameter>Status</parameter> aus. + </para> + <para> + Falls <parameter>Status</parameter> eine <type>Ganzzahl</type> ist, + wird dieser Wert als Exit-Status verwendet. Ein Exit-Status sollte im + Bereich von 0 bis 254 liegen, weil der Exit-Status 255 von PHP + reserviert ist und deshalb nicht benutzt werden sollte. Der Status 0 + wird verwendet, um ein Programm erfolgreich zu beenden. + </para> + <note> + <simpara> + Falls <parameter>Status</parameter> eine <type>Ganzzahl</type> ist, + wird er von PHP >= 4.2.0 NICHT ausgegeben. + </simpara> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>exit</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$dateiname = '/pfad/zur/datei'; +$datei = fopen($dateiname, 'r') + or exit("kann Datei $dateiname nicht öffnen"); + +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>exit</function>-Status Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// das Programm normal beenden +exit; +exit(); +exit(0); + +// das Programm mit einem Fehlercode beenden +exit(1); +exit(0376); // oktal + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + + ¬e.language-construct; + + <note> + <para> + Dieses Sprachkonstrukt entspricht <function>die</function>. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>register_shutdown_function</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/get-browser.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/misc/functions/get-browser.xml diff -u phpdoc-de/reference/misc/functions/get-browser.xml:1.5 phpdoc-de/reference/misc/functions/get-browser.xml:1.6 --- phpdoc-de/reference/misc/functions/get-browser.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/get-browser.xml Mon Aug 13 21:44:14 2007 @@ -1,107 +1,180 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.get-browser" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>get_browser</refname> - <refpurpose> - Ermittelt die Möglichkeiten des Browsers eines Benutzers - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>object</type><methodname>get_browser</methodname> - <methodparam choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>get_browser</function> ermittelt die Möglichkeiten des - auf das PHP-Skript zugreifenden Browsers. Dies geschieht durch - Auslesen der zum Browser vorhandenen Werte aus der Datei - <filename>browscap.ini</filename>. Per Voreinstellung wird der - Wert von $HTTP_USER_AGENT als Browser-Typ benutzt. Dieses - Verhalten können sie ändern (so z.B. den Namen der INI-Datei), - indem sie den optionalen - <parameter>user_agent</parameter>-Parameter an die - <function>get_browser</function>-Funktion übergeben. - </simpara> - <simpara> - Die zurück gegebene Information ist ein Objekt, das verschiedene - Datenelemente enthält. Dazu gehören z.B. die Haupt- und - Unterversions-Nummer des Browsers sowie &true; / false-Werte für - Browser-<emphasis>Fähigkeiten</emphasis> (u.a. Frame-, Java- und - Cookies-Unterstützung). Nicht gemeint ist hier die aktuell - vorhandene Nutzung. Ist der Browser so konfiguriert, dass er - z.Zt. keine Cookies annehmen soll, wird trotzdem &true; in Bezug - auf die Cookie-Fähigkeiten zurückgegeben, wenn in der Datei - <filename>browscap.ini</filename> der entsprechende Wert &true; - ist. - </simpara> - <simpara> - Da in <filename>browscap.ini</filename> Informationen vieler - Browser stehen, obliegt es dem Skript-Schreiber, diese Datei auf - dem Laufenden zu halten. Das Format dieser Datei sollte - selbsterklärend sein. - </simpara> - <para> - Das folgende Beispiel zeigt, wie man alle verfügbaren - Informationen zu einem gerade benutzten Browser anzeigen könnte: - <example> - <title><function>get_browser</function>-Beispiel:</title> - <programlisting role="php"> -<?php -function list_array ($array) { - while (list ($key, $value) = each ($array)) { - $str .= "<b>$key:</b> $value<br>\n"; - } - return $str; -} -echo "$HTTP_USER_AGENT<hr>\n"; -$browser = get_browser(); -echo list_array ((array) $browser); -?> - </programlisting> - </example> - </para> - <simpara> - Die Ausgabe des obigen Skripts könnte so aussehen: - </simpara> - <programlisting> -Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr> -<b>browser_name_pattern:</b> Mozilla/4\.5.*<br> -<b>parent:</b> Netscape 4.0<br> -<b>platform:</b> Unknown<br> -<b>majorver:</b> 4<br> -<b>minorver:</b> 5<br> -<b>browser:</b> Netscape<br> -<b>version:</b> 4<br> -<b>frames:</b> 1<br> -<b>tables:</b> 1<br> -<b>cookies:</b> 1<br> -<b>backgroundsounds:</b> <br> -<b>vbscript:</b> <br> -<b>javascript:</b> 1<br> -<b>javaapplets:</b> 1<br> -<b>activexcontrols:</b> <br> -<b>beta:</b> <br> -<b>crawler:</b> <br> -<b>authenticodeupdate:</b> <br> -<b>msn:</b> <br> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: nobody Status: ready --> +<refentry xml:id="function.get-browser" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>get_browser</refname> + <refpurpose>Ermittelt die Fähigkeiten des Browsers eines Benutzers</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>get_browser</methodname> + <methodparam choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return_array</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion versucht die Fähigkeiten des Browsers des Benutzers zu + ermitteln, indem sie die Informationen über den Browser aus der Datei + <filename>browscap.ini</filename> ausliest. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>user_agent</parameter></term> + <listitem> + <para> + Der User-Agent, der analysiert werden soll. Per Voreinstellung wird der + Wert des HTTP User-Agent-Headers verwendet, jedoch können Sie das + ändern, d.h. Informationen über einen anderen Browser nachschlagen, + indem Sie diesen Parameter übegeben. + </para> + <para> + Dieser Parameter kann mit einem &null;-Wert umgangen werden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>return_array</parameter></term> + <listitem> + <para> + Falls dieser Parameter auf &true; gesetzt wird, gibt diese Funktion + statt eines <type>Objekts</type> ein <type>Array</type> zurück. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Informationen werden in einem Objekt oder Array zurückgegeben, das + verschiedene Datenelemente enthält. Dazu gehören z.B. die Haupt- und + Unterversions-Nummer und Kennung des Browsers sowie &true;/&false;-Werte + für dessen Fähigkeiten, wie z.B. Frames, JavaScript, Cookies usw. + </para> + <para> + Der Wert von <literal>cookies</literal> sagt nur etwas darüber aus, ob der + Browser an sich in der Lage ist Cookies anzunehmen, und nicht darüber, ob + der Benutzer die Annahme von Cookies aktiviert hat. Die einzige + Möglichkeit zu testen, ob Cookies akzeptiert werden, besteht darin, mittels + <function>setcookie</function> ein Cookie zu setzen, die Seite neu zu laden + und dessen Wert zu überprüfen. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.2</entry> + <entry> + Der optionale Parameter <parameter>return_array</parameter> wurde + hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title> + Auflistung aller Informationen über den Browser des Benutzers + </title> + <programlisting role="php"> +<![CDATA[ +<?php +echo $_SERVER['HTTP_USER_AGENT'] . "\n\n"; + +$browser = get_browser(null, true); +print_r($browser); +?> +]]> </programlisting> - <simpara> - Damit dieses Skript richtig funktioniert, muss die <link - linkend="ini.sect.browscap">browscap</link>-Einstellung ihrer - Konfigurations-Datei auf die richtige - <filename>browscap.ini</filename>-Datei zeigen. - </simpara> - <simpara> - Weitere Informationen (incl. Bezugsquellen für - <filename>browscap.ini</filename>-Dateien) finden sie in der - PHP-FAQ unter <link - xlink:href="&url.php.faq;">&url.php.faq;</link>. - </simpara> - </refsect1> - </refentry> + &example.outputs.similar; + <screen> +<![CDATA[ +Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040803 Firefox/0.9.3 + +Array +( + [browser_name_regex] => ^mozilla/5\.0 (windows; .; windows nt 5\.1; .*rv:.*) gecko/.* firefox/0\.9.*$ + [browser_name_pattern] => Mozilla/5.0 (Windows; ?; Windows NT 5.1; *rv:*) Gecko/* Firefox/0.9* + [parent] => Firefox 0.9 + [platform] => WinXP + [browser] => Firefox + [version] => 0.9 + [majorver] => 0 + [minorver] => 9 + [css] => 2 + [frames] => 1 + [iframes] => 1 + [tables] => 1 + [cookies] => 1 + [backgroundsounds] => + [vbscript] => + [javascript] => 1 + [javaapplets] => 1 + [activexcontrols] => + [cdf] => + [aol] => + [beta] => 1 + [win16] => + [crawler] => + [stripper] => + [wap] => + [netclr] => +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Damit es richtig funktioniert, muss die <link + linkend="ini.browscap">browscap</link>-Einstellung Ihrer &php.ini; auf die + richtige <filename>browscap.ini</filename>-Datei Ihres Systems zeigen. + </para> + <para> + <filename>browscap.ini</filename> ist nicht Bestandteil von PHP, aber eine + aktuelle <link + xlink:href="&url.browscap.download;">php_browscap.ini</link> bekommen Sie + hier. + </para> + <para> + Da die <filename>browscap.ini</filename> Informationen zu vielen Browsern + enthält, obliegt es dem Skript-Schreiber, diese Datei auf dem Laufenden zu + halten. Das Format dieser Datei sollte selbsterklärend sein. + </para> + </note> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables:
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/exit.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/misc/functions/exit.xml diff -u phpdoc-de/reference/misc/functions/exit.xml:1.5 phpdoc-de/reference/misc/functions/exit.xml:1.6 --- phpdoc-de/reference/misc/functions/exit.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/exit.xml Mon Aug 13 21:44:14 2007 @@ -1,26 +1,127 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.exit" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>exit</refname> - <refpurpose>Beenden des aktuellen Skripts</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>void</type><methodname>exit</methodname> - <void/> - </methodsynopsis> - <simpara> - Mit <function>exit</function> beenden sie - ohne - Möglichkeit der Rückkehr - die Skriptausführung. - </simpara> - <simpara> - Beachten sie auch die Funktion <function>die</function>. - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.16 Maintainer: nobody Status: ready --> +<refentry xml:id="function.exit" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>exit</refname> + <refpurpose>Gibt eine Meldung aus und beendet das aktuelle Skript</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>exit</methodname> + <methodparam choice="opt"><type>string</type><parameter>Status</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>exit</methodname> + <methodparam><type>int</type><parameter>Status</parameter></methodparam> + </methodsynopsis> + <para> + Beendet die Ausführung des Skripts. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Status</parameter></term> + <listitem> + <para> + Falls <parameter>Status</parameter> eine Zeichenkette ist, gibt diese + Funktion beim Beenden den <parameter>Status</parameter> aus. + </para> + <para> + Falls <parameter>Status</parameter> eine <type>Ganzzahl</type> ist, + wird dieser Wert als Exit-Status verwendet. Ein Exit-Status sollte im + Bereich von 0 bis 254 liegen, weil der Exit-Status 255 von PHP + reserviert ist und deshalb nicht benutzt werden sollte. Der Status 0 + wird verwendet, um ein Programm erfolgreich zu beenden. + </para> + <note> + <simpara> + Falls <parameter>Status</parameter> eine <type>Ganzzahl</type> ist, + wird er von PHP >= 4.2.0 NICHT ausgegeben. + </simpara> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>exit</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +$dateiname = '/pfad/zur/datei'; +$datei = fopen($dateiname, 'r') + or exit("kann Datei $dateiname nicht öffnen"); + +?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title><function>exit</function>-Status Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// das Programm normal beenden +exit; +exit(); +exit(0); + +// das Programm mit einem Fehlercode beenden +exit(1); +exit(0376); // oktal + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + + ¬e.language-construct; + + <note> + <para> + Dieses Sprachkonstrukt entspricht <function>die</function>. + </para> + </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>register_shutdown_function</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/get-browser.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/misc/functions/get-browser.xml diff -u phpdoc-de/reference/misc/functions/get-browser.xml:1.5 phpdoc-de/reference/misc/functions/get-browser.xml:1.6 --- phpdoc-de/reference/misc/functions/get-browser.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/get-browser.xml Mon Aug 13 21:44:14 2007 @@ -1,107 +1,180 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.get-browser" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <refnamediv> - <refname>get_browser</refname> - <refpurpose> - Ermittelt die Möglichkeiten des Browsers eines Benutzers - </refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>object</type><methodname>get_browser</methodname> - <methodparam choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>get_browser</function> ermittelt die Möglichkeiten des - auf das PHP-Skript zugreifenden Browsers. Dies geschieht durch - Auslesen der zum Browser vorhandenen Werte aus der Datei - <filename>browscap.ini</filename>. Per Voreinstellung wird der - Wert von $HTTP_USER_AGENT als Browser-Typ benutzt. Dieses - Verhalten können sie ändern (so z.B. den Namen der INI-Datei), - indem sie den optionalen - <parameter>user_agent</parameter>-Parameter an die - <function>get_browser</function>-Funktion übergeben. - </simpara> - <simpara> - Die zurück gegebene Information ist ein Objekt, das verschiedene - Datenelemente enthält. Dazu gehören z.B. die Haupt- und - Unterversions-Nummer des Browsers sowie &true; / false-Werte für - Browser-<emphasis>Fähigkeiten</emphasis> (u.a. Frame-, Java- und - Cookies-Unterstützung). Nicht gemeint ist hier die aktuell - vorhandene Nutzung. Ist der Browser so konfiguriert, dass er - z.Zt. keine Cookies annehmen soll, wird trotzdem &true; in Bezug - auf die Cookie-Fähigkeiten zurückgegeben, wenn in der Datei - <filename>browscap.ini</filename> der entsprechende Wert &true; - ist. - </simpara> - <simpara> - Da in <filename>browscap.ini</filename> Informationen vieler - Browser stehen, obliegt es dem Skript-Schreiber, diese Datei auf - dem Laufenden zu halten. Das Format dieser Datei sollte - selbsterklärend sein. - </simpara> - <para> - Das folgende Beispiel zeigt, wie man alle verfügbaren - Informationen zu einem gerade benutzten Browser anzeigen könnte: - <example> - <title><function>get_browser</function>-Beispiel:</title> - <programlisting role="php"> -<?php -function list_array ($array) { - while (list ($key, $value) = each ($array)) { - $str .= "<b>$key:</b> $value<br>\n"; - } - return $str; -} -echo "$HTTP_USER_AGENT<hr>\n"; -$browser = get_browser(); -echo list_array ((array) $browser); -?> - </programlisting> - </example> - </para> - <simpara> - Die Ausgabe des obigen Skripts könnte so aussehen: - </simpara> - <programlisting> -Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)<hr> -<b>browser_name_pattern:</b> Mozilla/4\.5.*<br> -<b>parent:</b> Netscape 4.0<br> -<b>platform:</b> Unknown<br> -<b>majorver:</b> 4<br> -<b>minorver:</b> 5<br> -<b>browser:</b> Netscape<br> -<b>version:</b> 4<br> -<b>frames:</b> 1<br> -<b>tables:</b> 1<br> -<b>cookies:</b> 1<br> -<b>backgroundsounds:</b> <br> -<b>vbscript:</b> <br> -<b>javascript:</b> 1<br> -<b>javaapplets:</b> 1<br> -<b>activexcontrols:</b> <br> -<b>beta:</b> <br> -<b>crawler:</b> <br> -<b>authenticodeupdate:</b> <br> -<b>msn:</b> <br> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: nobody Status: ready --> +<refentry xml:id="function.get-browser" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> + <refnamediv> + <refname>get_browser</refname> + <refpurpose>Ermittelt die Fähigkeiten des Browsers eines Benutzers</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>get_browser</methodname> + <methodparam choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>return_array</parameter></methodparam> + </methodsynopsis> + <para> + Diese Funktion versucht die Fähigkeiten des Browsers des Benutzers zu + ermitteln, indem sie die Informationen über den Browser aus der Datei + <filename>browscap.ini</filename> ausliest. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>user_agent</parameter></term> + <listitem> + <para> + Der User-Agent, der analysiert werden soll. Per Voreinstellung wird der + Wert des HTTP User-Agent-Headers verwendet, jedoch können Sie das + ändern, d.h. Informationen über einen anderen Browser nachschlagen, + indem Sie diesen Parameter übegeben. + </para> + <para> + Dieser Parameter kann mit einem &null;-Wert umgangen werden. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>return_array</parameter></term> + <listitem> + <para> + Falls dieser Parameter auf &true; gesetzt wird, gibt diese Funktion + statt eines <type>Objekts</type> ein <type>Array</type> zurück. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Die Informationen werden in einem Objekt oder Array zurückgegeben, das + verschiedene Datenelemente enthält. Dazu gehören z.B. die Haupt- und + Unterversions-Nummer und Kennung des Browsers sowie &true;/&false;-Werte + für dessen Fähigkeiten, wie z.B. Frames, JavaScript, Cookies usw. + </para> + <para> + Der Wert von <literal>cookies</literal> sagt nur etwas darüber aus, ob der + Browser an sich in der Lage ist Cookies anzunehmen, und nicht darüber, ob + der Benutzer die Annahme von Cookies aktiviert hat. Die einzige + Möglichkeit zu testen, ob Cookies akzeptiert werden, besteht darin, mittels + <function>setcookie</function> ein Cookie zu setzen, die Seite neu zu laden + und dessen Wert zu überprüfen. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.2</entry> + <entry> + Der optionale Parameter <parameter>return_array</parameter> wurde + hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title> + Auflistung aller Informationen über den Browser des Benutzers + </title> + <programlisting role="php"> +<![CDATA[ +<?php +echo $_SERVER['HTTP_USER_AGENT'] . "\n\n"; + +$browser = get_browser(null, true); +print_r($browser); +?> +]]> </programlisting> - <simpara> - Damit dieses Skript richtig funktioniert, muss die <link - linkend="ini.sect.browscap">browscap</link>-Einstellung ihrer - Konfigurations-Datei auf die richtige - <filename>browscap.ini</filename>-Datei zeigen. - </simpara> - <simpara> - Weitere Informationen (incl. Bezugsquellen für - <filename>browscap.ini</filename>-Dateien) finden sie in der - PHP-FAQ unter <link - xlink:href="&url.php.faq;">&url.php.faq;</link>. - </simpara> - </refsect1> - </refentry> + &example.outputs.similar; + <screen> +<![CDATA[ +Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040803 Firefox/0.9.3 + +Array +( + [browser_name_regex] => ^mozilla/5\.0 (windows; .; windows nt 5\.1; .*rv:.*) gecko/.* firefox/0\.9.*$ + [browser_name_pattern] => Mozilla/5.0 (Windows; ?; Windows NT 5.1; *rv:*) Gecko/* Firefox/0.9* + [parent] => Firefox 0.9 + [platform] => WinXP + [browser] => Firefox + [version] => 0.9 + [majorver] => 0 + [minorver] => 9 + [css] => 2 + [frames] => 1 + [iframes] => 1 + [tables] => 1 + [cookies] => 1 + [backgroundsounds] => + [vbscript] => + [javascript] => 1 + [javaapplets] => 1 + [activexcontrols] => + [cdf] => + [aol] => + [beta] => 1 + [win16] => + [crawler] => + [stripper] => + [wap] => + [netclr] => +) +]]> + </screen> + </example> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <note> + <para> + Damit es richtig funktioniert, muss die <link + linkend="ini.browscap">browscap</link>-Einstellung Ihrer &php.ini; auf die + richtige <filename>browscap.ini</filename>-Datei Ihres Systems zeigen. + </para> + <para> + <filename>browscap.ini</filename> ist nicht Bestandteil von PHP, aber eine + aktuelle <link + xlink:href="&url.browscap.download;">php_browscap.ini</link> bekommen Sie + hier. + </para> + <para> + Da die <filename>browscap.ini</filename> Informationen zu vielen Browsern + enthält, obliegt es dem Skript-Schreiber, diese Datei auf dem Laufenden zu + halten. Das Format dieser Datei sollte selbsterklärend sein. + </para> + </note> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: