cvs: phpdoc-it / language-defs.ent language-snippets.ent /features commandline.xml connection-handling.xml cookies.xml http-auth.xml
persistent-connections.xml remote-files.xml /reference/classobj/functions call-user-method-array.xml call-user-method.xml /reference/dir/functions
chdir.xml chroot.xml class.dir.xml closedir.xml getcwd.xml opendir.xml readdir.xml rewinddir.xml /reference/exec/functions escapeshellarg.xml
escapeshellcmd.xml exec.xml passthru.xml shell-exec.xml system.xml
| From: | Andrioli Darvin | Date: | Thu, 03 Feb 2005 13:18:15 +0000 |
| Subject: | cvs: phpdoc-it / language-defs.ent language-snippets.ent /features commandline.xml connection-handling.xml cookies.xml http-auth.xml persistent-connections.xml remote-files.xml /reference/classobj/functions call-user-method-array.xml call-user-method.xml /reference/dir/functions chdir.xml chroot.xml class.dir.xml closedir.xml getcwd.xml opendir.xml readdir.xml rewinddir.xml /reference/exec/functions escapeshellarg.xml escapeshellcmd.xml exec.xml passthru.xml shell-exec.xml system.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-683@lists.php.net to get a copy of this message | ||
darvina Thu Feb 3 08:18:15 2005 EDT
Modified files:
/phpdoc-it/features commandline.xml connection-handling.xml
cookies.xml http-auth.xml
persistent-connections.xml remote-files.xml
/phpdoc-it language-defs.ent language-snippets.ent
/phpdoc-it/reference/classobj/functions call-user-method-array.xml
call-user-method.xml
/phpdoc-it/reference/dir/functions chdir.xml chroot.xml
class.dir.xml closedir.xml
getcwd.xml opendir.xml
readdir.xml rewinddir.xml
/phpdoc-it/reference/exec/functions escapeshellarg.xml
escapeshellcmd.xml exec.xml
passthru.xml shell-exec.xml
system.xml
Log:
Translation update by Fernando and me
http://cvs.php.net/diff.php/phpdoc-it/features/commandline.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/features/commandline.xml diff -u phpdoc-it/features/commandline.xml:1.3 phpdoc-it/features/commandline.xml:1.4 --- phpdoc-it/features/commandline.xml:1.3 Thu Sep 2 08:15:42 2004 +++ phpdoc-it/features/commandline.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.36 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.38 Maintainer: darvina Status: ready --> <chapter id="features.commandline"> <title>Utilizzo di PHP da linea di comando</title> <!-- NEW DOCUMENTATION STARTS --> @@ -839,8 +839,8 @@ ]]> </screen> Se si utilizzano shell differenti rispetto a sh/bash, si potrebbe incorrere - in altri problemi. In tal caso aprite una segnalazione di errore o inviate una - mail a phpdoc@lists.php.net. + in altri problemi. In tal caso aprite una segnalazione di errore a <ulink url="&url.php.bugs;">&url.php.bugs;</ulink> + o inviate una mail a &email.php.doc;. Tuttavia si può facilmente incorrere in problemi nell'avere variabili di shell nel codice o nell'utilizzare le barre rovesciate (backslash) per l'escape. http://cvs.php.net/diff.php/phpdoc-it/features/connection-handling.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/features/connection-handling.xml diff -u phpdoc-it/features/connection-handling.xml:1.4 phpdoc-it/features/connection-handling.xml:1.5 --- phpdoc-it/features/connection-handling.xml:1.4 Thu Sep 2 08:15:42 2004 +++ phpdoc-it/features/connection-handling.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.15 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.17 Maintainer: darvina Status: ready --> <chapter id="features.connection-handling"> <title>Gestione della connessione</title> @@ -54,9 +54,9 @@ lo script viene interrotto, se è stata prevista una funzione di shutdown, questa verrà eseguita. All'interno di questa funzione si può discriminare se è stata attivata per lo scadere del timeout utilizzando la - funzione <function>connection_timeout</function>. Questa restituisce - &true; se la funzione di shutdown è stata chiamata per lo scadere del tempo a disposizione.</simpara> - + funzione <function>connection_timeout</function>. Questa restituisce 2 + se la funzione di shutdown è stata chiamata per lo scadere del tempo a disposizione. + </simpara> <simpara> Un aspetto che occorre notare sui stati ABORTED e TIMEOUT è che possono essere attivi contemporaneamente. Questo può accadere @@ -64,12 +64,9 @@ continua a tenere traccia della disconnessione dell'utente, ma, semplicemente, non viene interrotto lo script. Quindi, quando termina il tempo, lo script sarà interrotto e verrà richiamata la funzione di shutdown, se presente. In questa situazione - sia <function>connection_timeout</function> sia - <function>connection_aborted</function> restituiranno &true;. - Si può anche verificare entrambi gli stati tramite una chiamata singola - utilizzando la funzione <function>connection_status</function>. Questa restituisce - un campo di bit con l'indicazione degli stati attivi. Quindi, ad esempio, se entrambi gli - stati sono attivi, la funzione restituirà 3.</simpara> + si avrà che <function>connection_status</function> + restituirà 3. + </simpara> </chapter> http://cvs.php.net/diff.php/phpdoc-it/features/cookies.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-it/features/cookies.xml diff -u phpdoc-it/features/cookies.xml:1.9 phpdoc-it/features/cookies.xml:1.10 --- phpdoc-it/features/cookies.xml:1.9 Fri Jul 11 15:54:41 2003 +++ phpdoc-it/features/cookies.xml Thu Feb 3 08:18:14 2005 @@ -1,15 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.15 Maintainer: perugini Status: ready --> +<!-- EN-Revision: 1.20 Maintainer: perugini Status: ready --> <!-- CREDITS: latoserver --> <chapter id="features.cookies"> <title>Cookies</title> <para> - PHP supporta in modo trasparente i cookies HTTP. I cookies sono un meccanismo + PHP supporta in modo trasparente i cookies <acronym>HTTP</acronym>. I cookies sono un meccanismo per memorizzare dati nel browser remoto e tenere traccia degli utenti - o identificarli al loro ritorno. I cookies possono essere impostati tramite la - funzione <function>setcookie</function>. I cookies sono parte dell'intestazione - HTTP, quindi <function>setcookie</function> deve essere chiamata prima + o identificarli al loro ritorno. I cookies possono essere impostati tramite le + funzioni <function>setcookie</function> oppure <function>setrawcookie</function>. + I cookies sono parte dell'intestazione + <acronym>HTTP</acronym>, quindi <function>setcookie</function> deve essere chiamata prima che qualsiasi output sia inviato al browser. Si tratta della stessa limitazione della funzione <function>header</function>. Si può utilizzare la <link linkend="ref.outcontrol">funzione di buffer dell'output</link> per @@ -19,9 +20,10 @@ <para> Ogni cookie inviato dal client sarà automaticamente trasformato - in una variabile PHP, come avviene nel caso di dati GET o POST, in base - alle variabili di configurazione <literal>register_globals</literal> e - <literal>variables_order</literal>. Se si vogliono assegnare più + in una variabile PHP, come avviene nel caso di dati <literal>GET</literal> o <literal>POST</literal>, in base + alle variabili di configurazione <link linkend="ini.register-globals">register_globals</link> e + <link linkend="ini.variables-order">variables_order</link>. + Se si vogliono assegnare più valori ad un singolo cookie, basta aggiungere <literal>[]</literal> al nome del cookie. </para> @@ -30,13 +32,14 @@ sarà sempre impostato con qualsiasi cookies inviati dal client. <varname>$HTTP_COOKIE_VARS</varname> è anch'essa impostata nelle versioni precedenti del PHP se è impostata la variabile di - configurazione <literal>track_vars</literal>. (Questo parametro è sempre a on + configurazione <link linkend="ini.track-vars">track_vars</link>. (Questo parametro è sempre a on a partire da PHP 4.0.3.) </para> <para> Per maggiori dettagli - si veda la funzione <function>setcookie</function>. + si vedano le funzioni <function>setcookie</function> e + <function>setrawcookie</function>. </para> </chapter> http://cvs.php.net/diff.php/phpdoc-it/features/http-auth.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-it/features/http-auth.xml diff -u phpdoc-it/features/http-auth.xml:1.14 phpdoc-it/features/http-auth.xml:1.15 --- phpdoc-it/features/http-auth.xml:1.14 Mon Aug 2 08:02:22 2004 +++ phpdoc-it/features/http-auth.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.40 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.41 Maintainer: cortesi Status: ready --> <!-- CREDITS: matteobug --> <chapter id="features.http-auth"> <title>Autenticazione HTTP usando PHP</title> @@ -166,7 +166,7 @@ </simpara> <simpara> - Un'altra limitazione è che se si usa il modulo IIS (ISAPI) non si possono + Un'altra limitazione è che se si usa il modulo IIS (ISAPI) e PHP 4, non si possono usare le variabili <literal>PHP_AUTH_*</literal> ma, al contrario, la variabile <literal>HTTP_AUTHORIZATION</literal> è disponibile. Per esempio, si consideri il seguente codice: <literal>list($user, $pw) = explode(':', http://cvs.php.net/diff.php/phpdoc-it/features/persistent-connections.xml?r1=1.12&r2=1.13&ty=u Index: phpdoc-it/features/persistent-connections.xml diff -u phpdoc-it/features/persistent-connections.xml:1.12 phpdoc-it/features/persistent-connections.xml:1.13 --- phpdoc-it/features/persistent-connections.xml:1.12 Sat May 31 07:24:36 2003 +++ phpdoc-it/features/persistent-connections.xml Thu Feb 3 08:18:14 2005 @@ -1,10 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.21 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.24 Maintainer: darvina Status: ready --> +<!-- CREDITS: cortesi --> <chapter id="features.persistent-connections"> <title>Connessioni Persistenti ai Database</title> <simpara> - Connessioni persistenti sono collegamenti SQL che non vengono chiusi quando + Connessioni persistenti sono collegamenti che non vengono chiusi quando l'esecusione di uno script viene terminata. Quando è richiesta una connessione persistente, PHP controlla se esiste già una identica connessione persistente (che è rimasta aperta da prima) - e se esiste, la @@ -12,17 +13,11 @@ è una connessione aperta verso lo stesso host, con lo stesso username e la stessa password (dove applicabile). </simpara> - <note> - <para> - Ci sono altre estensioni che permettono di usare connessioni persistenti, ad - esempio l'<link linkend="ref.imap">estensione IMAP</link>. - </para> - </note> <simpara> Chi non ha molta familiarità con il modo in cui lavorano i server web e di come essi distribuiscano il carico potrebbero confondere le connessioni permanenti per ciò che esse non sono. In particolare, <emphasis>non</emphasis> danno - la possibilità di aprire 'sessioni utente' sullo stesso collegamento SQL, + la possibilità di aprire 'sessioni utente' sullo stesso collegamento, <emphasis>non</emphasis> danno la possibilità di gestire una transazione in maniera efficiente e sopratutto non fanno molte altre cose. Infatti, per essere molto chiari su questo punto, @@ -56,14 +51,9 @@ client, questa è passata ad uno dei figli che in quel momento non è già occupato a servire un altro client. Questo significa che quando lo stesso client effettua una seconda richiesta al server, esso potrà essere servito da un diverso processo - figlio rispetto a quello della prima volta. In questa situazione, usare una - connessione persistente, permette di stabilire una e una sola connessione - al database SQL per ogni processo figlio, poiché ciascun - processo figlio necessita di collegarsi al database SQL solo la - prima volta che richiama una pagina che ne fa uso. Quando viene richamata - un'altra pagina che necessita di una connessione al server SQL, essa può - riutilizzare la connessione che lo stesso processo figlio aveva - stabilito in precedenza. + figlio rispetto a quello della prima volta. Quando si aprono delle connessioni persistenti, + ciascuna pagina successiva che richiede dei servizi SQL, può riutilizzare la + connessione al server SQL precedente. </simpara> <simpara> L'ultimo metodo è quello di usare il PHP come una plug-in per un server web @@ -137,7 +127,7 @@ <para> Vedere anche <function>fbsql_pconnect</function>, <function>ibase_pconnect</function>, <function>ifx_pconnect</function>, - <function>imap_popen</function>, <function>ingres_pconnect</function>, + <function>ingres_pconnect</function>, <function>msql_pconnect</function>, <function>mssql_pconnect</function>, <function>mysql_pconnect</function>, <function>ocipLogon</function>, <function>odbc_pconnect</function>, <function>ora_pLogon</function>, http://cvs.php.net/diff.php/phpdoc-it/features/remote-files.xml?r1=1.13&r2=1.14&ty=u Index: phpdoc-it/features/remote-files.xml diff -u phpdoc-it/features/remote-files.xml:1.13 phpdoc-it/features/remote-files.xml:1.14 --- phpdoc-it/features/remote-files.xml:1.13 Sat May 31 07:24:57 2003 +++ phpdoc-it/features/remote-files.xml Thu Feb 3 08:18:14 2005 @@ -1,17 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.22 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.26 Maintainer: cortesi Status: ready --> <!-- CREDITS: marco --> <chapter id="features.remote-files"> <title>Utilizzo di file remoti</title> <para> Se <parameter>allow_url_fopen</parameter> è abilitato in - &php.ini;, si possono usare URL FTP e HTTP con la maggior parte delle funzioni che + &php.ini;, si possono usare gli URL <acronym>HTTP</acronym> e <acronym>FTP</acronym> + con la maggior parte delle funzioni che richiedono nomi di file come parametri, incluse le funzioni <function>require</function>, <function>require_once</function>, <function>include</function> e <function>include_once</function>. Vedere <xref linkend="wrappers"/> per maggiori dettagli sui protocolli supportati dal - &php;. + PHP. </para> <note> <para> @@ -23,7 +24,7 @@ <para> <note> <para> - Al momento, le versioni Windows di <literal>PHP</literal> precedenti la 4.3, non supportano + Al momento, le versioni Windows di PHP precedenti la 4.3, non supportano l'accesso remoto ai file con le seguenti funzioni: <function>include</function>, <function>include_once</function>, <function>require</function> e <function>require_once</function> @@ -89,7 +90,7 @@ exit; } /* Scrive i dati qui. */ -fputs ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); +fwrite ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); fclose ($file); ?> ]]> http://cvs.php.net/diff.php/phpdoc-it/language-defs.ent?r1=1.17&r2=1.18&ty=u Index: phpdoc-it/language-defs.ent diff -u phpdoc-it/language-defs.ent:1.17 phpdoc-it/language-defs.ent:1.18 --- phpdoc-it/language-defs.ent:1.17 Tue Jan 25 08:26:24 2005 +++ phpdoc-it/language-defs.ent Thu Feb 3 08:18:14 2005 @@ -1,4 +1,4 @@ -<!-- EN-Revision: 1.23 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.24 Maintainer: darvina Status: ready --> <!-- CREDITS: perugini --> <!-- Part titles used mostly in manual.xml itself --> @@ -51,3 +51,4 @@ <!ENTITY reftitle.runtime '<title>Configurazione di Runtime</title>'> <!ENTITY reftitle.returnvalues '<title>Valori restituiti</title>'> <!ENTITY reftitle.seealso '<title>Vedere anche:</title>'> +<!ENTITY reftitle.notes '<title>Note</title>'> http://cvs.php.net/diff.php/phpdoc-it/language-snippets.ent?r1=1.41&r2=1.42&ty=u Index: phpdoc-it/language-snippets.ent diff -u phpdoc-it/language-snippets.ent:1.41 phpdoc-it/language-snippets.ent:1.42 --- phpdoc-it/language-snippets.ent:1.41 Tue Jan 25 08:26:24 2005 +++ phpdoc-it/language-snippets.ent Thu Feb 3 08:18:14 2005 @@ -1,4 +1,4 @@ -<!-- EN-Revision: 1.132 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.134 Maintainer: darvina Status: ready --> <!-- CREDITS: perugini --> <!-- Notes --> @@ -238,6 +238,9 @@ la directory nella quale si sta lavorando, abbia lo stesso UID dello script che è in esecuzione.</simpara></note>'> +<!ENTITY note.open-basedir.func '<note><para><link +linkend="ini.open-basedir">open_basedir</link> influisce su questa funzione.</para></note>'> + <!ENTITY note.language-construct '<note><simpara>Poichè questo è un costrutto del linguaggio e non una funzione, non può essere chiamato con le <link linkend="functions.variable-functions">variabili funzione</link></simpara> http://cvs.php.net/diff.php/phpdoc-it/reference/classobj/functions/call-user-method-array.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/classobj/functions/call-user-method-array.xml diff -u phpdoc-it/reference/classobj/functions/call-user-method-array.xml:1.5 phpdoc-it/reference/classobj/functions/call-user-method-array.xml:1.6 --- phpdoc-it/reference/classobj/functions/call-user-method-array.xml:1.5 Thu Sep 16 08:20:23 2004 +++ phpdoc-it/reference/classobj/functions/call-user-method-array.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/classobj.xml, last change in rev 1.12 --> <!-- last change to 'call-user-method-array' in en/ tree in rev 1.36 --> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.38/EN.1.36 --> <refentry id="function.call-user-method-array"> <refnamediv> @@ -15,7 +15,7 @@ <methodsynopsis> <type>mixed</type><methodname>call_user_method_array</methodname> <methodparam><type>string</type><parameter>nome_metodo</parameter></methodparam> - <methodparam><type>object</type><parameter>&obj</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> <methodparam><type>array</type><parameter>paramarr</parameter></methodparam> </methodsynopsis> <warning> http://cvs.php.net/diff.php/phpdoc-it/reference/classobj/functions/call-user-method.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-it/reference/classobj/functions/call-user-method.xml diff -u phpdoc-it/reference/classobj/functions/call-user-method.xml:1.7 phpdoc-it/reference/classobj/functions/call-user-method.xml:1.8 --- phpdoc-it/reference/classobj/functions/call-user-method.xml:1.7 Mon Aug 9 08:01:46 2004 +++ phpdoc-it/reference/classobj/functions/call-user-method.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: darvina Status: ready --> <refentry id="function.call-user-method"> <refnamediv> <refname>call_user_method</refname> @@ -12,7 +12,7 @@ <methodsynopsis> <type>mixed</type><methodname>call_user_method</methodname> <methodparam><type>string</type><parameter>nome_metodo</parameter></methodparam> - <methodparam><type>object</type><parameter>&oggetto</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>parametro</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/chdir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dir/functions/chdir.xml diff -u phpdoc-it/reference/dir/functions/chdir.xml:1.5 phpdoc-it/reference/dir/functions/chdir.xml:1.6 --- phpdoc-it/reference/dir/functions/chdir.xml:1.5 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/chdir.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.10 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <refentry id="function.chdir"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>cambia directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>chdir</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> @@ -34,9 +35,7 @@ ?> ]]> </programlisting> - <para> - Questo esempio visualizzerà: - </para> + &example.outputs; <screen> <![CDATA[ /home/vincent http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/chroot.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/chroot.xml diff -u phpdoc-it/reference/dir/functions/chroot.xml:1.4 phpdoc-it/reference/dir/functions/chroot.xml:1.5 --- phpdoc-it/reference/dir/functions/chroot.xml:1.4 Fri May 28 16:20:36 2004 +++ phpdoc-it/reference/dir/functions/chroot.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.7 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.8 --> <refentry id="function.chroot"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Cambia la direcory di root</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>chroot</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/class.dir.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/class.dir.xml diff -u phpdoc-it/reference/dir/functions/class.dir.xml:1.4 phpdoc-it/reference/dir/functions/class.dir.xml:1.5 --- phpdoc-it/reference/dir/functions/class.dir.xml:1.4 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/class.dir.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <refentry id="class.dir"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Classe directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/closedir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/closedir.xml diff -u phpdoc-it/reference/dir/functions/closedir.xml:1.3 phpdoc-it/reference/dir/functions/closedir.xml:1.4 --- phpdoc-it/reference/dir/functions/closedir.xml:1.3 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/closedir.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <!-- last change to 'closedir' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: cortesi Status: ready --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.closedir"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Chiude l'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>closedir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/getcwd.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/getcwd.xml diff -u phpdoc-it/reference/dir/functions/getcwd.xml:1.4 phpdoc-it/reference/dir/functions/getcwd.xml:1.5 --- phpdoc-it/reference/dir/functions/getcwd.xml:1.4 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/getcwd.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.3 --> <refentry id="function.getcwd"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Restituisce la directory di lavoro in uso</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>getcwd</methodname> <void/> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/opendir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/opendir.xml diff -u phpdoc-it/reference/dir/functions/opendir.xml:1.3 phpdoc-it/reference/dir/functions/opendir.xml:1.4 --- phpdoc-it/reference/dir/functions/opendir.xml:1.3 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/opendir.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <!-- last change to 'opendir' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.10 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.opendir"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Apre l'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>resource</type><methodname>opendir</methodname> <methodparam><type>string</type><parameter>percorso</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/readdir.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/readdir.xml diff -u phpdoc-it/reference/dir/functions/readdir.xml:1.4 phpdoc-it/reference/dir/functions/readdir.xml:1.5 --- phpdoc-it/reference/dir/functions/readdir.xml:1.4 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/readdir.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <refentry id="function.readdir"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Legge una voce dall'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>readdir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/rewinddir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/rewinddir.xml diff -u phpdoc-it/reference/dir/functions/rewinddir.xml:1.3 phpdoc-it/reference/dir/functions/rewinddir.xml:1.4 --- phpdoc-it/reference/dir/functions/rewinddir.xml:1.3 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/rewinddir.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <!-- last change to 'rewinddir' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.rewinddir"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Riavvolge l'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>rewinddir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/escapeshellarg.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/escapeshellarg.xml diff -u phpdoc-it/reference/exec/functions/escapeshellarg.xml:1.2 phpdoc-it/reference/exec/functions/escapeshellarg.xml:1.3 --- phpdoc-it/reference/exec/functions/escapeshellarg.xml:1.2 Wed Apr 17 03:06:17 2002 +++ phpdoc-it/reference/exec/functions/escapeshellarg.xml Thu Feb 3 08:18:14 2005 @@ -1,15 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'escapeshellarg' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.8 --> <refentry id="function.escapeshellarg"> <refnamediv> <refname>escapeshellarg</refname> - <refpurpose>Estrae una stringa da usare come un argomento della shell</refpurpose> + <refpurpose>estrae una stringa da usare come un argomento della shell</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>escapeshellarg</methodname> <methodparam><type>string</type><parameter>arg</parameter></methodparam> @@ -28,14 +29,15 @@ <informalexample> <programlisting role="php"> <![CDATA[ -system("ls ".escapeshellarg($dir)); +<?php +system('ls '.escapeshellarg($dir)); ]]> </programlisting> </informalexample> </para> <para> - Vedere anche <function>exec</function>, <function>popen</function>, - <function>system</function> e <link + Vedere anche <function>escapeshellcmd</function>, <function>exec</function>, + <function>popen</function>, <function>system</function> e <link linkend="language.operators.execution">l'operatore backtick</link>. </para> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/escapeshellcmd.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/escapeshellcmd.xml diff -u phpdoc-it/reference/exec/functions/escapeshellcmd.xml:1.2 phpdoc-it/reference/exec/functions/escapeshellcmd.xml:1.3 --- phpdoc-it/reference/exec/functions/escapeshellcmd.xml:1.2 Wed Apr 17 03:06:18 2002 +++ phpdoc-it/reference/exec/functions/escapeshellcmd.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'escapeshellcmd' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.5 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.2 --> <refentry id="function.escapeshellcmd"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Elude i metacaratteri della shell</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>escapeshellcmd</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> @@ -27,10 +28,15 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $e = escapeshellcmd($userinput); -system("echo $e"); // qui non ci preoccupiamo se $e contiene spazi + +// qui non ci preoccupiamo se $e contiene spazi +system("echo $e"); $f = escapeshellcmd($filename); -system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // e qui invece lo facciamo, usando le virgolette +// e qui lo facciamo, usando le virgolette +system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); +?> ]]> </programlisting> </informalexample> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/exec.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/exec/functions/exec.xml diff -u phpdoc-it/reference/exec/functions/exec.xml:1.3 phpdoc-it/reference/exec/functions/exec.xml:1.4 --- phpdoc-it/reference/exec/functions/exec.xml:1.3 Thu Jul 25 21:29:16 2002 +++ phpdoc-it/reference/exec/functions/exec.xml Thu Feb 3 08:18:14 2005 @@ -1,18 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.15 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <refentry id="function.exec"> <refnamediv> <refname>exec</refname> <refpurpose>Esegue un programma esterno</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>exec</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>array - </parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter role="reference">output</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">return_var</parameter></methodparam> + </methodsynopsis> <para> <function>exec</function> esegue il comando passato da @@ -22,9 +23,10 @@ direttamente indietro senza alcuna interferenza, usare la funzione <function>passthru</function>. </para> <para> - Se l'argomento <parameter>array</parameter> è presente, allora tale vettore specificato + Se l'argomento <parameter>output</parameter> è presente, allora tale vettore specificato verrà riempito con ogni linea del output del comando. - Notare che se il vettore contiene già degli elementi, + I fine riga, come <literal>\n</literal>non sono inclusi + in questo array. Notare che se il vettore contiene già degli elementi, <function>exec</function> li aggiungerà in coda al vettore. Se non si vuole che la funzione aggiunga elementi, eseguire un <function>unset</function> sul vettore prima di passarlo ad @@ -32,30 +34,32 @@ </para> <para> Se viene passato l'argomento <parameter>return_var</parameter> - assieme all'argomento <parameter>array</parameter>, allora lo stato + assieme all'argomento <parameter>output</parameter>, allora lo stato del comando eseguito verrà scritto in questa variabile. </para> - <warning> <para> - Si osservi che se si intende allocare dati che giungono dall'utente - per passarli a questa funzione, si dovrebbe usare - <function>escapeshellarg</function> o - <function>escapeshellcmd</function> per assicurarsi che l'utente - non forzi il sistema ad eseguire comandi arbitrari. - </para> - </warning> - <note> - <para> - Notare anche che se si esegue un programma usando questa funzione e lo si vuole lasciare - in esecuzione in background, ci si deve assicurare che l'output del programa venga rediretto - ad un file o a qualche altro flusso di output, altrimenti PHP rimarrà bloccato in attesa fino alla - fine dell'esecuzione del programma. - </para> - </note> + <example> + <title>Un <function>exec</function> example</title> + <programlisting role="php"> + <![CDATA[ + <?php + // restituisce la username del proprietario del processo php/httpd attivo + // (su um sistema con l'eseguibile "whoami" nel path) + echo exec('whoami'); + ?> + ]]> + </programlisting> + </example> + </para> + &warn.escapeshell; + ¬e.exec-bg; + ¬e.exec-path; + &warn.sm.exec; <para> Vedere anche <function>system</function>, <function>passthru</function>, <function>popen</function>, - <function>escapeshellcmd</function> e <link + <function>escapeshellcmd</function> + <function>pcntl_exec</function> e <link linkend="language.operators.execution">l'operatore backtick</link>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/passthru.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/passthru.xml diff -u phpdoc-it/reference/exec/functions/passthru.xml:1.2 phpdoc-it/reference/exec/functions/passthru.xml:1.3 --- phpdoc-it/reference/exec/functions/passthru.xml:1.2 Wed Apr 17 03:06:18 2002 +++ phpdoc-it/reference/exec/functions/passthru.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'passthru' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.2 --> <refentry id="function.passthru"> <refnamediv> @@ -9,11 +10,11 @@ <refpurpose>Esegue un programma esterno e mostra l'output non elaborato</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>passthru</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">return_var</parameter></methodparam> </methodsynopsis> <para> La funzione <function>passthru</function> è simile alla funzione @@ -29,23 +30,10 @@ chiamando un programma pbmplus per generare una gif puoi realizzare uno script PHP che genera direttamente immagini. </para> - <warning> - <para> - Se si intende permettere ai dati provenienti dall'input dell'utente di essere passati - a questa funzione, allora si dovrebbe usare - <function>escapeshellarg</function> o - <function>escapeshellcmd</function>, questo al fine di assicurarsi che gli utenti non possano - maliziosamente indurrethe il sistema ad eseguire comandi arbitrari. - </para> - </warning> - <note> - <para> - Nota che se avvii un programma usando questa funzione e intendi lasciarlo - girare in background, devi accertarti che l'output del programma sia rediretto - in un file o a qualche altro flusso di output o PHP attenderà fino alla - fine dell'esecuzione del programma. - </para> - </note> + &warn.escapeshell; + ¬e.exec-bg; + ¬e.exec-path; + &warn.sm.exec; <para> Vedere anche <function>exec</function>, <function>system</function>, <function>popen</function>, <function>escapeshellcmd</function>, http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/shell-exec.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/shell-exec.xml diff -u phpdoc-it/reference/exec/functions/shell-exec.xml:1.2 phpdoc-it/reference/exec/functions/shell-exec.xml:1.3 --- phpdoc-it/reference/exec/functions/shell-exec.xml:1.2 Wed Apr 17 03:06:19 2002 +++ phpdoc-it/reference/exec/functions/shell-exec.xml Thu Feb 3 08:18:14 2005 @@ -1,15 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'shell-exec' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.6 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.2 --> <refentry id='function.shell-exec'> <refnamediv> <refname>shell_exec</refname> - <refpurpose>Esegue un comando attraverso la shell e restituisce l'output come stringa</refpurpose> + <refpurpose>Esegue un comando attraverso la shell e restituisce l'output completo come stringa + </refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>shell_exec</methodname> <methodparam><type>string</type><parameter>cmd</parameter></methodparam> @@ -18,6 +20,26 @@ Questa funzione è identica all'<link linkend="language.operators.execution">operatore backtick</link>. </para> + <para> + <example> + <title>Un <function>shell_exec</function> esempio</title> + <programlisting role="php"> + <![CDATA[ + <?php + $output = shell_exec('ls -lart'); + echo "<pre>$output</pre>"; + ?> + ]]> + </programlisting> + </example> + </para> + + ¬e.sm.disabled; + + <para> + Vedere anche <function>exec</function> e + <function>escapeshellcmd</function>. + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/system.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/system.xml diff -u phpdoc-it/reference/exec/functions/system.xml:1.2 phpdoc-it/reference/exec/functions/system.xml:1.3 --- phpdoc-it/reference/exec/functions/system.xml:1.2 Wed Apr 17 03:06:19 2002 +++ phpdoc-it/reference/exec/functions/system.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'system' in en/ tree in rev 1.24 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.12 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.24 --> <refentry id="function.system"> <refnamediv> @@ -9,11 +10,11 @@ <refpurpose>Esegue un programma esterno e mostra l'output</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>system</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">return_var</parameter></methodparam> </methodsynopsis> <para> <function>system</function> è semplicemente come la versione C @@ -23,23 +24,8 @@ ritornato dal comando eseguito verrà scritto in tale variabile. </para> - <warning> - <para> - Nota che se intendi permettere che i dati in ingresso dall'utente - vengano passati a questa funzione, dovresti utilizzare la funzione - <function>escapeshellarg</function> o - <function>escapeshellcmd</function> per assicurarti che l'utente non possa - forzare il sistema ad eseguire comandi arbitrari. - </para> - </warning> - <note> - <para> - Nota che se avvii un programma usando questa funzione e intendi lasciarlo - girare in background, devi accertarti che l'output del programma sia rediretto - in un file o a qualche altro flusso di output o PHP attenderà fino alla - fine dell'esecuzione del programma. - </para> - </note> + &warn.escapeshell; + ¬e.exec-bg; <para> La chiamata a <function>system</function> tenta anche di ripulire automaticamente il buffer di output del web server dopo ogni linea di output se PHP @@ -55,9 +41,35 @@ <function>passthru</function>. </para> <para> + <example> + <title><function>system</function> example</title> + <programlisting role="php"> + <![CDATA[ + <?php + echo '<pre>'; + + // Mette in output tutti i risultati della shellcommand "ls", e restituisce + // l'ultima linea di output nella $last_line. Memorizza il valore restituito + // del comando da shell in $retval. + $last_line = system('ls', $retval); + + // Stampa informazioni aggiuntive + echo ' + </pre> + <hr />L'ultima linea dell'output: ' . $last_line . ' + <hr />Restituisce il valore: ' . $retval; + ?> + ]]> + </programlisting> + </example> + </para> + ¬e.exec-path; + &warn.sm.exec; + <para> Vedere anche <function>exec</function>, <function>passthru</function>, <function>popen</function>, - <function>escapeshellcmd</function> e <link + <function>escapeshellcmd</function>, + <function>pcntl_exec</function>, e <link linkend="language.operators.execution">l'operatore backtick</link>. </para> </refsect1>
http://cvs.php.net/diff.php/phpdoc-it/features/commandline.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/features/commandline.xml diff -u phpdoc-it/features/commandline.xml:1.3 phpdoc-it/features/commandline.xml:1.4 --- phpdoc-it/features/commandline.xml:1.3 Thu Sep 2 08:15:42 2004 +++ phpdoc-it/features/commandline.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.36 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.38 Maintainer: darvina Status: ready --> <chapter id="features.commandline"> <title>Utilizzo di PHP da linea di comando</title> <!-- NEW DOCUMENTATION STARTS --> @@ -839,8 +839,8 @@ ]]> </screen> Se si utilizzano shell differenti rispetto a sh/bash, si potrebbe incorrere - in altri problemi. In tal caso aprite una segnalazione di errore o inviate una - mail a phpdoc@lists.php.net. + in altri problemi. In tal caso aprite una segnalazione di errore a <ulink url="&url.php.bugs;">&url.php.bugs;</ulink> + o inviate una mail a &email.php.doc;. Tuttavia si può facilmente incorrere in problemi nell'avere variabili di shell nel codice o nell'utilizzare le barre rovesciate (backslash) per l'escape. http://cvs.php.net/diff.php/phpdoc-it/features/connection-handling.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/features/connection-handling.xml diff -u phpdoc-it/features/connection-handling.xml:1.4 phpdoc-it/features/connection-handling.xml:1.5 --- phpdoc-it/features/connection-handling.xml:1.4 Thu Sep 2 08:15:42 2004 +++ phpdoc-it/features/connection-handling.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.15 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.17 Maintainer: darvina Status: ready --> <chapter id="features.connection-handling"> <title>Gestione della connessione</title> @@ -54,9 +54,9 @@ lo script viene interrotto, se è stata prevista una funzione di shutdown, questa verrà eseguita. All'interno di questa funzione si può discriminare se è stata attivata per lo scadere del timeout utilizzando la - funzione <function>connection_timeout</function>. Questa restituisce - &true; se la funzione di shutdown è stata chiamata per lo scadere del tempo a disposizione.</simpara> - + funzione <function>connection_timeout</function>. Questa restituisce 2 + se la funzione di shutdown è stata chiamata per lo scadere del tempo a disposizione. + </simpara> <simpara> Un aspetto che occorre notare sui stati ABORTED e TIMEOUT è che possono essere attivi contemporaneamente. Questo può accadere @@ -64,12 +64,9 @@ continua a tenere traccia della disconnessione dell'utente, ma, semplicemente, non viene interrotto lo script. Quindi, quando termina il tempo, lo script sarà interrotto e verrà richiamata la funzione di shutdown, se presente. In questa situazione - sia <function>connection_timeout</function> sia - <function>connection_aborted</function> restituiranno &true;. - Si può anche verificare entrambi gli stati tramite una chiamata singola - utilizzando la funzione <function>connection_status</function>. Questa restituisce - un campo di bit con l'indicazione degli stati attivi. Quindi, ad esempio, se entrambi gli - stati sono attivi, la funzione restituirà 3.</simpara> + si avrà che <function>connection_status</function> + restituirà 3. + </simpara> </chapter> http://cvs.php.net/diff.php/phpdoc-it/features/cookies.xml?r1=1.9&r2=1.10&ty=u Index: phpdoc-it/features/cookies.xml diff -u phpdoc-it/features/cookies.xml:1.9 phpdoc-it/features/cookies.xml:1.10 --- phpdoc-it/features/cookies.xml:1.9 Fri Jul 11 15:54:41 2003 +++ phpdoc-it/features/cookies.xml Thu Feb 3 08:18:14 2005 @@ -1,15 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.15 Maintainer: perugini Status: ready --> +<!-- EN-Revision: 1.20 Maintainer: perugini Status: ready --> <!-- CREDITS: latoserver --> <chapter id="features.cookies"> <title>Cookies</title> <para> - PHP supporta in modo trasparente i cookies HTTP. I cookies sono un meccanismo + PHP supporta in modo trasparente i cookies <acronym>HTTP</acronym>. I cookies sono un meccanismo per memorizzare dati nel browser remoto e tenere traccia degli utenti - o identificarli al loro ritorno. I cookies possono essere impostati tramite la - funzione <function>setcookie</function>. I cookies sono parte dell'intestazione - HTTP, quindi <function>setcookie</function> deve essere chiamata prima + o identificarli al loro ritorno. I cookies possono essere impostati tramite le + funzioni <function>setcookie</function> oppure <function>setrawcookie</function>. + I cookies sono parte dell'intestazione + <acronym>HTTP</acronym>, quindi <function>setcookie</function> deve essere chiamata prima che qualsiasi output sia inviato al browser. Si tratta della stessa limitazione della funzione <function>header</function>. Si può utilizzare la <link linkend="ref.outcontrol">funzione di buffer dell'output</link> per @@ -19,9 +20,10 @@ <para> Ogni cookie inviato dal client sarà automaticamente trasformato - in una variabile PHP, come avviene nel caso di dati GET o POST, in base - alle variabili di configurazione <literal>register_globals</literal> e - <literal>variables_order</literal>. Se si vogliono assegnare più + in una variabile PHP, come avviene nel caso di dati <literal>GET</literal> o <literal>POST</literal>, in base + alle variabili di configurazione <link linkend="ini.register-globals">register_globals</link> e + <link linkend="ini.variables-order">variables_order</link>. + Se si vogliono assegnare più valori ad un singolo cookie, basta aggiungere <literal>[]</literal> al nome del cookie. </para> @@ -30,13 +32,14 @@ sarà sempre impostato con qualsiasi cookies inviati dal client. <varname>$HTTP_COOKIE_VARS</varname> è anch'essa impostata nelle versioni precedenti del PHP se è impostata la variabile di - configurazione <literal>track_vars</literal>. (Questo parametro è sempre a on + configurazione <link linkend="ini.track-vars">track_vars</link>. (Questo parametro è sempre a on a partire da PHP 4.0.3.) </para> <para> Per maggiori dettagli - si veda la funzione <function>setcookie</function>. + si vedano le funzioni <function>setcookie</function> e + <function>setrawcookie</function>. </para> </chapter> http://cvs.php.net/diff.php/phpdoc-it/features/http-auth.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc-it/features/http-auth.xml diff -u phpdoc-it/features/http-auth.xml:1.14 phpdoc-it/features/http-auth.xml:1.15 --- phpdoc-it/features/http-auth.xml:1.14 Mon Aug 2 08:02:22 2004 +++ phpdoc-it/features/http-auth.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.40 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.41 Maintainer: cortesi Status: ready --> <!-- CREDITS: matteobug --> <chapter id="features.http-auth"> <title>Autenticazione HTTP usando PHP</title> @@ -166,7 +166,7 @@ </simpara> <simpara> - Un'altra limitazione è che se si usa il modulo IIS (ISAPI) non si possono + Un'altra limitazione è che se si usa il modulo IIS (ISAPI) e PHP 4, non si possono usare le variabili <literal>PHP_AUTH_*</literal> ma, al contrario, la variabile <literal>HTTP_AUTHORIZATION</literal> è disponibile. Per esempio, si consideri il seguente codice: <literal>list($user, $pw) = explode(':', http://cvs.php.net/diff.php/phpdoc-it/features/persistent-connections.xml?r1=1.12&r2=1.13&ty=u Index: phpdoc-it/features/persistent-connections.xml diff -u phpdoc-it/features/persistent-connections.xml:1.12 phpdoc-it/features/persistent-connections.xml:1.13 --- phpdoc-it/features/persistent-connections.xml:1.12 Sat May 31 07:24:36 2003 +++ phpdoc-it/features/persistent-connections.xml Thu Feb 3 08:18:14 2005 @@ -1,10 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.21 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.24 Maintainer: darvina Status: ready --> +<!-- CREDITS: cortesi --> <chapter id="features.persistent-connections"> <title>Connessioni Persistenti ai Database</title> <simpara> - Connessioni persistenti sono collegamenti SQL che non vengono chiusi quando + Connessioni persistenti sono collegamenti che non vengono chiusi quando l'esecusione di uno script viene terminata. Quando è richiesta una connessione persistente, PHP controlla se esiste già una identica connessione persistente (che è rimasta aperta da prima) - e se esiste, la @@ -12,17 +13,11 @@ è una connessione aperta verso lo stesso host, con lo stesso username e la stessa password (dove applicabile). </simpara> - <note> - <para> - Ci sono altre estensioni che permettono di usare connessioni persistenti, ad - esempio l'<link linkend="ref.imap">estensione IMAP</link>. - </para> - </note> <simpara> Chi non ha molta familiarità con il modo in cui lavorano i server web e di come essi distribuiscano il carico potrebbero confondere le connessioni permanenti per ciò che esse non sono. In particolare, <emphasis>non</emphasis> danno - la possibilità di aprire 'sessioni utente' sullo stesso collegamento SQL, + la possibilità di aprire 'sessioni utente' sullo stesso collegamento, <emphasis>non</emphasis> danno la possibilità di gestire una transazione in maniera efficiente e sopratutto non fanno molte altre cose. Infatti, per essere molto chiari su questo punto, @@ -56,14 +51,9 @@ client, questa è passata ad uno dei figli che in quel momento non è già occupato a servire un altro client. Questo significa che quando lo stesso client effettua una seconda richiesta al server, esso potrà essere servito da un diverso processo - figlio rispetto a quello della prima volta. In questa situazione, usare una - connessione persistente, permette di stabilire una e una sola connessione - al database SQL per ogni processo figlio, poiché ciascun - processo figlio necessita di collegarsi al database SQL solo la - prima volta che richiama una pagina che ne fa uso. Quando viene richamata - un'altra pagina che necessita di una connessione al server SQL, essa può - riutilizzare la connessione che lo stesso processo figlio aveva - stabilito in precedenza. + figlio rispetto a quello della prima volta. Quando si aprono delle connessioni persistenti, + ciascuna pagina successiva che richiede dei servizi SQL, può riutilizzare la + connessione al server SQL precedente. </simpara> <simpara> L'ultimo metodo è quello di usare il PHP come una plug-in per un server web @@ -137,7 +127,7 @@ <para> Vedere anche <function>fbsql_pconnect</function>, <function>ibase_pconnect</function>, <function>ifx_pconnect</function>, - <function>imap_popen</function>, <function>ingres_pconnect</function>, + <function>ingres_pconnect</function>, <function>msql_pconnect</function>, <function>mssql_pconnect</function>, <function>mysql_pconnect</function>, <function>ocipLogon</function>, <function>odbc_pconnect</function>, <function>ora_pLogon</function>, http://cvs.php.net/diff.php/phpdoc-it/features/remote-files.xml?r1=1.13&r2=1.14&ty=u Index: phpdoc-it/features/remote-files.xml diff -u phpdoc-it/features/remote-files.xml:1.13 phpdoc-it/features/remote-files.xml:1.14 --- phpdoc-it/features/remote-files.xml:1.13 Sat May 31 07:24:57 2003 +++ phpdoc-it/features/remote-files.xml Thu Feb 3 08:18:14 2005 @@ -1,17 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.22 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.26 Maintainer: cortesi Status: ready --> <!-- CREDITS: marco --> <chapter id="features.remote-files"> <title>Utilizzo di file remoti</title> <para> Se <parameter>allow_url_fopen</parameter> è abilitato in - &php.ini;, si possono usare URL FTP e HTTP con la maggior parte delle funzioni che + &php.ini;, si possono usare gli URL <acronym>HTTP</acronym> e <acronym>FTP</acronym> + con la maggior parte delle funzioni che richiedono nomi di file come parametri, incluse le funzioni <function>require</function>, <function>require_once</function>, <function>include</function> e <function>include_once</function>. Vedere <xref linkend="wrappers"/> per maggiori dettagli sui protocolli supportati dal - &php;. + PHP. </para> <note> <para> @@ -23,7 +24,7 @@ <para> <note> <para> - Al momento, le versioni Windows di <literal>PHP</literal> precedenti la 4.3, non supportano + Al momento, le versioni Windows di PHP precedenti la 4.3, non supportano l'accesso remoto ai file con le seguenti funzioni: <function>include</function>, <function>include_once</function>, <function>require</function> e <function>require_once</function> @@ -89,7 +90,7 @@ exit; } /* Scrive i dati qui. */ -fputs ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); +fwrite ($file, $_SERVER['HTTP_USER_AGENT'] . "\n"); fclose ($file); ?> ]]> http://cvs.php.net/diff.php/phpdoc-it/language-defs.ent?r1=1.17&r2=1.18&ty=u Index: phpdoc-it/language-defs.ent diff -u phpdoc-it/language-defs.ent:1.17 phpdoc-it/language-defs.ent:1.18 --- phpdoc-it/language-defs.ent:1.17 Tue Jan 25 08:26:24 2005 +++ phpdoc-it/language-defs.ent Thu Feb 3 08:18:14 2005 @@ -1,4 +1,4 @@ -<!-- EN-Revision: 1.23 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.24 Maintainer: darvina Status: ready --> <!-- CREDITS: perugini --> <!-- Part titles used mostly in manual.xml itself --> @@ -51,3 +51,4 @@ <!ENTITY reftitle.runtime '<title>Configurazione di Runtime</title>'> <!ENTITY reftitle.returnvalues '<title>Valori restituiti</title>'> <!ENTITY reftitle.seealso '<title>Vedere anche:</title>'> +<!ENTITY reftitle.notes '<title>Note</title>'> http://cvs.php.net/diff.php/phpdoc-it/language-snippets.ent?r1=1.41&r2=1.42&ty=u Index: phpdoc-it/language-snippets.ent diff -u phpdoc-it/language-snippets.ent:1.41 phpdoc-it/language-snippets.ent:1.42 --- phpdoc-it/language-snippets.ent:1.41 Tue Jan 25 08:26:24 2005 +++ phpdoc-it/language-snippets.ent Thu Feb 3 08:18:14 2005 @@ -1,4 +1,4 @@ -<!-- EN-Revision: 1.132 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.134 Maintainer: darvina Status: ready --> <!-- CREDITS: perugini --> <!-- Notes --> @@ -238,6 +238,9 @@ la directory nella quale si sta lavorando, abbia lo stesso UID dello script che è in esecuzione.</simpara></note>'> +<!ENTITY note.open-basedir.func '<note><para><link +linkend="ini.open-basedir">open_basedir</link> influisce su questa funzione.</para></note>'> + <!ENTITY note.language-construct '<note><simpara>Poichè questo è un costrutto del linguaggio e non una funzione, non può essere chiamato con le <link linkend="functions.variable-functions">variabili funzione</link></simpara> http://cvs.php.net/diff.php/phpdoc-it/reference/classobj/functions/call-user-method-array.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/classobj/functions/call-user-method-array.xml diff -u phpdoc-it/reference/classobj/functions/call-user-method-array.xml:1.5 phpdoc-it/reference/classobj/functions/call-user-method-array.xml:1.6 --- phpdoc-it/reference/classobj/functions/call-user-method-array.xml:1.5 Thu Sep 16 08:20:23 2004 +++ phpdoc-it/reference/classobj/functions/call-user-method-array.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/classobj.xml, last change in rev 1.12 --> <!-- last change to 'call-user-method-array' in en/ tree in rev 1.36 --> -<!-- EN-Revision: 1.6 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: darvina Status: ready --> <!-- OLD-Revision: 1.38/EN.1.36 --> <refentry id="function.call-user-method-array"> <refnamediv> @@ -15,7 +15,7 @@ <methodsynopsis> <type>mixed</type><methodname>call_user_method_array</methodname> <methodparam><type>string</type><parameter>nome_metodo</parameter></methodparam> - <methodparam><type>object</type><parameter>&obj</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> <methodparam><type>array</type><parameter>paramarr</parameter></methodparam> </methodsynopsis> <warning> http://cvs.php.net/diff.php/phpdoc-it/reference/classobj/functions/call-user-method.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc-it/reference/classobj/functions/call-user-method.xml diff -u phpdoc-it/reference/classobj/functions/call-user-method.xml:1.7 phpdoc-it/reference/classobj/functions/call-user-method.xml:1.8 --- phpdoc-it/reference/classobj/functions/call-user-method.xml:1.7 Mon Aug 9 08:01:46 2004 +++ phpdoc-it/reference/classobj/functions/call-user-method.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.9 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: darvina Status: ready --> <refentry id="function.call-user-method"> <refnamediv> <refname>call_user_method</refname> @@ -12,7 +12,7 @@ <methodsynopsis> <type>mixed</type><methodname>call_user_method</methodname> <methodparam><type>string</type><parameter>nome_metodo</parameter></methodparam> - <methodparam><type>object</type><parameter>&oggetto</parameter></methodparam> + <methodparam><type>object</type><parameter role="reference">obj</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>parametro</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/chdir.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/dir/functions/chdir.xml diff -u phpdoc-it/reference/dir/functions/chdir.xml:1.5 phpdoc-it/reference/dir/functions/chdir.xml:1.6 --- phpdoc-it/reference/dir/functions/chdir.xml:1.5 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/chdir.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.10 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <refentry id="function.chdir"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>cambia directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>chdir</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> @@ -34,9 +35,7 @@ ?> ]]> </programlisting> - <para> - Questo esempio visualizzerà: - </para> + &example.outputs; <screen> <![CDATA[ /home/vincent http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/chroot.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/chroot.xml diff -u phpdoc-it/reference/dir/functions/chroot.xml:1.4 phpdoc-it/reference/dir/functions/chroot.xml:1.5 --- phpdoc-it/reference/dir/functions/chroot.xml:1.4 Fri May 28 16:20:36 2004 +++ phpdoc-it/reference/dir/functions/chroot.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.7 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.8 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.8 --> <refentry id="function.chroot"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Cambia la direcory di root</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>chroot</methodname> <methodparam><type>string</type><parameter>directory</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/class.dir.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/class.dir.xml diff -u phpdoc-it/reference/dir/functions/class.dir.xml:1.4 phpdoc-it/reference/dir/functions/class.dir.xml:1.5 --- phpdoc-it/reference/dir/functions/class.dir.xml:1.4 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/class.dir.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <refentry id="class.dir"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Classe directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <classsynopsis> <ooclass><classname>dir</classname></ooclass> <constructorsynopsis> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/closedir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/closedir.xml diff -u phpdoc-it/reference/dir/functions/closedir.xml:1.3 phpdoc-it/reference/dir/functions/closedir.xml:1.4 --- phpdoc-it/reference/dir/functions/closedir.xml:1.3 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/closedir.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <!-- last change to 'closedir' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: cortesi Status: ready --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.closedir"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Chiude l'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>closedir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/getcwd.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/getcwd.xml diff -u phpdoc-it/reference/dir/functions/getcwd.xml:1.4 phpdoc-it/reference/dir/functions/getcwd.xml:1.5 --- phpdoc-it/reference/dir/functions/getcwd.xml:1.4 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/getcwd.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.9 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.3 --> <refentry id="function.getcwd"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Restituisce la directory di lavoro in uso</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>getcwd</methodname> <void/> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/opendir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/opendir.xml diff -u phpdoc-it/reference/dir/functions/opendir.xml:1.3 phpdoc-it/reference/dir/functions/opendir.xml:1.4 --- phpdoc-it/reference/dir/functions/opendir.xml:1.3 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/opendir.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <!-- last change to 'opendir' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.10 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.11 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.opendir"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Apre l'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>resource</type><methodname>opendir</methodname> <methodparam><type>string</type><parameter>percorso</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/readdir.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-it/reference/dir/functions/readdir.xml diff -u phpdoc-it/reference/dir/functions/readdir.xml:1.4 phpdoc-it/reference/dir/functions/readdir.xml:1.5 --- phpdoc-it/reference/dir/functions/readdir.xml:1.4 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/readdir.xml Thu Feb 3 08:18:14 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <refentry id="function.readdir"> <refnamediv> @@ -7,7 +8,7 @@ <refpurpose>Legge una voce dall'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>readdir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/dir/functions/rewinddir.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/dir/functions/rewinddir.xml diff -u phpdoc-it/reference/dir/functions/rewinddir.xml:1.3 phpdoc-it/reference/dir/functions/rewinddir.xml:1.4 --- phpdoc-it/reference/dir/functions/rewinddir.xml:1.3 Thu Sep 2 08:17:32 2004 +++ phpdoc-it/reference/dir/functions/rewinddir.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/dir.xml, last change in rev 1.1 --> <!-- last change to 'rewinddir' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.38/EN.1.2 --> <refentry id="function.rewinddir"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Riavvolge l'handle della directory</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>rewinddir</methodname> <methodparam><type>resource</type><parameter>dir_handle</parameter></methodparam> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/escapeshellarg.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/escapeshellarg.xml diff -u phpdoc-it/reference/exec/functions/escapeshellarg.xml:1.2 phpdoc-it/reference/exec/functions/escapeshellarg.xml:1.3 --- phpdoc-it/reference/exec/functions/escapeshellarg.xml:1.2 Wed Apr 17 03:06:17 2002 +++ phpdoc-it/reference/exec/functions/escapeshellarg.xml Thu Feb 3 08:18:14 2005 @@ -1,15 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'escapeshellarg' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.8 --> <refentry id="function.escapeshellarg"> <refnamediv> <refname>escapeshellarg</refname> - <refpurpose>Estrae una stringa da usare come un argomento della shell</refpurpose> + <refpurpose>estrae una stringa da usare come un argomento della shell</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>escapeshellarg</methodname> <methodparam><type>string</type><parameter>arg</parameter></methodparam> @@ -28,14 +29,15 @@ <informalexample> <programlisting role="php"> <![CDATA[ -system("ls ".escapeshellarg($dir)); +<?php +system('ls '.escapeshellarg($dir)); ]]> </programlisting> </informalexample> </para> <para> - Vedere anche <function>exec</function>, <function>popen</function>, - <function>system</function> e <link + Vedere anche <function>escapeshellcmd</function>, <function>exec</function>, + <function>popen</function>, <function>system</function> e <link linkend="language.operators.execution">l'operatore backtick</link>. </para> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/escapeshellcmd.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/escapeshellcmd.xml diff -u phpdoc-it/reference/exec/functions/escapeshellcmd.xml:1.2 phpdoc-it/reference/exec/functions/escapeshellcmd.xml:1.3 --- phpdoc-it/reference/exec/functions/escapeshellcmd.xml:1.2 Wed Apr 17 03:06:18 2002 +++ phpdoc-it/reference/exec/functions/escapeshellcmd.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'escapeshellcmd' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.5 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.2 --> <refentry id="function.escapeshellcmd"> <refnamediv> @@ -9,7 +10,7 @@ <refpurpose>Elude i metacaratteri della shell</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>escapeshellcmd</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> @@ -27,10 +28,15 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $e = escapeshellcmd($userinput); -system("echo $e"); // qui non ci preoccupiamo se $e contiene spazi + +// qui non ci preoccupiamo se $e contiene spazi +system("echo $e"); $f = escapeshellcmd($filename); -system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // e qui invece lo facciamo, usando le virgolette +// e qui lo facciamo, usando le virgolette +system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); +?> ]]> </programlisting> </informalexample> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/exec.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/exec/functions/exec.xml diff -u phpdoc-it/reference/exec/functions/exec.xml:1.3 phpdoc-it/reference/exec/functions/exec.xml:1.4 --- phpdoc-it/reference/exec/functions/exec.xml:1.3 Thu Jul 25 21:29:16 2002 +++ phpdoc-it/reference/exec/functions/exec.xml Thu Feb 3 08:18:14 2005 @@ -1,18 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.15 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <refentry id="function.exec"> <refnamediv> <refname>exec</refname> <refpurpose>Esegue un programma esterno</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>exec</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>array - </parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter role="reference">output</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">return_var</parameter></methodparam> + </methodsynopsis> <para> <function>exec</function> esegue il comando passato da @@ -22,9 +23,10 @@ direttamente indietro senza alcuna interferenza, usare la funzione <function>passthru</function>. </para> <para> - Se l'argomento <parameter>array</parameter> è presente, allora tale vettore specificato + Se l'argomento <parameter>output</parameter> è presente, allora tale vettore specificato verrà riempito con ogni linea del output del comando. - Notare che se il vettore contiene già degli elementi, + I fine riga, come <literal>\n</literal>non sono inclusi + in questo array. Notare che se il vettore contiene già degli elementi, <function>exec</function> li aggiungerà in coda al vettore. Se non si vuole che la funzione aggiunga elementi, eseguire un <function>unset</function> sul vettore prima di passarlo ad @@ -32,30 +34,32 @@ </para> <para> Se viene passato l'argomento <parameter>return_var</parameter> - assieme all'argomento <parameter>array</parameter>, allora lo stato + assieme all'argomento <parameter>output</parameter>, allora lo stato del comando eseguito verrà scritto in questa variabile. </para> - <warning> <para> - Si osservi che se si intende allocare dati che giungono dall'utente - per passarli a questa funzione, si dovrebbe usare - <function>escapeshellarg</function> o - <function>escapeshellcmd</function> per assicurarsi che l'utente - non forzi il sistema ad eseguire comandi arbitrari. - </para> - </warning> - <note> - <para> - Notare anche che se si esegue un programma usando questa funzione e lo si vuole lasciare - in esecuzione in background, ci si deve assicurare che l'output del programa venga rediretto - ad un file o a qualche altro flusso di output, altrimenti PHP rimarrà bloccato in attesa fino alla - fine dell'esecuzione del programma. - </para> - </note> + <example> + <title>Un <function>exec</function> example</title> + <programlisting role="php"> + <![CDATA[ + <?php + // restituisce la username del proprietario del processo php/httpd attivo + // (su um sistema con l'eseguibile "whoami" nel path) + echo exec('whoami'); + ?> + ]]> + </programlisting> + </example> + </para> + &warn.escapeshell; + ¬e.exec-bg; + ¬e.exec-path; + &warn.sm.exec; <para> Vedere anche <function>system</function>, <function>passthru</function>, <function>popen</function>, - <function>escapeshellcmd</function> e <link + <function>escapeshellcmd</function> + <function>pcntl_exec</function> e <link linkend="language.operators.execution">l'operatore backtick</link>. </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/passthru.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/passthru.xml diff -u phpdoc-it/reference/exec/functions/passthru.xml:1.2 phpdoc-it/reference/exec/functions/passthru.xml:1.3 --- phpdoc-it/reference/exec/functions/passthru.xml:1.2 Wed Apr 17 03:06:18 2002 +++ phpdoc-it/reference/exec/functions/passthru.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'passthru' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.2 --> <refentry id="function.passthru"> <refnamediv> @@ -9,11 +10,11 @@ <refpurpose>Esegue un programma esterno e mostra l'output non elaborato</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>passthru</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">return_var</parameter></methodparam> </methodsynopsis> <para> La funzione <function>passthru</function> è simile alla funzione @@ -29,23 +30,10 @@ chiamando un programma pbmplus per generare una gif puoi realizzare uno script PHP che genera direttamente immagini. </para> - <warning> - <para> - Se si intende permettere ai dati provenienti dall'input dell'utente di essere passati - a questa funzione, allora si dovrebbe usare - <function>escapeshellarg</function> o - <function>escapeshellcmd</function>, questo al fine di assicurarsi che gli utenti non possano - maliziosamente indurrethe il sistema ad eseguire comandi arbitrari. - </para> - </warning> - <note> - <para> - Nota che se avvii un programma usando questa funzione e intendi lasciarlo - girare in background, devi accertarti che l'output del programma sia rediretto - in un file o a qualche altro flusso di output o PHP attenderà fino alla - fine dell'esecuzione del programma. - </para> - </note> + &warn.escapeshell; + ¬e.exec-bg; + ¬e.exec-path; + &warn.sm.exec; <para> Vedere anche <function>exec</function>, <function>system</function>, <function>popen</function>, <function>escapeshellcmd</function>, http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/shell-exec.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/shell-exec.xml diff -u phpdoc-it/reference/exec/functions/shell-exec.xml:1.2 phpdoc-it/reference/exec/functions/shell-exec.xml:1.3 --- phpdoc-it/reference/exec/functions/shell-exec.xml:1.2 Wed Apr 17 03:06:19 2002 +++ phpdoc-it/reference/exec/functions/shell-exec.xml Thu Feb 3 08:18:14 2005 @@ -1,15 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'shell-exec' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.6 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.2 --> <refentry id='function.shell-exec'> <refnamediv> <refname>shell_exec</refname> - <refpurpose>Esegue un comando attraverso la shell e restituisce l'output come stringa</refpurpose> + <refpurpose>Esegue un comando attraverso la shell e restituisce l'output completo come stringa + </refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>shell_exec</methodname> <methodparam><type>string</type><parameter>cmd</parameter></methodparam> @@ -18,6 +20,26 @@ Questa funzione è identica all'<link linkend="language.operators.execution">operatore backtick</link>. </para> + <para> + <example> + <title>Un <function>shell_exec</function> esempio</title> + <programlisting role="php"> + <![CDATA[ + <?php + $output = shell_exec('ls -lart'); + echo "<pre>$output</pre>"; + ?> + ]]> + </programlisting> + </example> + </para> + + ¬e.sm.disabled; + + <para> + Vedere anche <function>exec</function> e + <function>escapeshellcmd</function>. + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/exec/functions/system.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/exec/functions/system.xml diff -u phpdoc-it/reference/exec/functions/system.xml:1.2 phpdoc-it/reference/exec/functions/system.xml:1.3 --- phpdoc-it/reference/exec/functions/system.xml:1.2 Wed Apr 17 03:06:19 2002 +++ phpdoc-it/reference/exec/functions/system.xml Thu Feb 3 08:18:14 2005 @@ -1,7 +1,8 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/exec.xml, last change in rev 1.12 --> <!-- last change to 'system' in en/ tree in rev 1.24 --> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: working --> +<!-- EN-Revision: 1.12 Maintainer: fernando Status: working --> +<!-- CREDITS: cortesi --> <!-- OLD-Revision: 1.27/EN.1.24 --> <refentry id="function.system"> <refnamediv> @@ -9,11 +10,11 @@ <refpurpose>Esegue un programma esterno e mostra l'output</refpurpose> </refnamediv> <refsect1> - <title>Descrizione</title> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>system</methodname> <methodparam><type>string</type><parameter>command</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter role="reference">return_var</parameter></methodparam> </methodsynopsis> <para> <function>system</function> è semplicemente come la versione C @@ -23,23 +24,8 @@ ritornato dal comando eseguito verrà scritto in tale variabile. </para> - <warning> - <para> - Nota che se intendi permettere che i dati in ingresso dall'utente - vengano passati a questa funzione, dovresti utilizzare la funzione - <function>escapeshellarg</function> o - <function>escapeshellcmd</function> per assicurarti che l'utente non possa - forzare il sistema ad eseguire comandi arbitrari. - </para> - </warning> - <note> - <para> - Nota che se avvii un programma usando questa funzione e intendi lasciarlo - girare in background, devi accertarti che l'output del programma sia rediretto - in un file o a qualche altro flusso di output o PHP attenderà fino alla - fine dell'esecuzione del programma. - </para> - </note> + &warn.escapeshell; + ¬e.exec-bg; <para> La chiamata a <function>system</function> tenta anche di ripulire automaticamente il buffer di output del web server dopo ogni linea di output se PHP @@ -55,9 +41,35 @@ <function>passthru</function>. </para> <para> + <example> + <title><function>system</function> example</title> + <programlisting role="php"> + <![CDATA[ + <?php + echo '<pre>'; + + // Mette in output tutti i risultati della shellcommand "ls", e restituisce + // l'ultima linea di output nella $last_line. Memorizza il valore restituito + // del comando da shell in $retval. + $last_line = system('ls', $retval); + + // Stampa informazioni aggiuntive + echo ' + </pre> + <hr />L'ultima linea dell'output: ' . $last_line . ' + <hr />Restituisce il valore: ' . $retval; + ?> + ]]> + </programlisting> + </example> + </para> + ¬e.exec-path; + &warn.sm.exec; + <para> Vedere anche <function>exec</function>, <function>passthru</function>, <function>popen</function>, - <function>escapeshellcmd</function> e <link + <function>escapeshellcmd</function>, + <function>pcntl_exec</function>, e <link linkend="language.operators.execution">l'operatore backtick</link>. </para> </refsect1>