cvs: phpdoc-it /language basic-syntax.xml
| From: | Andrioli Darvin | Date: | Sat, 15 Mar 2003 12:17:57 +0000 |
| Subject: | cvs: phpdoc-it /language basic-syntax.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-324@lists.php.net to get a copy of this message | ||
darvina Sat Mar 15 07:17:57 2003 EDT
Modified files:
/phpdoc-it/language basic-syntax.xml
Log:
Update to En 1.33
Index: phpdoc-it/language/basic-syntax.xml diff -u phpdoc-it/language/basic-syntax.xml:1.8 phpdoc-it/language/basic-syntax.xml:1.9 --- phpdoc-it/language/basic-syntax.xml:1.8 Wed Dec 12 15:52:02 2001 +++ phpdoc-it/language/basic-syntax.xml Sat Mar 15 07:17:57 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.19 Maintainer: perugini Status: ready --> - <chapter id="language.basic-syntax"> - <title>Sintassi Fondamentale</title> +<!-- EN-Revision: 1.33 Maintainer: perugini Status: ready --> +<chapter id="language.basic-syntax"> + <title>Sintassi Fondamentale</title> <!-- @@ -46,53 +46,72 @@ oop : has been revised by Kristian, DONE. --> - <sect1 id="language.basic-syntax.phpmode"> - <title>Modi per uscire dalla modalità HTML</title> + <sect1 id="language.basic-syntax.phpmode"> + <title>Modi per uscire dalla modalità HTML</title> - <para> - Quando il PHP inizia a manipolare un file, produrrà in uscita - solamente il testo che trova. Così se si ha un file HTML, e si - modifica l'estensione in .php, il file continuerà ad essere visibile. - </para> - - <para> - Se si vogliono inserire delle istruzioni PHP in un certo punto - del file, occorre indicarlo al php, entrando nella "modalità PHP" - in uno dei seguenti modi: - </para> + <para> + Quando il PHP inizia a esaminare un file, visualizzerà il contenuto del file + sino a quando non incontra uno dei tag speciali indicanti l'inizio + del codice da interpretare come istruzioni PHP. A questo punto il parser + eseguirà tutto il codice trovato sino a quando non incontrerà + i tag di chiusura, che indicano al parser di tornare alla modalità + di visualizzazione. Questo meccanismo permette di inserire codice PHP + all'interno di codice HTML: tutto ciò che si trova all'esterno + dei tag PHP sarà lasciato inalterato, mentre tutto ciò che si trova all'interno + sarà eseguito come codice PHP. + </para> + + <para> + Esistono 4 set di tag che possono essere utilizzati per delimitare + blocchi di codice PHP. Soltanto due di questi (<?php. . .?> e <script language="php">. . .</script>) + sono sempre disponibili; + gli altri possono essere attivati o disattivati tramite il file di configurazione + &php.ini;. + Sebbene i tag brevi o quelli in stile ASP possano essere pratici, il supporto di questi non + è garantito in tutte le versioni. Quindi, se si intende inserire codice + PHP all'interno di testi XMl o XHTML, occorre utilizzare + <?php. . .?> per essere conformi allo standard XML. + </para> + + <para> + I tag supportati dal PHP sono: + </para> <para> <example> <title>Metodi per uscire dalla modalità HTML</title> - <programlisting> -1. <? echo ("questo è il più semplice, ovvero come istruzione SGML\n"); ?> - <?= espressione ?> Questa è un'abbreviazione per "<? echo espressione ?>" - -2. <?php echo("se si vogliono produrre documenti XHTML o XML, si utilizzi questo modo\n"); ?> + <programlisting role="php"> +<![CDATA[ +1. <?php echo("se si vogliono produrre documenti XHTML o XML, si utilizzi questo modo\n"); ?> -3. <script language="php"> +2. <? echo ("questo è il più semplice, ovvero come istruzione SGML\n"); ?> + <?= espressione ?> Questa è un'abbreviazione per "<? echo espressione ?>" + +3. <script language="php"> echo ("alcuni editor (tipo FrontPage) non amano le istruzioni di elaborazione"); - </script> + </script> -4. <% echo ("Opzionalmente puoi utilizzare tag nello stile ASP"); %> - <%= $variable; # Questo è una abbreviazione per "<%echo .." %> +4. <% echo ("Opzionalmente puoi utilizzare tag nello stile ASP"); %> + <%= $variable; # Questo è una abbreviazione per "<%echo .." %> +]]> </programlisting> </example> </para> <para> - Il primo è disponibile solo se sono stati abilitati + Il primo, <?php. . .?>, è il metodo preferenziale, dato che permette + l'utilizzo del PHP all'interno di codice conforme a specifiche XML come XHTML. + </para> + + <para> + Il secondo metodo è disponibile solo se sono stati abilitati i tags abbreviati. Ciò può - essere impostato <!-- sia utilizzando la funzione <function>short_tags</function>, che--> + essere impostato sia utilizzando la funzione <function>short_tags</function> (solo PHP 3), sia abilitando nel file di configurazione del PHP l'opzione <link linkend="ini.short-open-tag">short_open_tag</link>, oppure compilando il PHP utilizzando l'opzione --enable-short-tags nel comando <command>configure</command>. - </para> - - <para> - Il secondo modo è il metodo generalmente preferito, in quanto consente - alla prossima generazione di XHTML di essere facilmente implementato con il PHP. + Sebbene siano abilitati nel php.ini-dist riilasciato, l'uso dei tag brevi è vivamente sconsigliato. </para> <para> @@ -100,98 +119,137 @@ di configurazione i tag in stile ASP tramite l'opzione <link linkend="ini.asp-tags">asp_tags</link>. - <note> - <para>Il supporto per i tag nello stile ASP è stato aggiunto nella versione 3.0.4.</para> - </note></para> - - <para> - I tag di chiusura del blocco includono, se presente, il carattere - di newline immediatamente sucessivo. - </para> - - <para> <!-- TODO: find a better place for this para --> - PHP allows you to use structures like this: - <example><title>Advanced escaping</title> + <note> + <para>Il supporto per i tag nello stile ASP è stato aggiunto nella versione 3.0.4.</para> + </note> + </para> + + <note> + <para> + L'utilizzo dei tag brevi dovrebbe essere evitato nello sviluppo + di applicazioni o librerie destinate alla distribuzione o destinati + a server di produzione PHP di cui non si ha il controllo poichè questi + tag potrebbero non essere attivi sul server di destinazione. Per avere maggiore + portabilità, codice redistribuibile, occorre essere certi di non utilizzare i tag brevi. + </para> + </note> + + <para> + Il tag di chiusura di un blocco include il carattere di 'a capo' + immediatamente seguente, se presente. Inoltre, il tag di chiusura + viene considerato automaticamente come punto e virgola; pertanto non + occorre inserire il punto e virgola alla fine dell'ultima riga del blocco php. + </para> + + <para> + Il PHP permette strutture tipo le seguenti: + <example><title>Modi avanzati per uscire dalla modalità HTML</title> <programlisting role="php"> -<?php - -if (boolean-expression) { - ?> -<strong>This is true.</strong> - <?php +<![CDATA[ +<?php +if ($expression) { + ?> + <strong>Questa è vera.</strong> + <?php } else { - ?> -<strong>This is false.</strong> - <?php + ?> + <strong>Questa è falsa.</strong> + <?php } - ?> - </programlisting></example> - - This works as expected, because PHP handles text within ?> and - <?php as an <function>echo</function> statement. - <!-- without the parsing if vars, that is (hopefully?) obvious --> +?> +]]> + </programlisting> + </example> + Questo esempio agisce come atteso, poichè il PHP rileva il tag di + chiusura ?>, e da questo punto, inizia a dare in output tutto ciò + che trova fino a quando non rileva un'altro tag di apertura. + Certamente l'esempio dato è macchinoso, ma per l'output + di grossi blocchi di testo, l'uscire dalla modalità di parsing PHP, + è generalmente più efficiente piuttosto che inviare il testo + tramite ripetute funzioni <function>echo</function> o + <function>print</function>. </para> - </sect1> <sect1 id="language.basic-syntax.instruction-separation"> <title>Separazione delle istruzioni</title> <simpara> - Le istruzioni sono separate come nel C o in perl - + Le istruzioni sono separate come nel C o in Perl - ogni istruzione termina con un punto e virgola.</simpara> <para> Il tag di chiusura (?>) implica anche la fine di un'istruzione, perciò le seguenti sono equivalenti: - <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Questo ` un test"; ?> - -<?php echo "Questo ` un test" ?> +<?php echo "Questo ` un test" ?> +]]> </programlisting> - </informalexample></para></sect1> - + </informalexample> + </para> + </sect1> <sect1 id="language.basic-syntax.comments"> <title>Commenti</title> <para> - PHP supporta i commenti dei linguaggi 'C', 'C++' e della shell Unix. Per esempio: - - <informalexample><programlisting role="php"> -<?php + Il PHP supporta i commenti dei linguaggi 'C', 'C++' e della shell Unix. Per esempio: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php echo "Questo ` un test"; // Questo è un commento su una linea nella stile c++ /* Questo è un commento su più linee ancora un'altra linea di commento */ echo "Questo è un altro test"; echo "Un ultimo test"; # Questo è un commento stile shell Unix ?> - </programlisting> - </informalexample></para> +]]> + </programlisting> + </informalexample> + </para> <simpara> Lo stile di commento su "una linea", attualmente commenta solo fino alla fine della linea o del blocco corrente di - codice PHP.</simpara> - <informalexample><programlisting role="php"> -<h1>Questo è un <?# echo "semplice";?> esempio.</h1> -<p>L'intestazione qui sopra dirà 'Questo è un esempio'. - </programlisting></informalexample> + codice PHP. + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<h1>Questo è un <?# echo "semplice";?> esempio.</h1> +<p>L'intestazione qui sopra dirà 'Questo è un esempio'. +]]> + </programlisting> + </informalexample> <simpara> Occorre fare attenzione nel non annidare i commenti di stile C, situazione che si presenta - quando si commentano larghi blocchi di codice.</simpara> + quando si commentano larghi blocchi di codice. + </simpara> - <informalexample><programlisting role="php"> -<?php + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php /* echo "Questo è un test"; /* Questo commento causerà dei problemi */ */ ?> - </programlisting></informalexample></sect1> +]]> + </programlisting> + </informalexample> + <simpara> + Lo stile di commento su linea singola commenta il testo fino + alla fine della riga oppure alla fine del blocco di codice PHP, dipende da cosa si incontra prima. + Questo significa che il codice HTML posizionato dopo // ?> SARA' visualizzato: + ?> indica di uscire dal modo PHP e di ritornare in modalità HTML, e, quindi, // non hanno più effetto. + </simpara> + </sect1> </chapter> <!-- Keep this comment at the end of the file
Index: phpdoc-it/language/basic-syntax.xml diff -u phpdoc-it/language/basic-syntax.xml:1.8 phpdoc-it/language/basic-syntax.xml:1.9 --- phpdoc-it/language/basic-syntax.xml:1.8 Wed Dec 12 15:52:02 2001 +++ phpdoc-it/language/basic-syntax.xml Sat Mar 15 07:17:57 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.19 Maintainer: perugini Status: ready --> - <chapter id="language.basic-syntax"> - <title>Sintassi Fondamentale</title> +<!-- EN-Revision: 1.33 Maintainer: perugini Status: ready --> +<chapter id="language.basic-syntax"> + <title>Sintassi Fondamentale</title> <!-- @@ -46,53 +46,72 @@ oop : has been revised by Kristian, DONE. --> - <sect1 id="language.basic-syntax.phpmode"> - <title>Modi per uscire dalla modalità HTML</title> + <sect1 id="language.basic-syntax.phpmode"> + <title>Modi per uscire dalla modalità HTML</title> - <para> - Quando il PHP inizia a manipolare un file, produrrà in uscita - solamente il testo che trova. Così se si ha un file HTML, e si - modifica l'estensione in .php, il file continuerà ad essere visibile. - </para> - - <para> - Se si vogliono inserire delle istruzioni PHP in un certo punto - del file, occorre indicarlo al php, entrando nella "modalità PHP" - in uno dei seguenti modi: - </para> + <para> + Quando il PHP inizia a esaminare un file, visualizzerà il contenuto del file + sino a quando non incontra uno dei tag speciali indicanti l'inizio + del codice da interpretare come istruzioni PHP. A questo punto il parser + eseguirà tutto il codice trovato sino a quando non incontrerà + i tag di chiusura, che indicano al parser di tornare alla modalità + di visualizzazione. Questo meccanismo permette di inserire codice PHP + all'interno di codice HTML: tutto ciò che si trova all'esterno + dei tag PHP sarà lasciato inalterato, mentre tutto ciò che si trova all'interno + sarà eseguito come codice PHP. + </para> + + <para> + Esistono 4 set di tag che possono essere utilizzati per delimitare + blocchi di codice PHP. Soltanto due di questi (<?php. . .?> e <script language="php">. . .</script>) + sono sempre disponibili; + gli altri possono essere attivati o disattivati tramite il file di configurazione + &php.ini;. + Sebbene i tag brevi o quelli in stile ASP possano essere pratici, il supporto di questi non + è garantito in tutte le versioni. Quindi, se si intende inserire codice + PHP all'interno di testi XMl o XHTML, occorre utilizzare + <?php. . .?> per essere conformi allo standard XML. + </para> + + <para> + I tag supportati dal PHP sono: + </para> <para> <example> <title>Metodi per uscire dalla modalità HTML</title> - <programlisting> -1. <? echo ("questo è il più semplice, ovvero come istruzione SGML\n"); ?> - <?= espressione ?> Questa è un'abbreviazione per "<? echo espressione ?>" - -2. <?php echo("se si vogliono produrre documenti XHTML o XML, si utilizzi questo modo\n"); ?> + <programlisting role="php"> +<![CDATA[ +1. <?php echo("se si vogliono produrre documenti XHTML o XML, si utilizzi questo modo\n"); ?> -3. <script language="php"> +2. <? echo ("questo è il più semplice, ovvero come istruzione SGML\n"); ?> + <?= espressione ?> Questa è un'abbreviazione per "<? echo espressione ?>" + +3. <script language="php"> echo ("alcuni editor (tipo FrontPage) non amano le istruzioni di elaborazione"); - </script> + </script> -4. <% echo ("Opzionalmente puoi utilizzare tag nello stile ASP"); %> - <%= $variable; # Questo è una abbreviazione per "<%echo .." %> +4. <% echo ("Opzionalmente puoi utilizzare tag nello stile ASP"); %> + <%= $variable; # Questo è una abbreviazione per "<%echo .." %> +]]> </programlisting> </example> </para> <para> - Il primo è disponibile solo se sono stati abilitati + Il primo, <?php. . .?>, è il metodo preferenziale, dato che permette + l'utilizzo del PHP all'interno di codice conforme a specifiche XML come XHTML. + </para> + + <para> + Il secondo metodo è disponibile solo se sono stati abilitati i tags abbreviati. Ciò può - essere impostato <!-- sia utilizzando la funzione <function>short_tags</function>, che--> + essere impostato sia utilizzando la funzione <function>short_tags</function> (solo PHP 3), sia abilitando nel file di configurazione del PHP l'opzione <link linkend="ini.short-open-tag">short_open_tag</link>, oppure compilando il PHP utilizzando l'opzione --enable-short-tags nel comando <command>configure</command>. - </para> - - <para> - Il secondo modo è il metodo generalmente preferito, in quanto consente - alla prossima generazione di XHTML di essere facilmente implementato con il PHP. + Sebbene siano abilitati nel php.ini-dist riilasciato, l'uso dei tag brevi è vivamente sconsigliato. </para> <para> @@ -100,98 +119,137 @@ di configurazione i tag in stile ASP tramite l'opzione <link linkend="ini.asp-tags">asp_tags</link>. - <note> - <para>Il supporto per i tag nello stile ASP è stato aggiunto nella versione 3.0.4.</para> - </note></para> - - <para> - I tag di chiusura del blocco includono, se presente, il carattere - di newline immediatamente sucessivo. - </para> - - <para> <!-- TODO: find a better place for this para --> - PHP allows you to use structures like this: - <example><title>Advanced escaping</title> + <note> + <para>Il supporto per i tag nello stile ASP è stato aggiunto nella versione 3.0.4.</para> + </note> + </para> + + <note> + <para> + L'utilizzo dei tag brevi dovrebbe essere evitato nello sviluppo + di applicazioni o librerie destinate alla distribuzione o destinati + a server di produzione PHP di cui non si ha il controllo poichè questi + tag potrebbero non essere attivi sul server di destinazione. Per avere maggiore + portabilità, codice redistribuibile, occorre essere certi di non utilizzare i tag brevi. + </para> + </note> + + <para> + Il tag di chiusura di un blocco include il carattere di 'a capo' + immediatamente seguente, se presente. Inoltre, il tag di chiusura + viene considerato automaticamente come punto e virgola; pertanto non + occorre inserire il punto e virgola alla fine dell'ultima riga del blocco php. + </para> + + <para> + Il PHP permette strutture tipo le seguenti: + <example><title>Modi avanzati per uscire dalla modalità HTML</title> <programlisting role="php"> -<?php - -if (boolean-expression) { - ?> -<strong>This is true.</strong> - <?php +<![CDATA[ +<?php +if ($expression) { + ?> + <strong>Questa è vera.</strong> + <?php } else { - ?> -<strong>This is false.</strong> - <?php + ?> + <strong>Questa è falsa.</strong> + <?php } - ?> - </programlisting></example> - - This works as expected, because PHP handles text within ?> and - <?php as an <function>echo</function> statement. - <!-- without the parsing if vars, that is (hopefully?) obvious --> +?> +]]> + </programlisting> + </example> + Questo esempio agisce come atteso, poichè il PHP rileva il tag di + chiusura ?>, e da questo punto, inizia a dare in output tutto ciò + che trova fino a quando non rileva un'altro tag di apertura. + Certamente l'esempio dato è macchinoso, ma per l'output + di grossi blocchi di testo, l'uscire dalla modalità di parsing PHP, + è generalmente più efficiente piuttosto che inviare il testo + tramite ripetute funzioni <function>echo</function> o + <function>print</function>. </para> - </sect1> <sect1 id="language.basic-syntax.instruction-separation"> <title>Separazione delle istruzioni</title> <simpara> - Le istruzioni sono separate come nel C o in perl - + Le istruzioni sono separate come nel C o in Perl - ogni istruzione termina con un punto e virgola.</simpara> <para> Il tag di chiusura (?>) implica anche la fine di un'istruzione, perciò le seguenti sono equivalenti: - <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php echo "Questo ` un test"; ?> - -<?php echo "Questo ` un test" ?> +<?php echo "Questo ` un test" ?> +]]> </programlisting> - </informalexample></para></sect1> - + </informalexample> + </para> + </sect1> <sect1 id="language.basic-syntax.comments"> <title>Commenti</title> <para> - PHP supporta i commenti dei linguaggi 'C', 'C++' e della shell Unix. Per esempio: - - <informalexample><programlisting role="php"> -<?php + Il PHP supporta i commenti dei linguaggi 'C', 'C++' e della shell Unix. Per esempio: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php echo "Questo ` un test"; // Questo è un commento su una linea nella stile c++ /* Questo è un commento su più linee ancora un'altra linea di commento */ echo "Questo è un altro test"; echo "Un ultimo test"; # Questo è un commento stile shell Unix ?> - </programlisting> - </informalexample></para> +]]> + </programlisting> + </informalexample> + </para> <simpara> Lo stile di commento su "una linea", attualmente commenta solo fino alla fine della linea o del blocco corrente di - codice PHP.</simpara> - <informalexample><programlisting role="php"> -<h1>Questo è un <?# echo "semplice";?> esempio.</h1> -<p>L'intestazione qui sopra dirà 'Questo è un esempio'. - </programlisting></informalexample> + codice PHP. + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<h1>Questo è un <?# echo "semplice";?> esempio.</h1> +<p>L'intestazione qui sopra dirà 'Questo è un esempio'. +]]> + </programlisting> + </informalexample> <simpara> Occorre fare attenzione nel non annidare i commenti di stile C, situazione che si presenta - quando si commentano larghi blocchi di codice.</simpara> + quando si commentano larghi blocchi di codice. + </simpara> - <informalexample><programlisting role="php"> -<?php + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php /* echo "Questo è un test"; /* Questo commento causerà dei problemi */ */ ?> - </programlisting></informalexample></sect1> +]]> + </programlisting> + </informalexample> + <simpara> + Lo stile di commento su linea singola commenta il testo fino + alla fine della riga oppure alla fine del blocco di codice PHP, dipende da cosa si incontra prima. + Questo significa che il codice HTML posizionato dopo // ?> SARA' visualizzato: + ?> indica di uscire dal modo PHP e di ritornare in modalità HTML, e, quindi, // non hanno più effetto. + </simpara> + </sect1> </chapter> <!-- Keep this comment at the end of the file