cvs: phpdoc-de /reference/misc/functions uniqid.xml

samesch Tue Sep 4 15:13:04 2007 UTC Modified files: /phpdoc-de/reference/misc/functions uniqid.xml Log: syncing with EN http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/uniqid.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/misc/functions/uniqid.xml diff -u phpdoc-de/reference/misc/functions/uniqid.xml:1.6 phpdoc-de/reference/misc/functions/uniqid.xml:1.7 --- phpdoc-de/reference/misc/functions/uniqid.xml:1.6 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/uniqid.xml Tue Sep 4 15:13:04 2007 @@ -1,62 +1,127 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.uniqid" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>uniqid</refname> - <refpurpose>Erzeugt eine eindeutige ID</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>string</type><methodname>uniqid</methodname> - <methodparam><type>string</type><parameter>prefix</parameter></methodparam> - <methodparam choice="opt"><type>boolean</type><parameter>lcg</parameter></methodparam> - </methodsynopsis> - <simpara> - <function>uniqid</function> gibt eine eindeutige ID mit Präfix - zurück. Diese basiert auf der aktuellen Zeit in Mikrosekunden. - Das Präfix kann hilfreich sein, wenn sie z. B. auf mehreren - Servern gleichzeitig ID´s erzeugen, was ja im ungünstigsten Fall - zur selben Mikrosekunde geschehen kann. Der - <parameter>prefix</parameter>-Parameter kann bis zu 114 Zeichen - lang sein. - </simpara> - <simpara> - Ist der optionale Parameter <parameter>lcg</parameter> &true;, wird - <function>uniqid</function> am Ende des Rückgabewertes - zusätzliche "LCG"-Zustandswerte anfügen, durch die das Ergebnis - noch eindeutiger wird. - </simpara> - <simpara> - Bei leerem <parameter>prefix</parameter>-Parameter ist der zurück - gegebene String 13 Zeichen lang. Ist der Parameter - <parameter>lcg</parameter> &true;, sind es 23 Zeichen. - </simpara> - <note> - <simpara> - Der <parameter>lcg</parameter>-Parameter ist erst ab PHP 4 - bzw. PHP 3.0.13 und später verfügbar. - </simpara> - </note> - <para> - Wenn sie eindeutige ID´s bzw. eindeutige Token benötigen und - beabsichtigen, diese Token über das Netzwerk an den Benutzer - weiter zu leiten (z.B. als Session-Cookies), ist es ratsam, wenn - sie wie folgt vorgehen: - <informalexample> - <programlisting role="php"> -$token = md5 (uniqid ("")); // kein Zufalls-Anteil = schlecht -$better_token = md5 (uniqid (rand())); // besser, da schwer zu erraten - </programlisting> - </informalexample> - </para> - <simpara> - Hierdurch wird eine 32-Zeichen-ID (128 Bit-Hex-Wert) erzeugt, die - nur sehr schwer vorhersehbar ist. - </simpara> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.12 Maintainer: nobody Status: ready --> +<refentry xml:id="function.uniqid" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>uniqid</refname> + <refpurpose>Erzeugt eine eindeutige ID</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>uniqid</methodname> + <methodparam choice="opt"><type>string</type><parameter>Präfix</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>mehr_entropie</parameter></methodparam> + </methodsynopsis> + <para> + Gibt eine eindeutige ID mit Präfix zurück, die auf der aktuellen Zeit in + Mikrosekunden basiert. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Präfix</parameter></term> + <listitem> + <para> + Kann, z.B. dann hilfreich sein, wenn Sie auf mehreren Hosts + gleichzeitig IDs erzeugen, was im ungünstigsten Fall zur selben + Mikrosekunde geschehen kann. + </para> + <para> + Bei leerem <parameter>Präfix</parameter> ist die zurückgegebene + Zeichenkette 13 Zeichen lang. Falls + <parameter>mehr_entropie</parameter> &true; ist, sind es 23 Zeichen. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mehr_entropie</parameter></term> + <listitem> + <para> + Falls dieser Parameter auf &true; gesetzt ist, wird + <function>uniqid</function> am Ende des Rückgabewertes zusätzliche mit + dem Kongruenzgenerator für Pseudozufallszahlen (Combined Linear + Congruential Generator) erzeugte Entropie anfügen, durch die das + Ergebnis noch eindeutiger werden sollte. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt eine eindeutige ID als Zeichenkette zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + Wenn Sie eine eindeutige ID, bzw. ein eindeutiges Token benötigen und + beabsichtigen, dieses Token über das Netzwerk an den Benutzer weiter zu + leiten (z.B. als Session-Cookies), ist es ratsam, dass Sie wie folgt + vorgehen: + </para> + <para> + Hierdurch wird eine ID mit 32 Zeichen (ein 128 Bit-Hex-Wert) erzeugt, die + nur äußerst schwer vorhersehbar ist. + <example> + <title><function>uniqid</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +// ohne Präfix +// funktioniert nur mit PHP 5 und späteren Versionen +$token = md5(uniqid()); + +// besser, schwierig zu erraten +$besseres_token = md5(uniqid(rand(), true)); +?> +]]> + </programlisting> + </example> + </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>5.0.0</entry> + <entry> + Den Parameter <parameter>Präfix</parameter> optional gemacht + </entry> + </row> + <row> + <entry>4.3.1</entry> + <entry> + Das Limit von 114 Zeichen für <parameter>Präfix</parameter> erhöht + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: