cvs: phpdoc-ca /language basic-syntax.xml
[email protected] ("Bernat Foj Capell") Fri, 02 Sep 2005 17:28:05 -0000
| Newsgroups | php.doc.ca |
|---|---|
| Message-ID | <cvsjabro1125682085@cvsserver> |
--jabro1125682085
Content-Type: text/plain
jabro Fri Sep 2 13:28:05 2005 EDT
Added files:
/phpdoc-ca/language basic-syntax.xml
Log:
initial translation
--jabro1125682085
Content-Type: text/plain
Content-Disposition: attachment; filename="jabro-20050902132805.txt"
http://cvs.php.net/co.php/phpdoc-ca/language/basic-syntax.xml?r=1.1&p=1
Index: phpdoc-ca/language/basic-syntax.xml
+++ phpdoc-ca/language/basic-syntax.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.46 Maintainer: jabro Status: ready -->
<chapter id="language.basic-syntax">
<title>Sintaxi bàsica</title>
<sect1 id="language.basic-syntax.phpmode">
<title>Escapar de l'HTML</title>
<para>
Quan el PHP analitza un fitxer, cerca marcadors d'obertura i
clausura, els quals indiquen al PHP que comenci o pari
d'interpretar el codi entre ells. Analitzar d'aquesta manera
permet al php ésser incrustat en tot tipus de documents
diferents, atès que tot allò fora dels marcadors d'obertura
i clausura és ignorat per l'analitzador PHP. La majoria del temps
veureu php incrustat en documents HTML, com ara en aquest
exemple.
<informalexample>
<programlisting role="php">
<![CDATA[
<p>Això s'ignorarà.</p>
<?php echo 'Mentre que això s\'analitzarà.'; ?>
<p>Això també s'ignorarà.</p>
]]>
</programlisting>
</informalexample>
</para>
<para>
Podeu utilitzar també estructures més avançades:
<example>
<title>Escapament avançat</title>
<programlisting role="php">
<![CDATA[
<?php
if ($expression) {
?>
<strong>Això és cert.</strong>
<?php
} else {
?>
<strong>Això és fals.</strong>
<?php
}
?>
]]>
</programlisting>
</example>
Això funciona com és d'esperar, perquè quan el PHP troba el marcador
?> de clausura, simplement comença a treure qualsevol cosa que
trobi fins que hi hagi un altre marcador d'obertura. L'exemple
donat és artificiós, per descomptat, però per treure grans
blocs de text, sortir del mode d'anàlisi de PHP és generalment
més eficient que enviar tot el text a través d'<function>echo</function>
o bé <function>print</function>.
</para>
<para>
Hi ha quatre parells diferents de marcadors d'obertura i
clausura que es poden usar en php. Dos d'aquests, <?php ?>
i <script language="php"> </script>, sempre
estan disponibles. Els altres dos són marcadors curts i
marcadors amb estil <productname>ASP</productname>
i es poden activar o desactivar del fitxer de configuració
&php.ini;. Per tant, tot i que alguna gent troba els
marcadors curts i els d'estil <productname>ASP</productname>
convenients, són menys portables i generalment no
recomanats.
<note>
<para>
Noteu també que si esteu incrustant PHP en XML o XHTML
necessitareu usar els marcadors <?php ?> per
mantenir-vos complidors amb els estàndards.
</para>
</note>
</para>
<para>
<example>
<title>Marcadors d'obertura i clausura del PHP</title>
<programlisting role="php">
<![CDATA[
1. <?php echo 'si voleu servir documents XHTML o XML, feu-ho així'; ?>
2. <script language="php">
echo 'a alguns editors (com ara el FrontPage) no els
agraden les instruccions de processat';
</script>
3. <? echo 'aquesta és la més simple, una instrucció de processat SGML'; ?>
<?= expression ?> Això és una drecera de "<? echo expression ?>"
4. <% echo 'Potser voldreu usar marcadors d'estil ASP'; %>
<%= $variable; # Això és una drecera de "<% echo . . ." %>
]]>
</programlisting>
</example>
</para>
<para>
Tot i que els marcadors vistos als exemples u i dos
sempre estan disponibles, l'exemple primer és el més
correntment usat, i recomanat, dels dos.
</para>
<para>
Els marcadors curts (exemple tres) només estan disponibles quan
s'habiliten via la directiva <link linkend="ini.short-open-tag">short_open_tag</link>
del fitxer de configuració &php.ini;, o bé si el php fou
configurat amb l'opció <option>--enable-short-tags</option>.
<note>
<para>
Si esteu usant el PHP 3 podeu habilitar els marcadors curts també
via la funció <function>short_tags</function>. <emphasis>Això
només està disponible al PHP 3!</emphasis>
</para>
</note>
</para>
<para>
Els marcadors d'estil <productname>ASP</productname> (exemple quatre) només estan
disponibles quan s'habiliten via la directiva <link linkend="ini.asp-tags">asp_tags</link>
del fitxer de configuració &php.ini;.
<note>
<para>
El suport pels marcadors <productname>ASP</productname> fou afegit a la versió 3.0.4.
</para>
</note>
</para>
<para>
<note>
<para>
L'ús de marcadors curts hauria d'evitar-se quan es desenvolupen
aplicacions o biblioteques pensades per a la redistribució, o per
a servidors PHP que no són sota el vostre control, ja que els
marcadors curts poden no ésser reconeguts al servidor objectiu.
Si voleu fer codi portable i redistribuïble assegureu-vos
de no utilitzar marcadors curts.
</para>
</note>
</para>
</sect1>
<sect1 id="language.basic-syntax.instruction-separation">
<title>Separació d'instruccions</title>
<para>
Com a C o Perl, el PHP requereix que les instruccions s'acabin
amb un punt i coma al final de cada sentència. El marcador de
tancament d'un bloc de codi PHP implica automàticament un punt
i coma; no necessiteu posar un punt i coma per acabar la darrera
línia d'un bloc PHP. El marcador de clausura del bloc
inclourà immediatament un caràcter de nova línia si un està present.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
echo 'Això és una prova';
?>
<?php echo 'Això és una prova' ?>
]]>
</programlisting>
</informalexample>
<note>
<para>
El marcador de clausura d'un bloc PHP al final d'un fitxer és opcional,
i en alguns casos ometre'l és d'ajuda quan s'utilitzen sortides intermèdies i
<function>include</function> o <function>require</function>.
</para>
</note>
</para>
</sect1>
<sect1 id="language.basic-syntax.comments">
<title>Comentaris</title>
<para>
PHP suporta comentaris 'C', 'C++' i d'estil Unix (estil Perl). Per exemple:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
echo 'Això és una prova'; // Això és un comentari d'una línia estil c++
/* Això és un comentari de diverses línies
una altra línia de comentari */
echo 'Això és encara una altra prova';
echo 'Una prova final'; # Això és un comentari estil línia d'ordres
?>
]]>
</programlisting>
</informalexample>
</para>
<simpara>
Els estils d'una línia de comentari només comenten fins al final
de la línia o el bloc actual de codi PHP, el primer que vingui.
Això significa que el codi HTML de després de <literal>// ?></literal>
SERÀ imprès:
?> surt del mode PHP i torna al mode HTML, i
<literal>//</literal> no hi pot influir.
Si la directiva de configuració <link linkend="ini.asp-tags">asp_tags</link>
està habilitada, es comporta de la mateixa manera que amb <literal>// %></literal>.
De totes formes, el marcador <literal></script></literal> no escapa el mode PHP
en comentaris d'una línia.
</simpara>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
<h1>Això és un <?php # echo 'simple';?> exemple.</h1>
<p>Això de dalt dirà: 'Això és un exemple'.</p>
]]>
</programlisting>
</informalexample>
</para>
<simpara>
Els comentaris estil 'C' acaben quan es troba el primer <literal>*/</literal>.
Heu d'anar amb compte de no aniuar comentaris estil 'C' la qual cosa
pot passar quan es comenten blocs grans.
</simpara>
<para>
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
/*
echo 'Això és una prova'; /* Aquest comentari causarà un problema */
*/
?>
]]>
</programlisting>
</informalexample>
</para>
</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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
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
-->
--jabro1125682085--