cynic Wed Jan 24 05:22:06 2001 EDT
Added files:
/phpdoc/cs/language basic-syntax.xml constants.xml
Log:
couple of others in functions dir. should be complete (though translated
from a not-so-up-to-date version) except for strings.xml
Index: phpdoc/cs/language/basic-syntax.xml
+++ phpdoc/cs/language/basic-syntax.xml
<chapter id="language.basic-syntax">
<title>Základní syntaxe</title>
<sect1 id="language.basic-syntax.phpmode">
<title>Opuštění HTML</title>
<para>
Jsou čtyři způsoby jak opustit HTML a vstoupit to "PHP módu":
</para>
<para>
<example>
<title>Způsoby opuštění HTML</title>
<programlisting>
1. <? echo ("toto je nejjednodušší SGML zpracovatelská instrukce\n"); ?>
2. <?php echo("pokud chcete zpracovávat XHTML nebo XML dokumenty, používejte
toto\n"); ?>
3. <script language="php">
echo ("některé editory (například FrontPage) nemají zpracovatelské instrukce v
lásce");
</script>
4. <% echo ("případně můžete používat ASP tagy"); %>
<%= $variable; # toto je zkratka za "<%echo .." %>
</programlisting>
</example>
</para>
<para>
První způsob je dostupný pouze, pokud jsou povoleny krátké tagy. To se dá
udělat
<!-- pomocí funkce <function>short_tags</function>,-->
povolením konfigurační direktivy
<link linkend="ini.short-open-tag">short_open_tag</link> v konfiguračním
souboru PHP, nebo kompilací PHP s <command>configure</command> volbou
--enable-short-tags.
</para>
<para>
Obecně preferovanou metodou je druhý způsob, protože umožňuje snadnou
implementaci dalšího generování XHTML z PHP.
</para>
<para>
Čtvrtý způsob je dostupný, pouze pokud byly povoleny ASP tagy pomocí
konfigurační direktivy <link linkend="ini.asp-tags">asp_tags</link>.
<note>
<para>Podpora ASP tagů byla přidána v 3.0.4.</para>
</note></para>
<para>
Případná bezprostředně následující sekvence konce řádku je součástí
uzavírajícího tagu.
</para>
</sect1>
<sect1 id="language.basic-syntax.instruction-separation">
<title>Oddělování instrukcí</title>
<simpara>
Instrukce se oddělují stejně jako v C nebo Perlu - ukončujte každý výraz
středníkem.
</simpara>
<para>
Uzavírající tag (?>) také implikuje konec výrazu, takže následující
ukázky jsou ekvivalentní:
<informalexample>
<programlisting>
<?php
echo "Toto je test";
?>
<?php echo "Toto je test" ?>
</programlisting>
</informalexample></para></sect1>
<sect1 id="language.basic-syntax.comments">
<title>Komentáře</title>
<para>
PHP podporuje komentářové notace jazyků 'C', 'C++' a Unixového shellu.
Například:
<informalexample><programlisting>
<?php
echo "Toto je test"; // Toto je jednořádkový komentář typu C++
/* Toto je víceřádkový komentář
a ještě jeden komentář */
echo "Toto je další test";
echo "Poslední Test"; # Toto je komentář shellového typu
?>
</programlisting>
</informalexample></para>
<simpara>
Jednořádkové typy komentářů ve skutečnosti komentují do konce řádku nebo
současného bloku PHP kódu, podle toho, co se vyskytuje dřív.
</simpara>
<informalexample><programlisting>
<h1>Toto je <?php # echo "malý";?> příklad.</h1>
<p>Hlavička na předchozím řádku bude 'Toto je příklad'.
</programlisting></informalexample>
<simpara>
Měli byste si dát pozor na vnořování komentářů typu 'C++', ke kterému může
dojít při zakomentování velkých bloků.
</simpara>
<informalexample><programlisting>
<?php
/*
echo "Toto je test"; /* Tento komentář způsobí problém */
*/
?>
</programlisting></informalexample></sect1>
</chapter>
<!-- 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:
-->
Index: phpdoc/cs/language/constants.xml
+++ phpdoc/cs/language/constants.xml
<chapter id="language.constants">
<title>Konstanty</title>
<simpara>
PHP definuje několik konstant, a poskytuje mechanismus pro definici dalších
za běhu. Konstanty se hodně podobají proměnným s výjimkou dvou skutečností:
konstanty se musí definovat pomocí <function>define</function> function, a
nemohou později nabývat jiných hodnot.
</simpara>
<para>
Předdefinované konstanty (dostupné vždy) jsou:
<variablelist>
<varlistentry>
<term>__FILE__</term>
<listitem>
<simpara>
Název souboru skriptu, který je právě čten. Pokud je použita v souboru,
který byl include-ován nebo require-ován, obsahuje název include-ovaného,
ne rodičovského souboru.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>__LINE__</term>
<listitem>
<simpara>
Číslo řádku ve skriptu, který je právě čten. Pokud je použita v
include-ovaném nebo require-ovaném souboru, obsahuje pozici v rámci
tohoto souboru.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>PHP_VERSION</term>
<listitem>
<simpara>
Textové vyjádření verze běžícího PHP parseru, např. '3.0.8-dev'.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>PHP_OS</term>
<listitem>
<simpara>
Název operačního systému, na kterém PHP parser běží, např. 'Linux'.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>TRUE</term>
<listitem>
<simpara>
Pravdivá hodnota.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>FALSE</term>
<listitem>
<simpara>
Nepravdivá hodnota.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_ERROR</term>
<listitem>
<simpara>
Označuje neošetřitelnou chybu jinou než parse error.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_WARNING</term>
<listitem>
<simpara>
Označuje stav, kdy PHP ví, že je něco špatně, ale bude dál pokračovat.
Tyto stavy se dají ošetřit v samotném skriptu. Příkladem by byl neplatný
regexp ve funkci <function>ereg</function>.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_PARSE</term>
<listitem>
<simpara>
Parser se zadávíl neplatnou syntaxí skriptu. Ošetření není možné.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_NOTICE</term>
<listitem>
<simpara>
Došlo k něčemu co by mohlo být chybou. Provádění skriptu pokračuje.
Mezi příklady patří textový index pole neopatřený uvozovkami nebo práce
s proměnnou, která ještě nebyla definována.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>E_ALL</term>
<listitem>
<simpara>
Všechny E_* konstanty shrnuté do jedné. Při použití s
<function>error_reporting</function> způsobí hlášení úplně všech
problému zaregistrovaných PHP.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
E_* konstanty se typicky používají s funkcí
<function>error_reporting</function> nastavení hladiny hlášení chyb. Viz
všechny tyto konstanty v
<link linkend="features.error-handling">Ošetření chyb</link>.
</para>
<para>
Další konstanty můžete definovat pomocí funkce
<function>define</function> function.
</para>
<para>
Všimněte si, že toto jsou konstanty, ne céčkovská makra; konstanty mohou
reprezentovat pouze platná skalární data.
Note that these are constants, not C-style macros; only valid
scalar data may be represented by a constant.
<example>
<title>Definice konstant</title>
<programlisting>
<?php
define("CONSTANT", "Hello world.");
echo CONSTANT; // vytiskne "Hello world."
?>
</programlisting>
</example>
<example>
<title>Použití __FILE__ a __LINE__</title>
<programlisting>
<?php
function report_error($file, $line, $message) {
echo "Došlo k chybě v souboru $file na řádku $line: $message.";
}
report_error(__FILE__,__LINE__, "Něco je špatně!");
?>
</programlisting>
</example></para>
</chapter>
<!-- 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:
-->
