cvs: phpdoc /cs/functions mhash.xml

From: Date: Fri, 26 Jan 2001 02:55:58 +0000
Subject: cvs: phpdoc /cs/functions mhash.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333947@lists.php.net to get a copy of this message
cynic Thu Jan 25 18:55:58 2001 EDT Added files: /phpdoc/cs/functions mhash.xml Log: needs some further work (win-1250)

Index: phpdoc/cs/functions/mhash.xml +++ phpdoc/cs/functions/mhash.xml <reference id="ref.mhash"> <title>Mhash funkce</title> <titleabbrev>mhash</titleabbrev> <partintro> <para> Tyto funkce jsou urèeny pro práci s <ulink url="&url.mhash;">mhash</ulink>. </para> <para> Toto je interface ke knihvnì mhash. mhash podporuje širokou škálu hash algoritmù jako napø. MD5, SHA1, GOST a mnoho jiných. </para> <para> Pokud chcete tyto funkce používat, stáhnìte si mhash distribuci z <ulink url="&url.mhash;">its web site</ulink> a postupujte podle pøiložených instrukcí k instalaci. K aktivaci tohoto modulu budete muset zkompilovat PHP s volbou <option role="configure">--with-mhash</option> </para> <para> Mhash se dá použít k vytváøení kontrolních souètù, message digests, message authentication codes, and more. </para> <para> <example> <title>Compute the MD5 digest and hmac and print it out as hex</title> <programlisting role="php"> &lt;?php $input = "what do ya want for nothing?"; $hash = mhash (MHASH_MD5, $input); print "The hash is ".bin2hex ($hash)."\n&lt;br>"; $hash = mhash (MHASH_MD5, $input, "Jefe"); print "The hmac is ".bin2hex ($hash)."\n&lt;br>"; ?&gt; </programlisting> </example> This will produce: <programlisting> The hash is d03cb659cbf9192dcd066272249f8412 The hmac is 750c783e6ab0b503eaa86e310a5db738 </programlisting> Kompletní seznam podporovaných hashù viz dokumentaci mhash. Obecným pravidlem je, že hash algoritmus je dostupný z PHP pomocí MHASH_NAZEVHASHE. Napøíklad TIGER se v PHP používá pomocí konstanty MHASH_TIGER. </para> <para> Zde je seznam hashù podporovaných mhashem v souèasné dobì. Pokud zde není nìkterý hash jmenován, ale v dokumentaci mhashe je uveden jako podporovaný, mùžete bezpeènì pøedpokládat, že je tato dokumentace zastaralá. <itemizedlist> <listitem> <simpara> MHASH_MD5 </simpara> </listitem> <listitem> <simpara> MHASH_SHA1 </simpara> </listitem> <listitem> <simpara> MHASH_HAVAL256 </simpara> </listitem> <listitem> <simpara> MHASH_HAVAL192 </simpara> </listitem> <listitem> <simpara> MHASH_HAVAL160 </simpara> </listitem> <listitem> <simpara> MHASH_HAVAL128 </simpara> </listitem> <listitem> <simpara> MHASH_RIPEMD160 </simpara> </listitem> <listitem> <simpara> MHASH_GOST </simpara> </listitem> <listitem> <simpara> MHASH_TIGER </simpara> </listitem> <listitem> <simpara> MHASH_CRC32 </simpara> </listitem> <listitem> <simpara> MHASH_CRC32B </simpara> </listitem> </itemizedlist> </para> </partintro> <refentry id="function.mhash-get-hash-name"> <refnamediv> <refname>mhash_get_hash_name</refname> <refpurpose>Získat název zadaného hashe</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash_get_hash_name</function></funcdef> <paramdef>int <parameter>hash</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mhash_get_hash_name</function> se používá ke zjištìní názvu zadaného hashe. </para> <para> <function>mhash_get_hash_name</function> pøijímá id hashe jako argument a vrací název tohoto hashe nebo <literal>false</literal>, pokud tento hash neexistuje. </para> <para> <example> <title>Ukázka <function>mhash_get_hash_name</function></title> <programlisting> &lt;?php $hash = MHASH_MD5; print mhash_get_hash_name ($hash); ?&gt; </programlisting> </example> Výše uvedená ukázka vytiskne: <programlisting> MD5 </programlisting> </para> </refsect1> </refentry> <refentry id="function.mhash-get-block-size"> <refnamediv> <refname>mhash_get_block_size</refname> <refpurpose>Získat velikost bloku urèeného hashe</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mhash_get_block_size</function></funcdef> <paramdef>int <parameter>hash</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mhash_get_block_size</function> se používá ke zjištìní velikosti bloku argumentu <parameter>hash</parameter>. </para> <para> <function>mhash_get_block_size</function> pøijímá jeden argument, <parameter>hash</parameter> a vrací velikost v bytech nebo <literal>false</literal>, pokud <parameter>hash</parameter> neexistuje. </para> </refsect1> </refentry> <refentry id="function.mhash-count"> <refnamediv> <refname>mhash_count</refname> <refpurpose>Získat nejvyšší dostupné hash id</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mhash_count</function></funcdef> <paramdef>void </paramdef> </funcprototype> </funcsynopsis> <para> <function>mhash_count</function> vrací nejvyšší dostupné hash id. Hashe jsou èíslované od 0 po toto hash id. </para> <para> <example> <title>Traversing all hashes</title> <programlisting role="php"> &lt;?php $nr = mhash_count(); for ($i = 0; $i &lt;= $nr; $i++) { echo sprintf ("The blocksize of %s is %d\n", mhash_get_hash_name ($i), mhash_get_block_size ($i)); } ?&gt; </programlisting> </example> </para> </refsect1> </refentry> <refentry id="function.mhash"> <refnamediv> <refname>mhash</refname> <refpurpose>Spoèítat hash</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash</function></funcdef> <paramdef>int <parameter>hash</parameter></paramdef> <paramdef>string <parameter>data</parameter></paramdef> <paramdef>string <parameter>[ key ]</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mhash</function> aplikuje hash funkci urèenou argumentem <parameter>hash</parameter> na <parameter>data</parameter> a vrací výsledný hash (také nazývaný digest). Pokud je pøedán <parameter> key</parameter>, vrací výsledný HMAC. HMAC is keyed hashing for message authentication, or simply a message digest that depends on the specified key. Not all algorithms supported in mhash can be used in HMAC mode. In case of an error returns false. </para> </refsect1> </refentry> <refentry id="function.mhash-keygen-s2k"> <refnamediv> <refname>mhash_keygen_s2k</refname> <refpurpose>Vygenerovat klíè</refpurpose> </refnamediv> <refsect1> <title>Popis</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash_keygen_s2k</function></funcdef> <paramdef>int <parameter>hash</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> <paramdef>string <parameter>salt</parameter></paramdef> <paramdef>int <parameter>bytes</parameter></paramdef> </funcprototype> </funcsynopsis> <para> <function>mhash_keygen_s2k</function> generuje klíè, který je <parameter>bytes</parameter> dlouhý, z pøedaného hesla. Toto je Salted S2K algoritmus specifikovaný v OpenPGP dokumentu (RFC 2440). Tento algoritmus použije k vytvoøení klíèe <parameter>hash</parameter> algoritmus. <parameter>salt</parameter> musí být pro každý generovaný klíè jiný a dostateènì náhodný, aby vytvoøil rùzné klíèe. Salt musí být pøi kontrole klíèù znám, tudíž je dobrý nápad ho pøipojit ke klíèi. Salt ma pevnou délku 8 bytù a pokud dodáte ménì bytù, bude doplnìn nulami. Pamatujte, že uživatelsky urèená hesla nejsou vhodná k použití jako klíèe, protože uživatelé obvykle volí klíèe, které mohou napsat na klávesnici. Tato hesla využívají pouze 6 až 7 bytù na znak (nebo ménì). Je velmi vhodné na uživateli urèené klíèe použít nìjakou transformaci (jako je tato funkce). </para> </refsect1> </refentry> </reference> <!-- 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 sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -->
« previous php.doc (#969333947) next »