cvs: phpdoc-cs /reference/strings reference.xml /reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml count-chars.xml crc32.xml
crypt.xml

costra Tue Jun 11 17:47:37 2002 EDT Modified files: /phpdoc-cs/reference/strings reference.xml /phpdoc-cs/reference/strings/functions addcslashes.xml addslashes.xml bin2hex.xml count-chars.xml crc32.xml crypt.xml Log: Some updates.

Index: phpdoc-cs/reference/strings/reference.xml diff -u phpdoc-cs/reference/strings/reference.xml:1.2 phpdoc-cs/reference/strings/reference.xml:1.3 --- phpdoc-cs/reference/strings/reference.xml:1.2 Mon Apr 15 18:06:15 2002 +++ phpdoc-cs/reference/strings/reference.xml Tue Jun 11 17:47:36 2002 @@ -6,15 +6,21 @@ <partintro> <simpara> V¹echny tyto funkce rùznými zpùsoby pracují s øetìzci. Nìkteré - specializovanìj¹í funkce najdete v sekcích regulárních výrazù a manipulace s + specializovanìj¹í funkce najdete v sekcích regulárních výrazù a obsluha URL. </simpara> <para> Informace o chování øetìzcù, zvlá¹tì v souvislosti s pou¾itím jednoduchých - uvozovek, dvojitých uvozovek a escape sekvencí viz polo¾ku + uvozovek, dvojitých uvozovek a znakù opatøených zpìtnými lomítky, viz polo¾ky <link linkend="language.types.string">Øetìzce</link> v sekci <link linkend="language.types">Typy</link> tohoto manuálu. + </para> + <para> + Dal¹í informace o mnohem mocnìj¹ím zacházení s øetìzci a obslu¾nými funkcemi + nalezenete v sekcích <link linkend="ref.regex">POSIX funkce pro regulární + výrazy</link> a <link linkend="ref.pcre">Perl kompatibilní funkce + regulárních výrazù</link>. </para> </partintro> Index: phpdoc-cs/reference/strings/functions/addcslashes.xml diff -u phpdoc-cs/reference/strings/functions/addcslashes.xml:1.1 phpdoc-cs/reference/strings/functions/addcslashes.xml:1.2 --- phpdoc-cs/reference/strings/functions/addcslashes.xml:1.1 Sun Apr 14 19:48:04 2002 +++ phpdoc-cs/reference/strings/functions/addcslashes.xml Tue Jun 11 17:47:37 2002 @@ -14,23 +14,58 @@ <methodparam><type>string</type><parameter>charlist</parameter></methodparam> </methodsynopsis> <para> - Vrací øetìzec se zpìtnými lomítky pøed znaky, které jsou vypsány v argumentu - <parameter>charlist</parameter>. XXX Excapes - <literal>\n</literal>, <literal>\r</literal> atd. podobnì jako v C, - znaky s ASCII kódem ni¾¹ím ne¾ 32 a vy¹¹ím ne¾ 126 se pøevedou na - osmièkovou reprezentaci. V <parameter>charlist</parameter> mù¾ete udat - rozsah, napø. "\0..\37", co¾ by XXX escapovao v¹echny znaky s ASCII kódem - mezi 0 a 31. + Vrací øetìzec se zpìtnými lomítky pøed znaky, které jsou vypsány v parametru + <parameter>charlist</parameter>. Dále doplní <literal>\n</literal>, + <literal>\r</literal> atd. podobnì jako v jazyce C, znaky s ASCII kódem ni¾¹ím + ne¾ 32 a vy¹¹ím ne¾ 126 se pøevedou na osmièkovou reprezentaci. + </para> + <para> + Pokud zvolíte oescapovat znaky 0, a, b, f, n, r, + t a v, budou konvertovány na \0, \a, \b, \f, \n, \r, \t + a \v. + V PHP \0 (&null;), \r (carriage return), \n (nový øádek) a \t (tab) + jsou pøeddefinované escape sekvence, while in C all of these are + predefined escape sequences. + </para> + <para> + V <parameter>charlist</parameter> mù¾ete udat rozsah, napø. "\0..\37", + co¾ by escapovalo v¹echny znaky s ASCII kódem mezi 0 a 31. <example> <title>Ukázka <function>addcslashes</function></title> <programlisting role="php"> +<![CDATA[ $escaped = addcslashes ($not_escaped, "\0..\37!@\177..\377"); +]]> </programlisting> </example> - <note> - <simpara> - Pøidáno v PHP4b3-dev.</simpara> - </note> + </para> + <para> + Pakli¾e uvádíte sekvenci znakù v parametru <parameter>charlist</parametr> + ujistìte se, ¾e víte které dal¹í znaky jdou mezi znaky, je¾ jsou uvedeny + na zaèátku a na konci rozsahu. + <informalexample> + <programlisting role="php"> +<![CDATA[ +echo addcslashes('foo[ ]', 'A..z'); +// Výstup: \f\o\o\[ \] +// V¹echny velké i malé znaky budou escapovány +// ... but so will the [\]^_` and any tabs, line +// feeds, carriage returns, etc. +]]> + </programlisting> + </informalexample> + Také pokud první znak v rozsahu má ni¾¹í ASCII hodnotu ne¾ druhý znak v rozsahu, + nebude ¾ádný rozsah vytvoøen. Pouze znkay zaèáteèní, koncové a v periodì + budou escapovány. Pou¾ijte funkci <function>ord</function> k zji¹tìní ASCII hodnoty + znakù. + <informalexample> + <programlisting role="php"> +<![CDATA[ +echo addcslashes("zoo['.']", 'z..A'); +// Výstup: \zoo['\.'] +]]> + </programlisting> + </informalexample> </para> <para> Viz také: <function>stripcslashes</function>, Index: phpdoc-cs/reference/strings/functions/addslashes.xml diff -u phpdoc-cs/reference/strings/functions/addslashes.xml:1.1 phpdoc-cs/reference/strings/functions/addslashes.xml:1.2 --- phpdoc-cs/reference/strings/functions/addslashes.xml:1.1 Sun Apr 14 19:48:04 2002 +++ phpdoc-cs/reference/strings/functions/addslashes.xml Tue Jun 11 17:47:37 2002 @@ -13,11 +13,16 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> - Vrací øetìzec se zpìtnými lomítky pøed znaky, které potøebují XXX be quoted + Vrací øetìzec se zpìtnými lomítky pøed znaky, které by ohly být problémové v databázových dotazech apod. Tyto znaky jsou jednoduchá uvozovka (<literal>'</literal>), dvojitá uvozovka (<literal>"</literal>), zpìtné lomítko (<literal>\</literal>) a NUL (&null; byte). </para> + <note> + <para> + <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> výchozí hodnota je ON. + </para> + </note> <para> Viz také: <function>stripslashes</function>, <function>htmlspecialchars</function> a Index: phpdoc-cs/reference/strings/functions/bin2hex.xml diff -u phpdoc-cs/reference/strings/functions/bin2hex.xml:1.1 phpdoc-cs/reference/strings/functions/bin2hex.xml:1.2 --- phpdoc-cs/reference/strings/functions/bin2hex.xml:1.1 Sun Apr 14 19:48:04 2002 +++ phpdoc-cs/reference/strings/functions/bin2hex.xml Tue Jun 11 17:47:37 2002 @@ -13,9 +13,12 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> - Vrací ASCII øetìec obsahující hexadecimální reprezentaci + Vrací ASCII øetìzec obsahující hexadecimální reprezentaci <parameter>str</parameter>. Konverze probíhá po bytech, horní slabika první. + </para> + <para> + Dále také <function>pack</function> a <function>unpack</function>. </para> </refsect1> </refentry> Index: phpdoc-cs/reference/strings/functions/count-chars.xml diff -u phpdoc-cs/reference/strings/functions/count-chars.xml:1.1 phpdoc-cs/reference/strings/functions/count-chars.xml:1.2 --- phpdoc-cs/reference/strings/functions/count-chars.xml:1.1 Sun Apr 14 19:48:06 2002 +++ phpdoc-cs/reference/strings/functions/count-chars.xml Tue Jun 11 17:47:37 2002 @@ -11,7 +11,7 @@ <methodsynopsis> <type>mixed</type><methodname>count_chars</methodname> <methodparam><type>string</type><parameter>string</parameter></methodparam> - <methodparam choice="opt"><type></type><parameter> + <methodparam choice="opt"><type>int</type><parameter> mode </parameter></methodparam> </methodsynopsis> @@ -51,11 +51,6 @@ </listitem> </itemizedlist> </para> - <note> - <para> - Tato funkce byla pøidána v PHP 4.0. - </para> - </note> </refsect1> </refentry> Index: phpdoc-cs/reference/strings/functions/crc32.xml diff -u phpdoc-cs/reference/strings/functions/crc32.xml:1.1 phpdoc-cs/reference/strings/functions/crc32.xml:1.2 --- phpdoc-cs/reference/strings/functions/crc32.xml:1.1 Sun Apr 14 19:48:06 2002 +++ phpdoc-cs/reference/strings/functions/crc32.xml Tue Jun 11 17:47:37 2002 @@ -4,7 +4,7 @@ <refentry id="function.crc32"> <refnamediv> <refname>crc32</refname> - <refpurpose>Spoèítat crc32 XXX polynomial øetìzce</refpurpose> + <refpurpose>Spoèítat kontrolní souèet crc32 øetìzce</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -13,7 +13,7 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> </methodsynopsis> <para> - Generuje 32bitový XXX polynomial kontrolního souètu pro + Generuje 32bitový polynomický kontrolní souèet pro <parameter>str</parameter>. Obvykle se pou¾ívá ke kontrole integrity pøená¹ených dat. </para> Index: phpdoc-cs/reference/strings/functions/crypt.xml diff -u phpdoc-cs/reference/strings/functions/crypt.xml:1.1 phpdoc-cs/reference/strings/functions/crypt.xml:1.2 --- phpdoc-cs/reference/strings/functions/crypt.xml:1.1 Sun Apr 14 19:48:06 2002 +++ phpdoc-cs/reference/strings/functions/crypt.xml Tue Jun 11 17:47:37 2002 @@ -4,7 +4,7 @@ <refentry id="function.crypt"> <refnamediv> <refname>crypt</refname> - <refpurpose>Za¹ifrovat øetìzec algoritmem DES</refpurpose> + <refpurpose>Jednosmìrné za¹ifrování øetìzce</refpurpose> </refnamediv> <refsect1> <title>Popis</title> @@ -15,68 +15,93 @@ </methodsynopsis> <para> <function>crypt</function> za¹ifruje øetìzec pomocí standardní Unixovské - ¹ifrovací metody <abbrev>DES</abbrev>. Argumenty jsou øetìzec k za¹ifrování - a volitelný dvouznakový XXX salt, na kterém se ¹ifrování zalo¾í. - Více informací viz Unixovská man stránka va¹í crypt funkce. + ¹ifrovací metody <abbrev>DES</abbrev> nebo alternativního algoritmu dostupného + v operaèním systému. Argumenty jsou øetìzec k za¹ifrování + a volitelný dvouznakový øetìzec salt, na kterém se ¹ifrování zalo¾í. + Více informací naleznete v Unixovské man stránce va¹í crypt funkce. </para> <simpara> - Pokud není poskytnut XXX salt argument, PHP jej náhodnì vygeneruje. + Není-li uveden <argument>salt</argument>, PHP jej náhodnì vygeneruje. </simpara> <simpara> Nìkteré operaèní systémy podporují více typù ¹ifrování. Nìkdy se standardní DES ¹ifrování nahrazuje ¹ifrovacím algoritmem zalo¾eným na MD5. Typ - ¹ifrování se zvolí podle XXX salt argumentu. Pøi instalaci PHP zjistí - schopnosti funkce crypt a XXX bude pøijímat XXX salt pro jiné typy - ¹ifrování. Pøi absenci XXX salt PHP defaultnì automaticky vygeneruje - standardní dvouznakový DES XXX salt, nicménì pokud je defaultním typem - ¹ifrování na daném systému MD5, vygeneruje náhodný XXX salt kompatibilní s - MD5. PHP vytváøí konstantu CRYPT_SALT_LENGTH, která vám øekne, jestli se na - vá¹ systém hodí bì¾ný dvouznakový XXX salt nebo del¹í dvanáctiznakový MD5 - XXX salt. - </simpara> - <simpara> - Pokud pou¾íváte poskytnutý XXX salt, mìli byste si být vìdomi toho, ¾e se - generuje jednou. Pokud tuto funkci voláte rekurzivnì, mù¾e to mít úèinek na - vzhled, a, do urèité míry, bezpeènost. - </simpara> - <simpara> - U standardního DES ¹ifrování <function>crypt</function> pøidá XXX salt jako - první dva znaky výstupu. + ¹ifrování se zvolí podle argumentu salt. PHP zjistí pèi instalaci + schopnosti funkce crypt a bude pøijímat salt pro dal¹í typy + ¹ifrování. Pøi absenci salt PHP automaticky vygeneruje standardní dvouznakový + DES salt a v pøípadì, ¾e je výchozím typem ¹ifrování na daném systému MD5, + vygeneruje náhodný salt kompatibilní s MD5. + PHP vytváøí konstantu CRYPT_SALT_LENGTH, která vám øekne, jestli se na + vá¹ systém hodí bì¾ný dvouznakový salt nebo del¹í dvanáctiznakový MD5 + salt. + </simpara> + <simpara> + Pou¾íváte-li poskytnutý salt, mìli byste si být vìdomi toho, ¾e se + generuje jen jednou. Pokud tuto funkci voláte rekurzivnì, mù¾e to mít + úèinek na vzhled a bezpeènost. + </simpara> + <simpara> + U standardního DES ¹ifrování <function>crypt</function> vrací salt jako + první dva znaky výstupu. K tomu také pou¾ívá jen prvních osum znakù z + <parameter>str</parameter>, tak¾e del¹í øetìzce, ktewré zaèínají osmi + stejnými znaky budou generovat i stejný výsledek (kdy¾ je pou¾it stejný + salt). </simpara> <simpara> Na systémech, kde funkce <function>crypt()</function> podporuje více typù - ¹ifrování se následující konstanty nastaví na 0 nebo 1 podle toho, jestli + ¹ifrování se následující konstanty nastaví na 0 nebo 1 podle toho, zda je daný typ dostupný: </simpara> <itemizedlist> <listitem> <simpara> - CRYPT_STD_DES - Standardní DES ¹ifrování s dvouznakovým XXX SALT + CRYPT_STD_DES - Standardní DES ¹ifrování s dvouznakovým SALT </simpara> </listitem> <listitem> <simpara> - CRYPT_EXT_DES - Roz¹íøené DES ¹ifrování s devítiznakovým XXX SALT + CRYPT_EXT_DES - Roz¹íøené DES ¹ifrování s devítiznakovým SALT </simpara> </listitem> <listitem> <simpara> - CRYPT_MD5 - MD5 ¹ifrování s dvanáctiznakovým XXX SALT zaèínajícím $1$ + CRYPT_MD5 - MD5 ¹ifrování s dvanáctiznakovým SALT zaèínajícím $1$ </simpara> </listitem> <listitem> <simpara> - CRYPT_BLOWFISH - Roz¹íøené DES ¹ifrování s ¹estnáctiznakovým XXX SALT + CRYPT_BLOWFISH - Roz¹íøené DES ¹ifrování s ¹estnáctiznakovým SALT zaèínajícím $2$ </simpara> </listitem> </itemizedlist> + <note> <simpara> Neexistuje ¾ádná decrypt funkce, proto¾e <function>crypt</function> pou¾ívá jednosmìrný algoritmus. </simpara> + </note> + <example> + <title><function>crypt</function> pøíklad</title> + <programlisting role="php"> +<![CDATA[ +<?php +$heslo = crypt("MePrvniHeslo"); # necháme vygenerovat salt +# Mohli byste narazit na problémy pøi úplném výsledku crypt() jako salt pro +# porovnání hesla, pokud jsou pou¾ity rozdílné ¹ifrovací algoritmy. (jak bylo +# øeèeno vý¹e, standardní DES ¹ifrování pou¾ívá dvouznakový salt, ale MD5 +# ¹ifrování pou¾ívá dvanáctiznakový. +if (crypt($uziv_vstup, $heslo) == $heslo) { + echo "Heslo ovìøeno!"; +} +?> +]]> + </programlisting> + </example> + <simpara> - Viz také: <function>md5</function>. + Dále také <function>md5</function> a + <link linkend="ref.mcrypt">Mcrypt pøíkazy</link>. </simpara> </refsect1> </refentry>