cvs: phpdoc-ca /language basic-syntax.xml
| From: | Bernat Foj Capell | Date: | Fri, 02 Sep 2005 17:28:05 +0000 |
| Subject: | cvs: phpdoc-ca /language basic-syntax.xml | ||
| Groups: | php.doc.ca | ||
| Request: | Send a blank email to doc-ca+get-74@lists.php.net to get a copy of this message | ||
jabro Fri Sep 2 13:28:05 2005 EDT
Added files:
/phpdoc-ca/language basic-syntax.xml
Log:
initial translation
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 -->
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 -->