cvs: phpdoc-it /features commandline.xml connection-handling.xml
| From: | Andrioli Darvin | Date: | Thu, 02 Sep 2004 12:15:42 +0000 |
| Subject: | cvs: phpdoc-it /features commandline.xml connection-handling.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-642@lists.php.net to get a copy of this message | ||
darvina Thu Sep 2 08:15:42 2004 EDT
Modified files:
/phpdoc-it/features commandline.xml connection-handling.xml
Log:
Sync to En tree
http://cvs.php.net/diff.php/phpdoc-it/features/commandline.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/features/commandline.xml diff -u phpdoc-it/features/commandline.xml:1.2 phpdoc-it/features/commandline.xml:1.3 --- phpdoc-it/features/commandline.xml:1.2 Mon Aug 9 07:56:22 2004 +++ phpdoc-it/features/commandline.xml Thu Sep 2 08:15:42 2004 @@ -1,15 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.35 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.36 Maintainer: darvina Status: ready --> <chapter id="features.commandline"> <title>Utilizzo di PHP da linea di comando</title> <!-- NEW DOCUMENTATION STARTS --> <para> - A partire dalla versione 4.3.0, il <literal>PHP</literal> supporta un + A partire dalla versione 4.3.0, il PHP supporta un nuovo tipo di <literal>SAPI</literal> (Server Application Programming Interface) chiamata <literal>CLI</literal> che significa <emphasis>Interfaccia per la Linea di Comando (Command Line Interface)</emphasis>. Come il nome stesso suggerisce, questo tipo di <literal>SAPI</literal> è mirato allo sviluppo di applicazioni shell (o desktop) con - <literal>PHP</literal>. Esistono alcune differenze tra la + PHP. Esistono alcune differenze tra la <literal>CLI SAPI</literal> e le altre <literal>SAPI</literal>; queste saranno illustrate nel corrente capitolo. Val la pena ricordare che <literal>CLI</literal> e <literal>CGI</literal> sono differenti @@ -17,40 +17,40 @@ </para> <para> La <literal>CLI SAPI</literal> è stata rilasciata per la prima volta con - <literal>PHP 4.2.0</literal>, ma era ancora sperimentale e quindi doveva essere - esplicitamente abilitata con <literal>--enable-cli</literal> nell'esecuzione di - <literal>./configure</literal>. A partire dal <literal>PHP 4.3.0</literal> la + PHP 4.2.0, ma era ancora sperimentale e quindi doveva essere + esplicitamente abilitata con <option role="configure">--enable-cli</option> nell'esecuzione di + <command>./configure</command>. A partire dal PHP 4.3.0 la <literal>CLI SAPI</literal> non viene più considerata sperimentale e quindi l'opzione - <literal>--enable-cli</literal> è attivata per default. Vedere - <literal>--disable-cli</literal> per disabilitare l'opzione. + <option role="configure">--enable-cli</option> è attivata per default. Vedere + <option role="configure">--disable-cli</option> per disabilitare l'opzione. </para> <para> Dal PHP 4.3.0, il nome, la posizione, e l'esistenza di eseguibili CLI/CGI differirà in base a come il PHP sarà installato sul sistema. - Per default quando si esegue il <literal>make</literal>, si compila sia la versione CLI sia la versione CGI - e saranno poste rispettivamente in <literal>sapi/cgi/php</literal> e <literal>sapi/cli/php</literal> + Per default quando si esegue il <command>make</command>, si compila sia la versione CLI sia la versione CGI + e saranno poste rispettivamente in <filename>sapi/cgi/php</filename> e <filename>sapi/cli/php</filename> a partire dalla directory dei sorgenti. Occorre notare che entrambi gli eseguibili sono chiamati <literal>php</literal>. Ciò che accade durante l'esecuzione di - <literal>make install</literal> dipende dalla linea di configurazione. + dipende dalla linea di configurazione. Se durante la configurazione si è scelto un modulo SAPI, tipo apxs, o si è attivato - <literal> --disable-cgi</literal>, l'eseguibile CLI viene copiato in - <literal>{PREFIX}/bin/php</literal> durante <literal>make install</literal>, + <option role="configure">--disable-cgi</option>, l'eseguibile CLI viene copiato in + durante <command>make install</command>, altrimenti in questa cartella sarà posto l'eseguibile CGI. Così, per esempio, se si ha - come parametro di configurazione <literal>--with--apxs</literal> allora l'eseguibile CLI - sarà copiato in <literal>{PREFIX}/bin/php</literal> durante <literal>make - install</literal>. Se si vuole evitare l'installazione dell'eseguibile CGI, - utilizzare <literal>make install-cli</literal> dopo <literal>make - install</literal>. In alternativa si può specificare <literal>--disable-cgi - </literal> nella linea di configurazione. + come parametro di configurazione <option role="configure">--with--apxs</option> allora l'eseguibile CLI + sarà copiato in <filename>{PREFIX}/bin/php</filename> durante <command>make + install</command>. Se si vuole evitare l'installazione dell'eseguibile CGI, + utilizzare <command>make install-cli</command> dopo <command>make + install</command>. In alternativa si può specificare <option role="configure">--disable-cgi + </option> nella linea di configurazione. </para> <para> <note> <para> - Poichè sia <literal>--enable-cli</literal> sia <literal> - --enable-cgi</literal> sono abilitati per default, avere semplicemente - <literal>--enable-cli</literal> nella linea di configurazione non significa - necessariamente che l'eseguibile CLI sia copiato come <literal> - {PREFIX}/bin/php</literal> con l'esecuzione di <literal>make install</literal>. + Poichè sia <option role="configure">--enable-cli</option> sia + <option role="configure">--enable-cgi</option> sono abilitati per default, avere semplicemente + <option role="configure">--enable-cli</option> nella linea di configurazione non significa + necessariamente che l'eseguibile CLI sia copiato come <filename>{PREFIX}/bin/php</filename> + con l'esecuzione di <command>make install</command>. </para> </note> </para> @@ -58,8 +58,8 @@ Nel pacchetto per Windows, nelle versioni tra PHP 4.2.0 e PHP 4.2.3, l'eseguibile CLI era presente come <filename>php-cli.exe</filename>, nella medesima cartella della versione CGI <filename>php.exe</filename>. A partire dal PHP 4.3.0 nel pacchetto per Windows la versione CLI viene - distribuita come <filename>php.exe</filename> in una cartella a parte chiamata <literal>cli</literal>, - avendo perciò <literal>cli/php.exe</literal>. + distribuita come <filename>php.exe</filename> in una cartella a parte chiamata <filename class="directory">cli</filename>, + avendo perciò <filename>cli/php.exe</filename>. A partire dal PHP 5, la versione CLI viene inserita nella cartella principale, con il nome <filename>php.exe</filename>. La versione CGI sarà chiamata <filename>php-cgi.exe</filename>. @@ -69,14 +69,14 @@ Questo è equivalente alla versione CLI, tranne che php-win non visualizzerà nulla e quindi non vi sarà la finestra di console (non compare la fienstra dos nello schermo). Questo comportamento è stato ripreso da php-gtk. Si dovrebbe configurare il PHP con - <literal>--enable-cli-win32</literal>. + <option role="configure">--enable-cli-win32</option>. </para> <para> <note> <title>Quale SAPI ho?</title> <para> - Da shell, digitando <literal>php -v</literal> si avrà l'informazione di - quale <literal>php</literal> si tratta, CGI o CLI. Vedere anche la funzione + Da shell, digitando <command>php -v</command> si avrà l'informazione di + quale <filename>php</filename> si tratta, CGI o CLI. Vedere anche la funzione <function>php_sapi_name</function>e la costante <constant> PHP_SAPI</constant> per dettagli. </para> @@ -86,7 +86,7 @@ <note> <para> Una pagina stile <literal>man</literal> di Unix è stata aggiunta in PHP 4.3.2. La si può - visualizzare digitando <literal>man php</literal> da linea di comando. + visualizzare digitando <command>man php</command> da linea di comando. </para> </note> </para> @@ -106,11 +106,12 @@ </para> <para> Per default CLI parte in modalità silenziosa, si è mantenuto, comunque, - l'opzione <literal>-q</literal> e <literal>--no-header</literal> per motivi di compatibilità; in questo modo si possono utlizzare i vecchi script CGI. + l'opzione <option>-q</option> e <option>--no-header</option> per motivi di compatibilità; + in questo modo si possono utlizzare i vecchi script CGI. </para> <para> Non cambia la directory di lavoro in quella dello script. - (E' rimasta l'opzione <literal>-C</literal> e <literal>--no-chdir</literal> per compatibilità) + (E' rimasta l'opzione <option>-C</option> e <option>--no-chdir</option> per compatibilità) </para> <para> Messaggi di errore in formato testo (non formattati in HTML). @@ -157,7 +158,7 @@ <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry> <entry>0 (unlimited)</entry> <entry> - Considerate le svariate possibilità offerte da <literal>PHP</literal> + Considerate le svariate possibilità offerte da PHP nell'ambiente di shell, il tempo massimo di esecuzione è stato impostato a infinito. Mentre nelle applicazione scritte per il web i tempi di esecuzione sono rapidi, le applicazioni di shell tendono ad avere tempi di esecuzione @@ -290,7 +291,7 @@ ]]> </programlisting> Non occorre chiudere esplicitamente questi flussi, saranno chiusi automaticamente - dal <literal>PHP</literal> alla fine dello script. + dal PHP alla fine dello script. </para> </listitem> <listitem> @@ -321,7 +322,7 @@ /tmp/another_directory ]]> </screen> - Questo evidenzia chiaramente come il <literal>PHP</literal> cambi la + Questo evidenzia chiaramente come il PHP cambi la directory corrente con quella in cui si trova lo script. </para> <para> @@ -336,12 +337,12 @@ ]]> </screen> Questo permette una grande flessibilità nello scrivere tools in - <literal>PHP</literal>. + PHP. </para> <note> <para> La <literal>CGI SAPI</literal> supporta il comportamento - della <literal>CLI SAPI</literal> attivando l'opzione <literal>-C</literal> + della <literal>CLI SAPI</literal> attivando l'opzione <option>-C</option> quando viene eseguito da linea di comando. </para> </note> @@ -349,9 +350,9 @@ </itemizedlist> </para> <para> - L'elenco completo delle opzioni del <literal>PHP</literal> disponibili da linea di comando - può essere visualizzato in qualsiasi momento eseguendo il <literal>PHP</literal> - con l'opzione <literal>-h</literal>: + L'elenco completo delle opzioni del PHP disponibili da linea di comando + può essere visualizzato in qualsiasi momento eseguendo il PHP + con l'opzione <option>-h</option>: <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] @@ -379,11 +380,11 @@ </para> <para> La vesione <literal>CLI SAPI</literal> ha tre differenti modi per - eseguire il codice <literal>PHP</literal>: + eseguire il codice PHP: <orderedlist> <listitem> <para> - Dire al <literal>PHP</literal> di eseguire certi file. + Dire al PHP di eseguire certi file. </para> <para> <screen> @@ -393,16 +394,16 @@ php -f my_script.php ]]> </screen> - Entrambi i metodi (con o senza l'opzione <literal>-f</literal>) eseguono il + Entrambi i metodi (con o senza l'opzione <option>-f</option>) eseguono il file <filename>my_script.php</filename>. Si può scegliere qualsiasi nome per lo - script da eseguire - non è obbligatorio che gli script <literal>PHP</literal> finiscano - con l'estensione <filename>.php</filename>, ma possono avere qualsiasi nome + script da eseguire - non è obbligatorio che gli script PHP finiscano + con l'estensione <literal>.php</literal>, ma possono avere qualsiasi nome o estensione che si desideri. </para> </listitem> <listitem> <para> - Passare il codice <literal>PHP</literal> da eseguire direttamente da linea di + Passare il codice PHP da eseguire direttamente da linea di comando. </para> <para> @@ -417,19 +418,19 @@ <note> <para> Osservando con attenzione l'esempio si nota l'assenza dei tag di inizio e fine! - L'opzione <literal>-r</literal> non li richiede. L'uso dei tag genera un + L'opzione <option>-r</option> non li richiede. L'uso dei tag genera un errore di parsing. </para> </note> </listitem> <listitem> <para> - Si può passare il codice <literal>PHP</literal> da eseguire via standard input + Si può passare il codice PHP da eseguire via standard input (<literal>stdin</literal>). </para> <para> Questo da la possibilità di generare dinamicamente del codice - <literal>PHP</literal> e passarlo all'eseguibile, come illustrato nel seguente + PHP e passarlo all'eseguibile, come illustrato nel seguente esempio (fittizio): <screen> <![CDATA[ @@ -442,27 +443,27 @@ Non si possono combinare tra loro questi tre metodi di esecuzione del codice. </para> <para> - Come qualsiasi applicazione di shell, anche l'eseguibile <literal>PHP</literal> - accetta diversi argomenti, ma anche lo script <literal>PHP</literal> può ricevere + Come qualsiasi applicazione di shell, anche l'eseguibile PHP + accetta diversi argomenti, ma anche lo script PHP può ricevere argomenti. Il numero degli argomenti passabili allo script non è - limitato dal <literal>PHP</literal> (si rammenta che la shell ha un limite + limitato dal PHP (si rammenta che la shell ha un limite nel numero di caratteri che possono essere passati; solitamente non si raggiunte questo limite). Gli argomenti passati allo script sono disponibili nell'array - <literal>$argv</literal>. L'indice zero contiene sempre il nome dello script - (che è <literal>-</literal> nel caso in cui il codice <literal>PHP</literal> + <varname>$argv</varname>. L'indice zero contiene sempre il nome dello script + (che è <literal>-</literal> nel caso in cui il codice PHP provenda o dallo standard input o dalla linea di comando con l'opzione - <literal>-r</literal>). La seconda variabile globale registrata è - <literal>$argc</literal> la quale contiene il numero degli elementi nella matrice - <literal>$argv</literal> (<emphasis role="strong">non</emphasis> è + <option>-r</option>). La seconda variabile globale registrata è + <varname>$argc</varname> la quale contiene il numero degli elementi nella matrice + <varname>$argv</varname> (<emphasis role="strong">non</emphasis> è il numero degli argomenti passati allo script). </para> <para> Fino a quando gli argomenti passati allo script non iniziano con il carattere <literal>-</literal> non si deve prestare alcuna cautela. Tuttavia se si passa allo script argomenti che iniziano con - <literal>-</literal> si hanno dei problemi perchè lo stesso <literal>PHP</literal> + <literal>-</literal> si hanno dei problemi perchè lo stesso PHP ritiene di doverli gestire. Per evitare ciò occorre utilizzare il separatore di argomenti - <literal>--</literal>. Dopo che il <literal>PHP</literal> ha incontrato questo separatore, + <literal>--</literal>. Dopo che il PHP ha incontrato questo separatore, ogni argomento verrà passato direttamente allo script. </para> @@ -486,12 +487,12 @@ </screen> </para> <para> - Tuttvia esiste un'altro modo per eseguire gli script <literal>PHP</literal>. + Tuttvia esiste un'altro modo per eseguire gli script PHP. Si può scrivere uno script la cui prima riga inizi con <literal>#!/usr/bin/php</literal>. Seguendo questa regola si può posizionare - il normale codice <literal>PHP</literal> tra i tag di apertura e chiusura - del <literal>PHP</literal>. Una volta impostati correttamente gli attributi - del file (ad esempio <literal>chmod +x test</literal>) lo script può essere eseguito + il normale codice PHP tra i tag di apertura e chiusura + del PHP. Una volta impostati correttamente gli attributi + del file (ad esempio <command>chmod +x test</command>) lo script può essere eseguito come una normale shell o script perl: <programlisting role="php"> <![CDATA[ @@ -505,7 +506,7 @@ corrente, si può eseguire: <screen> <![CDATA[ -$ chmod 755 test +$ chmod +x test $ ./test -h -- foo array(4) { [0]=> @@ -552,7 +553,7 @@ <note> <para> Questa opzione non funziona abbinata all'opzione - <literal>-r</literal>. + <option>-r</option>. </para> </note> </entry> @@ -562,7 +563,7 @@ <entry>--syntax-highlighting</entry> <entry> <para> - Alias di <literal>--syntax-highlight</literal>. + Alias di <option>--syntax-highlight</option>. </para> </entry> </row> @@ -576,7 +577,7 @@ <note> <para> Questa opzione non funziona abbinata all'opzione - <literal>-r</literal>. + <option>-r</option>. </para> </note> </entry> @@ -586,7 +587,7 @@ <entry>--file</entry> <entry> <para> - Analizza ed esegue il file passato con l'opzione <literal>-f</literal>. + Analizza ed esegue il file passato con l'opzione <option>-f</option>. Questo parametro è opzionale e può essere omesso. Basta fornire il nome del file da eseguire. </para> @@ -633,7 +634,7 @@ <entry>--no-php-ini</entry> <entry> <para> - Ignora del tutto il php.ini. Opzione disponibile dal PHP 4.3.0. + Ignora del tutto il &php.ini;. Opzione disponibile dal PHP 4.3.0. </para> </entry> </row> @@ -713,7 +714,7 @@ (solitamente, sui sistemi Linux, <filename>/etc/ld.so.conf</filename>). Se si fornisce un nome di file con percorso assoluto, ls libreria non sarà cercata nella directory di default. Un nome di file con percorso relativo - indica al <literal>PHP</literal> di tentare di caricare l'estensione con + indica al PHP di tentare di caricare l'estensione con percorso relativo alla directory corrente. </para> </entry> @@ -724,7 +725,7 @@ <entry> <para> Questa opzione fornisce un metodo pratico per eseguire un controllo sintattico - di un dato codice <literal>PHP</literal>. Se il controllo ha successo, verrà visualizzato il testo + di un dato codice PHP. Se il controllo ha successo, verrà visualizzato il testo <literal>No syntax errors detected in <filename></literal> e alla shell sarà restituito il codice <literal>0</literal>. Se si rilevano errori si avrà il testo <literal>Errors parsing @@ -734,11 +735,11 @@ </para> <para> Questa opzione non rileva errori fatali (tipo funzioni non definite). Occorre - utilizzare l'opzione <literal>-f</literal> se si desidera rilevare gli errori fatali. + utilizzare l'opzione <option>-f</option> se si desidera rilevare gli errori fatali. </para> <note> <para> - Questa opzione non è abbinabile all'opzione <literal>-r</literal>. + Questa opzione non è abbinabile all'opzione <option>-r</option>. </para> </note> </entry> @@ -776,8 +777,8 @@ <entry>--info</entry> <entry> Questa opzione della linea di comando richiama la funzione <function>phpinfo</function>, e ne - visualizza il risultato. Se il <literal>PHP</literal> non funziona correttamente, è opportuno - utilizzare <literal>php -i</literal> per verificare se sono visualizzati messaggi di errore + visualizza il risultato. Se il PHP non funziona correttamente, è opportuno + utilizzare <command>php -i</command> per verificare se sono visualizzati messaggi di errore prima o al posto della tabella con le informazioni. Fare attenzione quando si usa la modalità CGI, l'output è in formato <literal>HTML</literal> e quindi abbastanza abbondante. @@ -788,8 +789,8 @@ <entry>--run</entry> <entry> <para> - Questa opzione permette l'esecuzione di codice <literal>PHP</literal> direttamente - da linea di comando. I tag <literal>PHP</literal> di apertura e di chiusura + Questa opzione permette l'esecuzione di codice PHP direttamente + da linea di comando. I tag PHP di apertura e di chiusura (<literal><?php</literal> e <literal>?></literal>) <emphasis role="strong">non sono necessari</emphasis> anzi, se presenti, causano un errore del parser. @@ -810,9 +811,9 @@ </screen> In questo caso il problema è dovuto alla sostituzione della variabile eseguita da sh/bash anche quando si usano i doppi apici <literal>"</literal>. - Poichè la viriabile <literal>$foo</literal> non è definita, essa + Poichè la viriabile <varname>$foo</varname> non è definita, essa verrà espansa con 'niente' generando il seguente codice - <literal>PHP</literal>: + PHP: <screen> <![CDATA[ $ php -r " = get_defined_constants();" @@ -848,7 +849,7 @@ </note> <note> <para> - L'opzione <literal>-r</literal> è disponibile solo nella <emphasis>CLI</emphasis> + L'opzione <option>-r</option> è disponibile solo nella <emphasis>CLI</emphasis> SAPI e non nella <emphasis>CGI</emphasis> SAPI. </para> </note> @@ -866,7 +867,7 @@ <entry>-?</entry> <entry>--usage</entry> <entry> - Alias di <literal>--help</literal>. + Alias di <option>--help</option>. </entry> </row> <!-- @@ -919,8 +920,8 @@ dal server web. Se ci si trova su sistemi Unix, si può aggiungere una prima linea speciale allo script PHP e renderlo eseguibile, in questo modo il sistema sa quale programma deve interpretare lo script. Sui sistemi Windows si può - associare <literal>php.exe</literal> all'estensione - <literal>.php</literal>, o si può scrivere un batch per eseguire + associare <filename>php.exe</filename> all'estensione + <filename>.php</filename>, o si può scrivere un batch per eseguire gli script tramite PHP. La prima riga inserita per i sistemi Unix non crea problemi in Windows, in questo modo si possono scrivere batch multi-piattaforma. Seguirà un semplice esempio di programma PHP da linea di comando. @@ -965,16 +966,16 @@ </para> <para> Nel programma precedente abbiamo verificato se i parametri passati erano di più o di meno - di uno. Inoltre se l'argomento è <literal>--help</literal>, - <literal>-help</literal>, <literal>-h</literal> oppure <literal>-?</literal>, + di uno. Inoltre se l'argomento è <option>--help</option>, + <option>-help</option>, <option>-h</option> oppure <option>-?</option>, si visualizza un messaggio di aiuto, visualizzando in modo dinamico il nome dello script. Se si riceve un argomento differente questo sarà visualizzato. </para> <para> Se si desidera eseguire lo script precedente su Unix, occorre, per prima cosa, renderlo eseguibile, e quindi richiamarlo con - <literal>script.php echothis</literal> oppure - <literal>script.php -h</literal>. Su Windows occorre scrivere un batch + <command>script.php echothis</command> oppure + <command>script.php -h</command>. Su Windows occorre scrivere un batch per ottenere questo risultato: </para> <para> @@ -993,8 +994,8 @@ CLI di <filename>php.exe</filename> sia in <filename>c:\php\cli\php.exe</filename> questo batch eseguirà lo script con le opzioni passate: - <literal>script.bat echothis</literal> oppure - <literal>script.bat -h</literal>. + <command>script.bat echothis</command> oppure + <command>script.bat -h</command>. </para> <para> Vedere anche la documentazione del modulo http://cvs.php.net/diff.php/phpdoc-it/features/connection-handling.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/features/connection-handling.xml diff -u phpdoc-it/features/connection-handling.xml:1.3 phpdoc-it/features/connection-handling.xml:1.4 --- phpdoc-it/features/connection-handling.xml:1.3 Fri Jun 6 16:12:45 2003 +++ phpdoc-it/features/connection-handling.xml Thu Sep 2 08:15:42 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.14 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.15 Maintainer: darvina Status: ready --> <chapter id="features.connection-handling"> <title>Gestione della connessione</title> @@ -48,8 +48,8 @@ <simpara> Uno script può essere fermato dal timer incorporato nel PHP. Per default il timeout è impostato a 30 secondi. Tale limite può essere variato - agendo sulla direttiva max_execution_time nel &php.ini; o nel corrispondente - parametro "php_value max_execution_time" nella configurazione di Apache, oppure con la + agendo sulla direttiva <option>max_execution_time</option> nel &php.ini; o nel corrispondente + parametro <literal>php_value max_execution_time</literal> nella configurazione di Apache, oppure con la funzione <function>set_time_limit</function>. Quando termina il tempo impostato lo script viene interrotto, se è stata prevista una funzione di shutdown, questa verrà eseguita. All'interno di questa funzione si può discriminare se è
http://cvs.php.net/diff.php/phpdoc-it/features/commandline.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/features/commandline.xml diff -u phpdoc-it/features/commandline.xml:1.2 phpdoc-it/features/commandline.xml:1.3 --- phpdoc-it/features/commandline.xml:1.2 Mon Aug 9 07:56:22 2004 +++ phpdoc-it/features/commandline.xml Thu Sep 2 08:15:42 2004 @@ -1,15 +1,15 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.35 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.36 Maintainer: darvina Status: ready --> <chapter id="features.commandline"> <title>Utilizzo di PHP da linea di comando</title> <!-- NEW DOCUMENTATION STARTS --> <para> - A partire dalla versione 4.3.0, il <literal>PHP</literal> supporta un + A partire dalla versione 4.3.0, il PHP supporta un nuovo tipo di <literal>SAPI</literal> (Server Application Programming Interface) chiamata <literal>CLI</literal> che significa <emphasis>Interfaccia per la Linea di Comando (Command Line Interface)</emphasis>. Come il nome stesso suggerisce, questo tipo di <literal>SAPI</literal> è mirato allo sviluppo di applicazioni shell (o desktop) con - <literal>PHP</literal>. Esistono alcune differenze tra la + PHP. Esistono alcune differenze tra la <literal>CLI SAPI</literal> e le altre <literal>SAPI</literal>; queste saranno illustrate nel corrente capitolo. Val la pena ricordare che <literal>CLI</literal> e <literal>CGI</literal> sono differenti @@ -17,40 +17,40 @@ </para> <para> La <literal>CLI SAPI</literal> è stata rilasciata per la prima volta con - <literal>PHP 4.2.0</literal>, ma era ancora sperimentale e quindi doveva essere - esplicitamente abilitata con <literal>--enable-cli</literal> nell'esecuzione di - <literal>./configure</literal>. A partire dal <literal>PHP 4.3.0</literal> la + PHP 4.2.0, ma era ancora sperimentale e quindi doveva essere + esplicitamente abilitata con <option role="configure">--enable-cli</option> nell'esecuzione di + <command>./configure</command>. A partire dal PHP 4.3.0 la <literal>CLI SAPI</literal> non viene più considerata sperimentale e quindi l'opzione - <literal>--enable-cli</literal> è attivata per default. Vedere - <literal>--disable-cli</literal> per disabilitare l'opzione. + <option role="configure">--enable-cli</option> è attivata per default. Vedere + <option role="configure">--disable-cli</option> per disabilitare l'opzione. </para> <para> Dal PHP 4.3.0, il nome, la posizione, e l'esistenza di eseguibili CLI/CGI differirà in base a come il PHP sarà installato sul sistema. - Per default quando si esegue il <literal>make</literal>, si compila sia la versione CLI sia la versione CGI - e saranno poste rispettivamente in <literal>sapi/cgi/php</literal> e <literal>sapi/cli/php</literal> + Per default quando si esegue il <command>make</command>, si compila sia la versione CLI sia la versione CGI + e saranno poste rispettivamente in <filename>sapi/cgi/php</filename> e <filename>sapi/cli/php</filename> a partire dalla directory dei sorgenti. Occorre notare che entrambi gli eseguibili sono chiamati <literal>php</literal>. Ciò che accade durante l'esecuzione di - <literal>make install</literal> dipende dalla linea di configurazione. + dipende dalla linea di configurazione. Se durante la configurazione si è scelto un modulo SAPI, tipo apxs, o si è attivato - <literal> --disable-cgi</literal>, l'eseguibile CLI viene copiato in - <literal>{PREFIX}/bin/php</literal> durante <literal>make install</literal>, + <option role="configure">--disable-cgi</option>, l'eseguibile CLI viene copiato in + durante <command>make install</command>, altrimenti in questa cartella sarà posto l'eseguibile CGI. Così, per esempio, se si ha - come parametro di configurazione <literal>--with--apxs</literal> allora l'eseguibile CLI - sarà copiato in <literal>{PREFIX}/bin/php</literal> durante <literal>make - install</literal>. Se si vuole evitare l'installazione dell'eseguibile CGI, - utilizzare <literal>make install-cli</literal> dopo <literal>make - install</literal>. In alternativa si può specificare <literal>--disable-cgi - </literal> nella linea di configurazione. + come parametro di configurazione <option role="configure">--with--apxs</option> allora l'eseguibile CLI + sarà copiato in <filename>{PREFIX}/bin/php</filename> durante <command>make + install</command>. Se si vuole evitare l'installazione dell'eseguibile CGI, + utilizzare <command>make install-cli</command> dopo <command>make + install</command>. In alternativa si può specificare <option role="configure">--disable-cgi + </option> nella linea di configurazione. </para> <para> <note> <para> - Poichè sia <literal>--enable-cli</literal> sia <literal> - --enable-cgi</literal> sono abilitati per default, avere semplicemente - <literal>--enable-cli</literal> nella linea di configurazione non significa - necessariamente che l'eseguibile CLI sia copiato come <literal> - {PREFIX}/bin/php</literal> con l'esecuzione di <literal>make install</literal>. + Poichè sia <option role="configure">--enable-cli</option> sia + <option role="configure">--enable-cgi</option> sono abilitati per default, avere semplicemente + <option role="configure">--enable-cli</option> nella linea di configurazione non significa + necessariamente che l'eseguibile CLI sia copiato come <filename>{PREFIX}/bin/php</filename> + con l'esecuzione di <command>make install</command>. </para> </note> </para> @@ -58,8 +58,8 @@ Nel pacchetto per Windows, nelle versioni tra PHP 4.2.0 e PHP 4.2.3, l'eseguibile CLI era presente come <filename>php-cli.exe</filename>, nella medesima cartella della versione CGI <filename>php.exe</filename>. A partire dal PHP 4.3.0 nel pacchetto per Windows la versione CLI viene - distribuita come <filename>php.exe</filename> in una cartella a parte chiamata <literal>cli</literal>, - avendo perciò <literal>cli/php.exe</literal>. + distribuita come <filename>php.exe</filename> in una cartella a parte chiamata <filename class="directory">cli</filename>, + avendo perciò <filename>cli/php.exe</filename>. A partire dal PHP 5, la versione CLI viene inserita nella cartella principale, con il nome <filename>php.exe</filename>. La versione CGI sarà chiamata <filename>php-cgi.exe</filename>. @@ -69,14 +69,14 @@ Questo è equivalente alla versione CLI, tranne che php-win non visualizzerà nulla e quindi non vi sarà la finestra di console (non compare la fienstra dos nello schermo). Questo comportamento è stato ripreso da php-gtk. Si dovrebbe configurare il PHP con - <literal>--enable-cli-win32</literal>. + <option role="configure">--enable-cli-win32</option>. </para> <para> <note> <title>Quale SAPI ho?</title> <para> - Da shell, digitando <literal>php -v</literal> si avrà l'informazione di - quale <literal>php</literal> si tratta, CGI o CLI. Vedere anche la funzione + Da shell, digitando <command>php -v</command> si avrà l'informazione di + quale <filename>php</filename> si tratta, CGI o CLI. Vedere anche la funzione <function>php_sapi_name</function>e la costante <constant> PHP_SAPI</constant> per dettagli. </para> @@ -86,7 +86,7 @@ <note> <para> Una pagina stile <literal>man</literal> di Unix è stata aggiunta in PHP 4.3.2. La si può - visualizzare digitando <literal>man php</literal> da linea di comando. + visualizzare digitando <command>man php</command> da linea di comando. </para> </note> </para> @@ -106,11 +106,12 @@ </para> <para> Per default CLI parte in modalità silenziosa, si è mantenuto, comunque, - l'opzione <literal>-q</literal> e <literal>--no-header</literal> per motivi di compatibilità; in questo modo si possono utlizzare i vecchi script CGI. + l'opzione <option>-q</option> e <option>--no-header</option> per motivi di compatibilità; + in questo modo si possono utlizzare i vecchi script CGI. </para> <para> Non cambia la directory di lavoro in quella dello script. - (E' rimasta l'opzione <literal>-C</literal> e <literal>--no-chdir</literal> per compatibilità) + (E' rimasta l'opzione <option>-C</option> e <option>--no-chdir</option> per compatibilità) </para> <para> Messaggi di errore in formato testo (non formattati in HTML). @@ -157,7 +158,7 @@ <entry><link linkend="ini.max-execution-time">max_execution_time</link></entry> <entry>0 (unlimited)</entry> <entry> - Considerate le svariate possibilità offerte da <literal>PHP</literal> + Considerate le svariate possibilità offerte da PHP nell'ambiente di shell, il tempo massimo di esecuzione è stato impostato a infinito. Mentre nelle applicazione scritte per il web i tempi di esecuzione sono rapidi, le applicazioni di shell tendono ad avere tempi di esecuzione @@ -290,7 +291,7 @@ ]]> </programlisting> Non occorre chiudere esplicitamente questi flussi, saranno chiusi automaticamente - dal <literal>PHP</literal> alla fine dello script. + dal PHP alla fine dello script. </para> </listitem> <listitem> @@ -321,7 +322,7 @@ /tmp/another_directory ]]> </screen> - Questo evidenzia chiaramente come il <literal>PHP</literal> cambi la + Questo evidenzia chiaramente come il PHP cambi la directory corrente con quella in cui si trova lo script. </para> <para> @@ -336,12 +337,12 @@ ]]> </screen> Questo permette una grande flessibilità nello scrivere tools in - <literal>PHP</literal>. + PHP. </para> <note> <para> La <literal>CGI SAPI</literal> supporta il comportamento - della <literal>CLI SAPI</literal> attivando l'opzione <literal>-C</literal> + della <literal>CLI SAPI</literal> attivando l'opzione <option>-C</option> quando viene eseguito da linea di comando. </para> </note> @@ -349,9 +350,9 @@ </itemizedlist> </para> <para> - L'elenco completo delle opzioni del <literal>PHP</literal> disponibili da linea di comando - può essere visualizzato in qualsiasi momento eseguendo il <literal>PHP</literal> - con l'opzione <literal>-h</literal>: + L'elenco completo delle opzioni del PHP disponibili da linea di comando + può essere visualizzato in qualsiasi momento eseguendo il PHP + con l'opzione <option>-h</option>: <screen> <![CDATA[ Usage: php [options] [-f] <file> [args...] @@ -379,11 +380,11 @@ </para> <para> La vesione <literal>CLI SAPI</literal> ha tre differenti modi per - eseguire il codice <literal>PHP</literal>: + eseguire il codice PHP: <orderedlist> <listitem> <para> - Dire al <literal>PHP</literal> di eseguire certi file. + Dire al PHP di eseguire certi file. </para> <para> <screen> @@ -393,16 +394,16 @@ php -f my_script.php ]]> </screen> - Entrambi i metodi (con o senza l'opzione <literal>-f</literal>) eseguono il + Entrambi i metodi (con o senza l'opzione <option>-f</option>) eseguono il file <filename>my_script.php</filename>. Si può scegliere qualsiasi nome per lo - script da eseguire - non è obbligatorio che gli script <literal>PHP</literal> finiscano - con l'estensione <filename>.php</filename>, ma possono avere qualsiasi nome + script da eseguire - non è obbligatorio che gli script PHP finiscano + con l'estensione <literal>.php</literal>, ma possono avere qualsiasi nome o estensione che si desideri. </para> </listitem> <listitem> <para> - Passare il codice <literal>PHP</literal> da eseguire direttamente da linea di + Passare il codice PHP da eseguire direttamente da linea di comando. </para> <para> @@ -417,19 +418,19 @@ <note> <para> Osservando con attenzione l'esempio si nota l'assenza dei tag di inizio e fine! - L'opzione <literal>-r</literal> non li richiede. L'uso dei tag genera un + L'opzione <option>-r</option> non li richiede. L'uso dei tag genera un errore di parsing. </para> </note> </listitem> <listitem> <para> - Si può passare il codice <literal>PHP</literal> da eseguire via standard input + Si può passare il codice PHP da eseguire via standard input (<literal>stdin</literal>). </para> <para> Questo da la possibilità di generare dinamicamente del codice - <literal>PHP</literal> e passarlo all'eseguibile, come illustrato nel seguente + PHP e passarlo all'eseguibile, come illustrato nel seguente esempio (fittizio): <screen> <![CDATA[ @@ -442,27 +443,27 @@ Non si possono combinare tra loro questi tre metodi di esecuzione del codice. </para> <para> - Come qualsiasi applicazione di shell, anche l'eseguibile <literal>PHP</literal> - accetta diversi argomenti, ma anche lo script <literal>PHP</literal> può ricevere + Come qualsiasi applicazione di shell, anche l'eseguibile PHP + accetta diversi argomenti, ma anche lo script PHP può ricevere argomenti. Il numero degli argomenti passabili allo script non è - limitato dal <literal>PHP</literal> (si rammenta che la shell ha un limite + limitato dal PHP (si rammenta che la shell ha un limite nel numero di caratteri che possono essere passati; solitamente non si raggiunte questo limite). Gli argomenti passati allo script sono disponibili nell'array - <literal>$argv</literal>. L'indice zero contiene sempre il nome dello script - (che è <literal>-</literal> nel caso in cui il codice <literal>PHP</literal> + <varname>$argv</varname>. L'indice zero contiene sempre il nome dello script + (che è <literal>-</literal> nel caso in cui il codice PHP provenda o dallo standard input o dalla linea di comando con l'opzione - <literal>-r</literal>). La seconda variabile globale registrata è - <literal>$argc</literal> la quale contiene il numero degli elementi nella matrice - <literal>$argv</literal> (<emphasis role="strong">non</emphasis> è + <option>-r</option>). La seconda variabile globale registrata è + <varname>$argc</varname> la quale contiene il numero degli elementi nella matrice + <varname>$argv</varname> (<emphasis role="strong">non</emphasis> è il numero degli argomenti passati allo script). </para> <para> Fino a quando gli argomenti passati allo script non iniziano con il carattere <literal>-</literal> non si deve prestare alcuna cautela. Tuttavia se si passa allo script argomenti che iniziano con - <literal>-</literal> si hanno dei problemi perchè lo stesso <literal>PHP</literal> + <literal>-</literal> si hanno dei problemi perchè lo stesso PHP ritiene di doverli gestire. Per evitare ciò occorre utilizzare il separatore di argomenti - <literal>--</literal>. Dopo che il <literal>PHP</literal> ha incontrato questo separatore, + <literal>--</literal>. Dopo che il PHP ha incontrato questo separatore, ogni argomento verrà passato direttamente allo script. </para> @@ -486,12 +487,12 @@ </screen> </para> <para> - Tuttvia esiste un'altro modo per eseguire gli script <literal>PHP</literal>. + Tuttvia esiste un'altro modo per eseguire gli script PHP. Si può scrivere uno script la cui prima riga inizi con <literal>#!/usr/bin/php</literal>. Seguendo questa regola si può posizionare - il normale codice <literal>PHP</literal> tra i tag di apertura e chiusura - del <literal>PHP</literal>. Una volta impostati correttamente gli attributi - del file (ad esempio <literal>chmod +x test</literal>) lo script può essere eseguito + il normale codice PHP tra i tag di apertura e chiusura + del PHP. Una volta impostati correttamente gli attributi + del file (ad esempio <command>chmod +x test</command>) lo script può essere eseguito come una normale shell o script perl: <programlisting role="php"> <![CDATA[ @@ -505,7 +506,7 @@ corrente, si può eseguire: <screen> <![CDATA[ -$ chmod 755 test +$ chmod +x test $ ./test -h -- foo array(4) { [0]=> @@ -552,7 +553,7 @@ <note> <para> Questa opzione non funziona abbinata all'opzione - <literal>-r</literal>. + <option>-r</option>. </para> </note> </entry> @@ -562,7 +563,7 @@ <entry>--syntax-highlighting</entry> <entry> <para> - Alias di <literal>--syntax-highlight</literal>. + Alias di <option>--syntax-highlight</option>. </para> </entry> </row> @@ -576,7 +577,7 @@ <note> <para> Questa opzione non funziona abbinata all'opzione - <literal>-r</literal>. + <option>-r</option>. </para> </note> </entry> @@ -586,7 +587,7 @@ <entry>--file</entry> <entry> <para> - Analizza ed esegue il file passato con l'opzione <literal>-f</literal>. + Analizza ed esegue il file passato con l'opzione <option>-f</option>. Questo parametro è opzionale e può essere omesso. Basta fornire il nome del file da eseguire. </para> @@ -633,7 +634,7 @@ <entry>--no-php-ini</entry> <entry> <para> - Ignora del tutto il php.ini. Opzione disponibile dal PHP 4.3.0. + Ignora del tutto il &php.ini;. Opzione disponibile dal PHP 4.3.0. </para> </entry> </row> @@ -713,7 +714,7 @@ (solitamente, sui sistemi Linux, <filename>/etc/ld.so.conf</filename>). Se si fornisce un nome di file con percorso assoluto, ls libreria non sarà cercata nella directory di default. Un nome di file con percorso relativo - indica al <literal>PHP</literal> di tentare di caricare l'estensione con + indica al PHP di tentare di caricare l'estensione con percorso relativo alla directory corrente. </para> </entry> @@ -724,7 +725,7 @@ <entry> <para> Questa opzione fornisce un metodo pratico per eseguire un controllo sintattico - di un dato codice <literal>PHP</literal>. Se il controllo ha successo, verrà visualizzato il testo + di un dato codice PHP. Se il controllo ha successo, verrà visualizzato il testo <literal>No syntax errors detected in <filename></literal> e alla shell sarà restituito il codice <literal>0</literal>. Se si rilevano errori si avrà il testo <literal>Errors parsing @@ -734,11 +735,11 @@ </para> <para> Questa opzione non rileva errori fatali (tipo funzioni non definite). Occorre - utilizzare l'opzione <literal>-f</literal> se si desidera rilevare gli errori fatali. + utilizzare l'opzione <option>-f</option> se si desidera rilevare gli errori fatali. </para> <note> <para> - Questa opzione non è abbinabile all'opzione <literal>-r</literal>. + Questa opzione non è abbinabile all'opzione <option>-r</option>. </para> </note> </entry> @@ -776,8 +777,8 @@ <entry>--info</entry> <entry> Questa opzione della linea di comando richiama la funzione <function>phpinfo</function>, e ne - visualizza il risultato. Se il <literal>PHP</literal> non funziona correttamente, è opportuno - utilizzare <literal>php -i</literal> per verificare se sono visualizzati messaggi di errore + visualizza il risultato. Se il PHP non funziona correttamente, è opportuno + utilizzare <command>php -i</command> per verificare se sono visualizzati messaggi di errore prima o al posto della tabella con le informazioni. Fare attenzione quando si usa la modalità CGI, l'output è in formato <literal>HTML</literal> e quindi abbastanza abbondante. @@ -788,8 +789,8 @@ <entry>--run</entry> <entry> <para> - Questa opzione permette l'esecuzione di codice <literal>PHP</literal> direttamente - da linea di comando. I tag <literal>PHP</literal> di apertura e di chiusura + Questa opzione permette l'esecuzione di codice PHP direttamente + da linea di comando. I tag PHP di apertura e di chiusura (<literal><?php</literal> e <literal>?></literal>) <emphasis role="strong">non sono necessari</emphasis> anzi, se presenti, causano un errore del parser. @@ -810,9 +811,9 @@ </screen> In questo caso il problema è dovuto alla sostituzione della variabile eseguita da sh/bash anche quando si usano i doppi apici <literal>"</literal>. - Poichè la viriabile <literal>$foo</literal> non è definita, essa + Poichè la viriabile <varname>$foo</varname> non è definita, essa verrà espansa con 'niente' generando il seguente codice - <literal>PHP</literal>: + PHP: <screen> <![CDATA[ $ php -r " = get_defined_constants();" @@ -848,7 +849,7 @@ </note> <note> <para> - L'opzione <literal>-r</literal> è disponibile solo nella <emphasis>CLI</emphasis> + L'opzione <option>-r</option> è disponibile solo nella <emphasis>CLI</emphasis> SAPI e non nella <emphasis>CGI</emphasis> SAPI. </para> </note> @@ -866,7 +867,7 @@ <entry>-?</entry> <entry>--usage</entry> <entry> - Alias di <literal>--help</literal>. + Alias di <option>--help</option>. </entry> </row> <!-- @@ -919,8 +920,8 @@ dal server web. Se ci si trova su sistemi Unix, si può aggiungere una prima linea speciale allo script PHP e renderlo eseguibile, in questo modo il sistema sa quale programma deve interpretare lo script. Sui sistemi Windows si può - associare <literal>php.exe</literal> all'estensione - <literal>.php</literal>, o si può scrivere un batch per eseguire + associare <filename>php.exe</filename> all'estensione + <filename>.php</filename>, o si può scrivere un batch per eseguire gli script tramite PHP. La prima riga inserita per i sistemi Unix non crea problemi in Windows, in questo modo si possono scrivere batch multi-piattaforma. Seguirà un semplice esempio di programma PHP da linea di comando. @@ -965,16 +966,16 @@ </para> <para> Nel programma precedente abbiamo verificato se i parametri passati erano di più o di meno - di uno. Inoltre se l'argomento è <literal>--help</literal>, - <literal>-help</literal>, <literal>-h</literal> oppure <literal>-?</literal>, + di uno. Inoltre se l'argomento è <option>--help</option>, + <option>-help</option>, <option>-h</option> oppure <option>-?</option>, si visualizza un messaggio di aiuto, visualizzando in modo dinamico il nome dello script. Se si riceve un argomento differente questo sarà visualizzato. </para> <para> Se si desidera eseguire lo script precedente su Unix, occorre, per prima cosa, renderlo eseguibile, e quindi richiamarlo con - <literal>script.php echothis</literal> oppure - <literal>script.php -h</literal>. Su Windows occorre scrivere un batch + <command>script.php echothis</command> oppure + <command>script.php -h</command>. Su Windows occorre scrivere un batch per ottenere questo risultato: </para> <para> @@ -993,8 +994,8 @@ CLI di <filename>php.exe</filename> sia in <filename>c:\php\cli\php.exe</filename> questo batch eseguirà lo script con le opzioni passate: - <literal>script.bat echothis</literal> oppure - <literal>script.bat -h</literal>. + <command>script.bat echothis</command> oppure + <command>script.bat -h</command>. </para> <para> Vedere anche la documentazione del modulo http://cvs.php.net/diff.php/phpdoc-it/features/connection-handling.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/features/connection-handling.xml diff -u phpdoc-it/features/connection-handling.xml:1.3 phpdoc-it/features/connection-handling.xml:1.4 --- phpdoc-it/features/connection-handling.xml:1.3 Fri Jun 6 16:12:45 2003 +++ phpdoc-it/features/connection-handling.xml Thu Sep 2 08:15:42 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.14 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.15 Maintainer: darvina Status: ready --> <chapter id="features.connection-handling"> <title>Gestione della connessione</title> @@ -48,8 +48,8 @@ <simpara> Uno script può essere fermato dal timer incorporato nel PHP. Per default il timeout è impostato a 30 secondi. Tale limite può essere variato - agendo sulla direttiva max_execution_time nel &php.ini; o nel corrispondente - parametro "php_value max_execution_time" nella configurazione di Apache, oppure con la + agendo sulla direttiva <option>max_execution_time</option> nel &php.ini; o nel corrispondente + parametro <literal>php_value max_execution_time</literal> nella configurazione di Apache, oppure con la funzione <function>set_time_limit</function>. Quando termina il tempo impostato lo script viene interrotto, se è stata prevista una funzione di shutdown, questa verrà eseguita. All'interno di questa funzione si può discriminare se è