luk Sat Mar 2 20:15:48 2002 EDT Modified files: /phpdoc/cs/features error-handling.xml /phpdoc/cs/functions mysql.xml Log: Some fixes: malformed XML and incorrect character encoding
Index: phpdoc/cs/features/error-handling.xml diff -u phpdoc/cs/features/error-handling.xml:1.1 phpdoc/cs/features/error-handling.xml:1.2 --- phpdoc/cs/features/error-handling.xml:1.1 Tue Feb 26 12:57:14 2002 +++ phpdoc/cs/features/error-handling.xml Sat Mar 2 20:15:47 2002 @@ -40,7 +40,7 @@ <entry>8</entry> <entry>E_NOTICE </entry> <entry> - runtimové zprávy (méně váné ne varování) + runtimové zprávy (méně vážné než varování) </entry> <entry></entry> </row> @@ -71,25 +71,25 @@ <row> <entry>256</entry> <entry>E_USER_ERROR</entry> - <entry>uivatelsky generované chybové zprávy</entry> + <entry>uživatelsky generované chybové zprávy</entry> <entry>PHP 4 only</entry> </row> <row> <entry>512</entry> <entry>E_USER_WARNING</entry> - <entry>uivatelsky generovaná varování</entry> + <entry>uživatelsky generovaná varování</entry> <entry>PHP 4 only</entry> </row> <row> <entry>1024</entry> <entry>E_USER_NOTICE </entry> - <entry>uivatelsky generované informativní zprávy</entry> + <entry>uživatelsky generované informativní zprávy</entry> <entry>PHP 4 only</entry> </row> <row> <entry></entry> <entry>E_ALL</entry> - <entry>vechny z uvedených, které jsou danou verzí PHP podporovány</entry> + <entry>všechny z uvedených, které jsou danou verzí PHP podporovány</entry> <entry></entry> </row> </tbody> @@ -98,33 +98,33 @@ </para> <para> - Výe uvedené hodnoty (a ji číselné nebo symbolické) se pouívají + Výše uvedené hodnoty (ať již číselné nebo symbolické) se používají pro sestavení bitové masky, která specifikuje, které chyby se mají - oznamovat. Můete pouívat + oznamovat. Můžete používat <link linkend="language.operators.bitwise">bitové logické operátory</link> pro kombinaci hodnot nebo maskování určitých druhů chyb. Uvědomte si, - e v souboru <filename>php.ini</filename> budou správně interpretovány - pouze operátory '|', '~', '!', a '&', a e v - <filename>php3.ini</filename> nelze pouít ádné z těchto operátorů. + že v souboru <filename>php.ini</filename> budou správně interpretovány + pouze operátory '|', '~', '!', a '&', a že v + <filename>php3.ini</filename> nelze použít žádné z těchto operátorů. </para> <para> V PHP 4 je jako implicitní hodnota pro <link linkend="ini.error-reporting">error_reporting</link> nastaveno - <literal>E_ALL & ~E_NOTICE</literal>, tzn. hláení vech chyb + <literal>E_ALL & ~E_NOTICE</literal>, tzn. hlášení všech chyb a varování, které nejsou na úrovni E_NOTICE. V PHP 3 je implicitní - <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>, co znamená - toté. Uvědomte si, e v souboru <filename>php3.ini</filename> - nelze pouívat konstanty, a proto nastavení + <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>, což znamená + totéž. Uvědomte si, že v souboru <filename>php3.ini</filename> + nelze používat konstanty, a proto nastavení <link linkend="ini.error-reporting">error_reporting</link> musí být numerické; tedy například <literal>7</literal>. </para> <para> - Iniciální nastavení můe být v ini souboru změněno direktivou + Iniciální nastavení může být v ini souboru změněno direktivou <link linkend="ini.error-reporting">error_reporting</link>, v serveru Apache v souboru <filename>httpd.conf</filename> direktivou - php_error_reporting (php3_error_reporting v PHP 3), a konečně můe být - té nastaveno skriptem za pouití funkce + php_error_reporting (php3_error_reporting v PHP 3), a konečně může být + též nastaveno skriptem za použití funkce <function>error_reporting</function>. </para> @@ -132,15 +132,15 @@ <para> Pokud upgradujete kód nebo server z PHP 3 na PHP 4, měli byste ověřit tato nastavení a volání <function>error_reporting</function> anebo - potlačit hláení nových typů chyb, zvlátě E_COMPILE_ERROR. To - můe vést k vyprázdnění obsahu dokumentů bez jakékoli informace o tom, + potlačit hlášení nových typů chyb, zvláště E_COMPILE_ERROR. To + může vést k vyprázdnění obsahu dokumentů bez jakékoli informace o tom, co se stalo a kde hledat problém. </para> </warning> <para> - Vechny <link linkend="language.expressions">PHP výrazy</link> mohou - být také volány s prefixem "@", který vypíná hláení chyb pro tento + Všechny <link linkend="language.expressions">PHP výrazy</link> mohou + být také volány s prefixem "@", který vypíná hlášení chyb pro tento jediný výraz. Pokud během provádění výrazu nastane chyba a volba <link linkend="ini.track-errors">track_errors</link> je zapnutá, najdete chybovou zprávu v globální proměnné <literal>$php_errormsg</literal>. @@ -149,7 +149,7 @@ <note> <para> <link linkend="language.operators.errorcontrol">Prefixovým operátorem - řízení chyb @</link> nelze potlačit chybová hláení o syntaktických + řízení chyb @</link> nelze potlačit chybová hlášení o syntaktických chybách. </para> </note> @@ -158,33 +158,33 @@ <para> V současnosti <link linkend="language.operators.errorcontrol">prefixový operátor řízení chyb</link> v případě kritických chyb (které ukončí - provádění skriptu) pouze potlačí chybové hláení. Jinými slovy, - pokud pouijete <link linkend="language.operators.errorcontrol">@</link> + provádění skriptu) pouze potlačí chybové hlášení. Jinými slovy, + pokud použijete <link linkend="language.operators.errorcontrol">@</link> k potlačení chyb z jisté funkce, která není dostupná nebo byla chybně - zapsána, skript zde skončí, ani by indikoval proč. + zapsána, skript zde skončí, aniž by indikoval proč. </para> </warning> <para> - Níe uvedený příklad ukazuje pouití schopností zpracování chyb v PHP. + Níže uvedený příklad ukazuje použití schopností zpracování chyb v PHP. Definujeme funkci zpracování chyb, která zaznamenává informace do souboru - (v XML formátu) a v případě kritické chyby odele e-mailovou zprávu + (v XML formátu) a v případě kritické chyby odešle e-mailovou zprávu vývojáři. <example> - <title>Pouití zpracování chyb ve skriptu</title> + <title>Použití zpracování chyb ve skriptu</title> <programlisting role="php"> <![CDATA[ <?php // uděláme si vlastní zpacování chyb error_reporting(0); -// uivatelsky definovaná funkce pro zpracování chyb +// uživatelsky definovaná funkce pro zpracování chyb function userErrorHandler ($errno, $errmsg, $filename, $linenum, $vars) { - // časové razítko poloky + // časové razítko položky $dt = date("Y-m-d H:i:s (T)"); // definuje asociativní pole pro chybový řetězec - // ve skutečnosti mohou poloky obsahovat pouze + // ve skutečnosti mohou položky obsahovat pouze // hodnoty 2,8,256,512 a 1024 $errortype = array ( 1 => "Error", @@ -199,7 +199,7 @@ 512 => "User Warning", 1024=> "User Notice" ); - // mnoina chyb, pro které bude uloen výpis proměnných + // množina chyb, pro které bude uložen výpis proměnných $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE); $err = "<errorentry>\n"; @@ -217,7 +217,7 @@ // pro testování // echo $err; - // ulo do chybového protokolu a poli mi zprávu (pokud je to kritická chyba) + // ulož do chybového protokolu a pošli mi zprávu (pokud je to kritická chyba) error_log($err, 3, "/usr/local/php4/error.log"); if ($errno == E_USER_ERROR) mail("[EMAIL PROTECTED]","Critical User Error",$err); @@ -263,20 +263,20 @@ $b = array(5.5, 4.3, -1.6); $c = array (1,-3); -// generuje uivatelskou chybu +// generuje uživatelskou chybu $t1 = distance($c,$b)."\n"; -// generuje jinou uivatelskou chybu +// generuje jinou uživatelskou chybu $t2 = distance($b,"i am not an array")."\n"; -// generuje hláení +// generuje hlášení $t3 = distance($a,$b)."\n"; ?> ]]> </programlisting> </example> - Toto je pouze jednoduchý příklad, který ukazuje, jak pouívat + Toto je pouze jednoduchý příklad, který ukazuje, jak používat <link linkend="ref.errorfunc">Funkce pro zpracování a záznam chyb</link>. </para> Index: phpdoc/cs/functions/mysql.xml diff -u phpdoc/cs/functions/mysql.xml:1.1 phpdoc/cs/functions/mysql.xml:1.2 --- phpdoc/cs/functions/mysql.xml:1.1 Tue Feb 26 15:53:00 2002 +++ phpdoc/cs/functions/mysql.xml Sat Mar 2 20:15:48 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.1 $ --> + <reference id="ref.mysql"> <title>MySQL Funkce</title> <titleabbrev>MySQL</titleabbrev> @@ -10,15 +10,14 @@ Mají-li být tyto funkce dostupné, musí být PHP zkompilováno s podporou MySQL parametrem <option role="configure">--with-mysql</option>. Pokud použijete tento parametr bez zadané cesty k MySQL, PHP použije - vestavěné + vestavěné MySQL klient knihovny. Uživatelé, kteří spouští další aplikace používající MySQL (např.: spuštěné PHP3 a PHP4 jako vzájemné moduly v apache či - auth-mysql) + auth-mysql) by měli vždy zadat cestu k MySQL: <option role="configure">--with-mysql=/cesta/k/mysql</option>. PHP tak použije klientské knihovny instalované MySQL, čímž se vyvarujete - možným - konfliktům. + možných konfliktům. </simpara> <simpara> Více informací o MySQL naleznete na <ulink @@ -148,7 +147,8 @@ <note> <para> Používáte-li transakce, je nutné <function>mysql_affected_rows</function> - volat až po dotazu INSERT, UPDATE nebo DELETE, nikoli hned po commitnutí. + volat až po dotazu INSERT, UPDATE nebo DELETE, nikoli hned po potvrzení + transakce. </para> </note> <para> @@ -411,8 +411,7 @@ <methodsynopsis> <type>bool</type><methodname>mysql_data_seek</methodname> - <methodparam><type>zdroj</type><parameter>result_identifier</parameter></method -param> + <methodparam><type>zdroj</type><parameter>result_identifier</parameter></methodparam> <methodparam><type>int</type><parameter>row_number</parameter></methodparam> </methodsynopsis> @@ -574,8 +573,7 @@ <methodsynopsis> <type>bool</type><methodname>mysql_drop_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodpar -am> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> <methodparam choice="opt"><type>zdroj</type><parameter> identifikator_spojeni </parameter></methodparam> @@ -707,8 +705,7 @@ <methodsynopsis> <type>string</type><methodname>mysql_escape_string</methodname> - <methodparam><type>string</type><parameter>unescaped_string</parameter></method -param> + <methodparam><type>string</type><parameter>unescaped_string</parameter></methodparam> </methodsynopsis> <para> This function will escape the <parameter>unescaped_string</parameter>, @@ -1542,8 +1539,7 @@ <methodsynopsis> <type>zdroj</type><methodname>mysql_list_fields</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodpar -am> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> <methodparam><type>string</type><parameter>table_name</parameter></methodparam> <methodparam choice="opt"><type>zdroj</type><parameter> @@ -1720,10 +1716,8 @@ <methodparam choice="opt"><type>string</type><parameter> server </parameter></methodparam> - <methodparam - choice="opt"><type>string</type><parameter>username</parameter></methodparam> - <methodparam - choice="opt"><type>string</type><parameter>password</parameter></methodparam> + <methodparam +choice="opt"><type>string</type><parameter>username</parameter></methodparam> + <methodparam +choice="opt"><type>string</type><parameter>password</parameter></methodparam> </methodsynopsis> <para> Returns a positive MySQL persistent link identifier on success, @@ -1801,8 +1795,7 @@ <type>zdroj</type><methodname>mysql_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> <methodparam - choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></me -thodparam> + +choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></methodparam> </methodsynopsis> <para> <function>mysql_query</function> sends a query to the currently @@ -1911,9 +1904,7 @@ <methodsynopsis> <type>zdroj</type><methodname>mysql_unbuffered_query</methodname> <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam - choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></me -thodparam> + <methodparam +choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></methodparam> </methodsynopsis> <para> <function>mysql_unbuffered_query</function> sends a SQL query @@ -1999,8 +1990,7 @@ <methodsynopsis> <type>bool</type><methodname>mysql_select_db</methodname> - <methodparam><type>string</type><parameter>database_name</parameter></methodpar -am> + <methodparam><type>string</type><parameter>database_name</parameter></methodparam> <methodparam choice="opt"><type>zdroj</type><parameter> identifikator_spojeni </parameter></methodparam> @@ -2099,9 +2089,7 @@ <title>Popis</title> <methodsynopsis> <type>string</type><methodname>mysql_get_host_info</methodname> - <methodparam - choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></me -thodparam> + <methodparam +choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></methodparam> </methodsynopsis> <para> <function>mysql_get_host_info</function> returns a string @@ -2125,9 +2113,7 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mysql_get_proto_info</methodname> - <methodparam - choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></me -thodparam> + <methodparam +choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></methodparam> </methodsynopsis> <para> <function>mysql_get_proto_info</function> returns the protocol @@ -2151,9 +2137,7 @@ <title>Popis</title> <methodsynopsis> <type>int</type><methodname>mysql_get_server_info</methodname> - <methodparam - choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></me -thodparam> + <methodparam +choice="opt"><type>zdroj</type><parameter>identifikator_spojeni</parameter></methodparam> </methodsynopsis> <para> <function>mysql_get_server_info</function> returns the server @@ -2185,8 +2169,5 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: -vim600: syn=xml fen fdm=syntax fdl=2 si -vim: et tw=78 syn=sgml -vi: ts=1 sw=1 -->