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>
