cvs: phpdoc-it /language basic-syntax.xml

From: 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 (&lt;?php. . .?&gt; e &lt;script language="php"&gt;. . .&lt;/script&gt;) + 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 + &lt;?php. . .?&gt; 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. &lt;? echo ("questo è il più semplice, ovvero come istruzione SGML\n"); ?&gt; - &lt;?= espressione ?&gt; Questa è un'abbreviazione per "&lt;? echo espressione ?&gt;" - -2. &lt;?php echo("se si vogliono produrre documenti XHTML o XML, si utilizzi questo modo\n"); ?&gt; + <programlisting role="php"> +<![CDATA[ +1. <?php echo("se si vogliono produrre documenti XHTML o XML, si utilizzi questo modo\n"); ?> -3. &lt;script language="php"&gt; +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"); - &lt;/script&gt; + </script> -4. &lt;% echo ("Opzionalmente puoi utilizzare tag nello stile ASP"); %&gt; - &lt;%= $variable; # Questo &egrave; una abbreviazione per "&lt;%echo .." %&gt; +4. <% echo ("Opzionalmente puoi utilizzare tag nello stile ASP"); %> + <%= $variable; # Questo &egrave; una abbreviazione per "<%echo .." %> +]]> </programlisting> </example> </para> <para> - Il primo è disponibile solo se sono stati abilitati + Il primo, &lt;?php. . .?&gt;, è 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"> -&lt;?php - -if (boolean-expression) { - ?&gt; -&lt;strong&gt;This is true.&lt;/strong&gt; - &lt;?php +<![CDATA[   +<?php +if ($expression) { + ?> + <strong>Questa è vera.</strong> + <?php } else { - ?&gt; -&lt;strong&gt;This is false.&lt;/strong&gt; - &lt;?php + ?> + <strong>Questa è falsa.</strong> + <?php } - ?&gt; - </programlisting></example> - - This works as expected, because PHP handles text within ?&gt; and - &lt;?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 ?&gt;, 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 (?&gt;) implica anche la fine di un'istruzione, perci&ograve; le seguenti sono equivalenti: - <informalexample> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php echo "Questo &grave; un test"; ?> - -&lt;?php echo "Questo &grave; un test" ?> +<?php echo "Questo &grave; 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"> -&lt;?php + Il PHP supporta i commenti dei linguaggi 'C', 'C++' e della shell Unix. Per esempio: + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php echo "Questo &grave; un test"; // Questo &egrave; un commento su una linea nella stile c++ /* Questo &egrave; un commento su pi&ugrave; linee ancora un'altra linea di commento */ echo "Questo &egrave; un altro test"; echo "Un ultimo test"; # Questo &egrave; 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"> -&lt;h1>Questo &egrave; un &lt;?# echo "semplice";?> esempio.&lt;/h1> -&lt;p>L'intestazione qui sopra dir&agrave; 'Questo &egrave; un esempio'. - </programlisting></informalexample> + codice PHP. + </simpara> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<h1>Questo &egrave; un <?# echo "semplice";?> esempio.</h1> +<p>L'intestazione qui sopra dir&agrave; 'Questo &egrave; 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"> -&lt;?php + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php /* echo "Questo &egrave; un test"; /* Questo commento causer&agrave; 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
« previous php.doc.it (#324) next »