cortesi Fri Mar 22 13:39:09 2002 EDT
Modified files:
/phpdoc/it/functions ftp.xml
Log:
update up to EN 1.40 by colombo
Index: phpdoc/it/functions/ftp.xml
diff -u phpdoc/it/functions/ftp.xml:1.11 phpdoc/it/functions/ftp.xml:1.12
--- phpdoc/it/functions/ftp.xml:1.11 Sat Feb 2 10:41:55 2002
+++ phpdoc/it/functions/ftp.xml Fri Mar 22 13:39:08 2002
@@ -1,50 +1,62 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.11 Maintainer: colombo Status: working -->
+<!-- EN-Revision: 1.40 Maintainer: colombo Status: working -->
<reference id="ref.ftp">
- <title>FTP functions</title>
+ <title>Funzioni FTP</title>
<titleabbrev>FTP</titleabbrev>
<partintro>
- <para>
- FTP sta per File Transfer Protocol.</para>
+ <para>
+ Le funzioni in questa estensione implementano l'accesso client ad un file server
+ utilizzando il File Transfer Protocol (FTP) come definito in
+ &spec.ftp;.
+ </para>
<para>
- Le seguenti costanti vengono definite quando si usa il modulo FTP:
- <constant>FTP_ASCII</constant> e <constant>FTP_BINARY</constant>.
+ Usando il modulo FTP vengono definite le seguenti costanti:
+ <constant>FTP_ASCII</constant> e <constant>FTP_BINARY</constant>.
</para>
- <para>
- <example>
- <title><function>ftp</function> esempi</title>
- <programlisting>
-<?php
+ <para>
+ Per l'utilizzo delle funzioni FTP con la vostra configurazione PHP,
+ dovrete aggiungere l'opzione <link linkend="install.configure.enable-ftp">
+ <option>--enable-ftp</option></link> durante l'installazione PHP 4,
+ e <link linkend="install.configure.with-ftp">
+ <option>--with-ftp</option></link> nell'installazione di PHP 3.
+ </para>
+ <para>
+ <example>
+ <title>Esempio di <function>ftp</function></title>
+ <programlisting>
+<![CDATA[
+<?php
// stabilire una connessione
-$conn_id = ftp_connect("$ftp_server");
+$conn_id = ftp_connect($ftp_server);
-// login con username e password
-$login_result = ftp_login($conn_id, "$ftp_user_name", "$ftp_user_pass");
+// login con user name e password
+$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
-// controlla la connessione
-if ((!$conn_id) || (!$login_result)) {
- echo "La connessione Ftp non è riuscita!";
- echo "Tentativo di connessione a $ftp_server per l/'utente $user";
- die;
+// controllo della connessione
+if ((!$conn_id) || (!$login_result)) {
+ echo "La connessione Ftp è fallita!";
+ echo "Tentativo di connessione a $ftp_server per l'utente $ftp_user_name";
+ die;
} else {
- echo "Connesso con $ftp_server, per l/'utente $user";
+ echo "Connesso a $ftp_server, utente $ftp_user_name";
}
-// carica il file
-$upload = ftp_put($conn_id, "$destination_file", "$source_file", FTP_BINARY);
+// upload del file
+$upload = ftp_put($conn_id, $destination_file, $source_file, FTP_BINARY);
-// controlla lo stato dell/' upload
-if (!$upload) {
- echo "Ftp upload non riuscito!";
+// controllo dello stato di upload
+if (!$upload) {
+ echo "Il caricamento Ftp non e' andato a buon fine!";
} else {
- echo "Caricato $source_file su $ftp_server come $destination_file";
+ echo "Caricato il file $source_file su $ftp_server come $destination_file";
}
-// chiudi flusso dati FTP
-ftp_quit($conn_id);
+// chiudere il flusso FTP
+ftp_quit($conn_id);
?>
+]]>
</programlisting>
</example>
</para>
@@ -53,31 +65,44 @@
<refentry id="function.ftp-connect">
<refnamediv>
<refname>ftp_connect</refname>
- <refpurpose>Apre una connessione FTP</refpurpose>
+ <refpurpose>Apre una connessione FTP </refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
- <methodsynopsis>
- <type>int</type><methodname>ftp_connect</methodname>
+ <methodsynopsis>
+ <type>resource</type><methodname>ftp_connect</methodname>
<methodparam><type>string</type><parameter>host</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>port
- </parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>port</parameter></methodparam>
+ <methodparam
+choice="opt"><type>int</type><parameter>timeout</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce un flusso dati FTP se va a buon fine o uno stato di "falso" se si
verifica un errore</para>
+ Restituisce un flusso FTP stream in caso di successo, &false; in caso di errore.
+ </para>
<para>
- <function>ftp_connect</function> Stabilisce una connessione FTP all'
- <parameter>host</parameter> specificato. Il parametro
<parameter>port</parameter>
- specifica una porta alternativa alla quale connettersi. Se viene omessa
- oppure impostata al valore 0, verrà usata la porta 21, default per l'FTP</para>
+ <function>ftp_connect</function> Apre una connessione FTP all'
+ <parameter>host</parameter> specificato. Il parametro <parameter>port</parameter>
+ specifica un porta alternativa alla quale connettersi. Se omessa oppure impostata
+ a zero, verra' usata la porta 21, default dell'FTP.
+ </para>
+ <para>
+ Il parametro <parameter>timeout</parameter> specifica il timeout per tutte
+ le successive operazioni di rete. Se omesso, verrà utilizzato il valore
+predefinito di 90
+ secondi. Il timeout può essere cambiato o interrogato in ogni momento usando
+ <function>ftp_set_option</function> e
+ <function>ftp_get_option</function>.
+ <note>
+ <para>
+ Questo parametro è disponibile solo nella versione CVS.
+ </para>
+ </note>
+ </para>
</refsect1>
</refentry>
-
<refentry id="function.ftp-login">
<refnamediv>
<refname>ftp_login</refname>
- <refpurpose>Esegue il Log in una connessione FTP</refpurpose>
+ <refpurpose>Loggarsi in una connessione FTP </refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -87,10 +112,12 @@
<methodparam><type>string</type><parameter>username</parameter></methodparam>
<methodparam><type>string</type><parameter>password</parameter></methodparam>
</methodsynopsis>
+ <para>
+ Esegue il login un dato flusso FTP.
+ </para>
<para>
- Restituisce lo stato vero se a buon fine o falso in caso di errore</para>
- <para>
- Logs in the given FTP stream.</para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
+ </para>
</refsect1>
</refentry>
@@ -106,7 +133,8 @@
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce la directory corrente, o lo stato di falso in caso di errore.</para>
+ Restituisce il nome della directory corrente, oppure &false; in caso di errore.
+ </para>
</refsect1>
</refentry>
@@ -121,17 +149,19 @@
<type>int</type><methodname>ftp_cdup</methodname>
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
</methodsynopsis>
+ <para>
+ Passa alla directory superiore.
+ </para>
<para>
- Restituisce lo stato vero, se a buon fine o falso in caso di errore.</para>
- <para>
- Passa alla directory superione.</para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
+ </para>
</refsect1>
</refentry>
<refentry id="function.ftp-chdir">
<refnamediv>
<refname>ftp_chdir</refname>
- <refpurpose>Cambia directory sul server FTP</refpurpose>
+ <refpurpose>Cambia le directory su un server FTP</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -140,17 +170,18 @@
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</methodsynopsis>
+ <para>
+ Passa alla specifica <parameter>directory</parameter>.
+ </para>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
- Permette di spostarsi alla <parameter>directory</parameter> specificata.</para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.</para>
</refsect1>
</refentry>
<refentry id="function.ftp-mkdir">
<refnamediv>
<refname>ftp_mkdir</refname>
- <refpurpose>Crea directory</refpurpose>
+ <refpurpose>Crea una directory</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -159,10 +190,12 @@
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</methodsynopsis>
+ <para>
+ Crea la <parameter>directory</parameter> specificata.
+ </para>
<para>
- Restituisce il nome della nuova cartella creata o lo stato di falso in caso di
errore.</para>
- <para>
- Crea la <parameter>directory</parameter> specificata.</para>
+ Restituisce il nome della directory appena creata se a buon fine, &false; in
+caso di errore.
+ </para>
</refsect1>
</refentry>
@@ -178,17 +211,18 @@
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</methodsynopsis>
+ <para>
+ Elimina la <parameter>directory</parameter> specificata.
+ </para>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
- Elimina la <parameter>directory</parameter> specificata.</para>
+ Restituisce &true; in caso di successo, &false; in caso di errore.</para>
</refsect1>
</refentry>
<refentry id="function.ftp-nlist">
<refnamediv>
<refname>ftp_nlist</refname>
- <refpurpose>Restituisce l'elenco dei file della directory
specificata.</refpurpose>
+ <refpurpose>Restituisce l'elenco dei files in una data directory.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -198,7 +232,9 @@
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce un array con i nomi dei file se abuon fine, lo stato di falso in
caso di errore.</para>
+ Restituisce una array di nomi di file se a buon fine, &false;
+ in caso di errore.
+ </para>
</refsect1>
</refentry>
@@ -206,7 +242,7 @@
<refnamediv>
<refname>ftp_rawlist</refname>
<refpurpose>
- Restituisce l'elenco dettagliato dei file in una directory specificata.
+ Restituisce l'elenco dettagliato dei file in una data directory.
</refpurpose>
</refnamediv>
<refsect1>
@@ -217,11 +253,12 @@
<methodparam><type>string</type><parameter>directory</parameter></methodparam>
</methodsynopsis>
<para>
- <function>ftp_rawlist</function> esegue il comando FTP LIST,
- e restituisce il risultato in un array. Ogni elemento dell'array corrisponde.
- ad una linea di testo. Il risultato non viene analizzato in alcun modo.
L'identificatore
- di tipo del sistema, resituito da <function>ftp_systype</function> può essere
usato per
- determinare come i risultati debbano essere interpretati.</para>
+ <function>ftp_rawlist</function> esegue il comando FTP LIST
+ e restituisce il risultato come un array. Ogni elemento dell'array corrisponde
+ ad una linea di testo. L'output non viene in alcun modo interpretato.
+ L'identificatore del tipo di sistema restituito da
+<function>ftp_systype</function>
+ puo' essere usato per determinare l'interpretazione del risultato.
+ </para>
</refsect1>
</refentry>
@@ -229,7 +266,7 @@
<refnamediv>
<refname>ftp_systype</refname>
<refpurpose>
- Restituisce l'identificatore tipo di file del sistema sul server FTP remoto.
+ Restituisce l'identificatore del tipo di sistema del server FTP remoto.
</refpurpose>
</refnamediv>
<refsect1>
@@ -239,14 +276,15 @@
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce il tipo del sistema remoto, o lo stato di falso in caso di
errore.</para>
+ Restituisce il tipo di sistema remoto, oppure &false; in caso di errore.
+ </para>
</refsect1>
</refentry>
<refentry id="function.ftp-pasv">
<refnamediv>
<refname>ftp_pasv</refname>
- <refpurpose>Abilita o disabilita la modalità passiva.</refpurpose>
+ <refpurpose>Abilita o disabilita la modalità passiva</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -256,11 +294,15 @@
<methodparam><type>int</type><parameter>pasv</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
+ <function>ftp_pasv</function>Abilita la modalità passiva se il parametro
+ <parameter>pasv</parameter> risulta &true; (disabilita la modalità
+ passiva se <parameter>pasv</parameter> risulta &false;.) In
+ modalità passiva la connessione viene iniziata dal client,
+ piuttosto che dal server.
+ </para>
<para>
- <function>ftp_pasv</function> abilita la modalità passiva se il parametro
<parameter>pasv</parameter>
- è vero (disabilita il modo passivo se il parametro<parameter>pasv</parameter> è
falso.)
- Con la modalità passiva abilitata, la connessione viene iniziata dal client,
anzichè dal server.</para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
+ </para>
</refsect1>
</refentry>
@@ -279,14 +321,18 @@
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
<function>ftp_get</function> recupera <parameter>remote_file</parameter>
- dal server FTP, e lo salva in <parameter>local_file</parameter>
- sulla macchina locale. La modalità <parameter>mode</parameter> di trasferimento
specificata
- deve essere <constant>FTP_ASCII</constant> oppure
+ dal server FTP, e lo salva come <parameter>local_file</parameter>
+ localmente. La modalità di trasferimento indicata dal parametro
+<parameter>mode</parameter>
+ deve essere specificata come <constant>FTP_ASCII</constant> oppure
<constant>FTP_BINARY</constant>.
</para>
+ <para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
+ </para>
+ <para>
+ Vedere anche <function>ftp_fget</function>.
+ </para>
</refsect1>
</refentry>
@@ -306,12 +352,15 @@
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
<function>ftp_fget</function> recupera <parameter>remote_file</parameter>
- dal server FTP, e lo scrive al puntatore file indicato,
- <parameter>fp</parameter>. Il<parameter>mode</parameter> di trasferimento
specificato
- deve essere FTP_ASCII oppure FTP_BINARY.</para>
+ dal server FTP, e lo scrive da un dato puntatore del file,
+ <parameter>fp</parameter>. Il parametro <parameter>mode</parameter> che
+specifica
+ il tipo di trasferimento deve essere <constant>FTP_ASCII</constant> oppure
+ <constant>FTP_BINARY</constant>.
+ </para>
+ <para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
+ </para>
</refsect1>
</refentry>
@@ -330,18 +379,21 @@
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
<function>ftp_put</function> salva <parameter>local_file</parameter>
- sul server FTP, come <parameter>remote_file</parameter>. Il
- <parameter>mode</parameter> di trasferimento specificato deve essere
- <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>.
+ sul server FTP, come <parameter>remote_file</parameter>. Il parametro
+ <parameter>mode</parameter> che spedifica il tipo di trasferimento deve
+ essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>.
+ </para>
+ <para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
</para>
<para>
<example>
- <title><function>ftp_put</function> esempio</title>
+ <title>Esempio di <function>ftp_put</function></title>
<programlisting role="php">
-$upload = ftp_put ($conn_id, "$destination_file", "$source_file", FTP_ASCII);
+<![CDATA[
+$upload = ftp_put ($conn_id, $destination_file, $source_file, FTP_ASCII);
+]]>
</programlisting>
</example>
</para>
@@ -351,7 +403,7 @@
<refentry id="function.ftp-fput">
<refnamediv>
<refname>ftp_fput</refname>
- <refpurpose>Carica i dati da un file aperto al server FTP.</refpurpose>
+ <refpurpose>Carica da un file aperto al server FTP.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -363,13 +415,14 @@
<methodparam><type>int</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
+ <function>ftp_fput</function> carica i dati dal puntatore del file
+ <parameter>fp</parameter> fino alla fine del file stesso. I risultati
+ vengono salvati in <parameter>remote_file</parameter> sul server FTP.
+ Il parametro <parameter>mode</parameter> che spedifica il tipo di trasferimento
+ deve essere <constant>FTP_ASCII</constant> oppure
+<constant>FTP_BINARY</constant>.
+ </para>
<para>
- <function>ftp_fput</function> carica i dati dal puntore del file
- <parameter>fp</parameter> fino alla fine del file. I risultati vengono salvati
- in <parameter>remote_file</parameter> sul server FTP. Il
- <parameter>mode</parameter> del trasferimento specificato deve essere
- <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
</para>
</refsect1>
</refentry>
@@ -377,7 +430,7 @@
<refentry id="function.ftp-size">
<refnamediv>
<refname>ftp_size</refname>
- <refpurpose>Restituisce la dimensione di un file specificato.</refpurpose>
+ <refpurpose>Restituisce la dimensione di un dato file.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -387,18 +440,20 @@
<methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce la dimensione del file se a buon fine, oppure -1 in caso di
errore.</para>
+ <function>ftp_size</function> restituisce la dimensione di un file.
+ Se si verifica un errore, oppure se il file non esiste, viene restituito -1.
+ Non tutti i servers supportano questa caratteritica.
+ </para>
<para>
- <function>ftp_size</function> restituisce la dimensione di un file. Se si
verifica
- un errore oppure il file non esiste, viene restituito il valore -1. Non
- tutti i server supportano questa opzione.</para>
+ Restituisce la dimensione del file se a buon fine, oppure -1 in caso di errore.
+ </para>
</refsect1>
</refentry>
<refentry id="function.ftp-mdtm">
<refnamediv>
<refname>ftp_mdtm</refname>
- <refpurpose>Restituisce l'ora di ultima modifica di un file
specificato.</refpurpose>
+ <refpurpose>Restituisce la data di ultima modifica di un dato file.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -408,16 +463,17 @@
<methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce lo UNIX timestamp se a buon fine, oppure -1 in caso di errore.</para>
+ <function>ftp_mdtm</function> Controlla la data di ultima modifica di un
+ file, e la restituisce in formato UNIX timestamp. Se si verifica un errore,
+oppure
+ il file non esiste, viene restituito -1. Da notare che non tutti i server
+supportano
+ questa caratteristica.
+ </para>
<para>
- <function>ftp_mdtm</function>controlla l'ora di ultima modifica per un file e la
- restituisce nel formato timestamp di UNIX. Se si verifica un errore, oppure il
file non
- esiste, viene restituito il valore -1.Da notare che non tutti i server
- supportano questa opzione.
+ Restituisce uno UNIX timestamp se a buon fine, oppure -1 in caso di errore.
</para>
<note>
<para>
- <function>ftp_mdtm</function> non funziona con le directory.
+ <function>ftp_mdtm</function> non funziona con le cartelle.
</para>
</note>
</refsect1>
@@ -426,22 +482,24 @@
<refentry id="function.ftp-rename">
<refnamediv>
<refname>ftp_rename</refname>
- <refpurpose>Rinomina un file sul server ftp.</refpurpose>
+ <refpurpose>Rinomina un file sul server FTP.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
<methodsynopsis>
- <type>int</type><methodname>ftp_rename</methodname>
- <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
+ <type>boolean</type><methodname>ftp_rename</methodname>
+
+<methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam>
<methodparam><type>string</type><parameter>from</parameter></methodparam>
<methodparam><type>string</type><parameter>to</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
+ <function>ftp_rename</function> rinomina il file o la cartella
+ che ha come nome corrente <parameter>from</parameter> con il nome
+ <parameter>to</parameter>, sul flusso FTP
+ <parameter>ftp_stream</parameter>.
+ </para>
<para>
- <function>ftp_rename</function> rinomina il file specificato
- dal parametro <parameter>from</parameter> con il nuovo nome indicato da
- <parameter>to</parameter>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
</para>
</refsect1>
</refentry>
@@ -449,7 +507,7 @@
<refentry id="function.ftp-delete">
<refnamediv>
<refname>ftp_delete</refname>
- <refpurpose>Cancella un file sul server ftp.</refpurpose>
+ <refpurpose>Cancella un file sul server FTP.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -459,10 +517,11 @@
<methodparam><type>string</type><parameter>path</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
<function>ftp_delete</function> cancella il file specificato da
- <parameter>path</parameter> dal server ftp.
+ <parameter>path</parameter> dal server FTP.
+ </para>
+ <para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
</para>
</refsect1>
</refentry>
@@ -470,7 +529,7 @@
<refentry id="function.ftp-site">
<refnamediv>
<refname>ftp_site</refname>
- <refpurpose>Invia il comando SITE al server.</refpurpose>
+ <refpurpose>Invia un comando SITE al server.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -480,19 +539,46 @@
<methodparam><type>string</type><parameter>cmd</parameter></methodparam>
</methodsynopsis>
<para>
- Restituisce vero se a buon fine, falso in caso di errore.</para>
- <para>
- <function>ftp_site</function> invia il comando specificato da
+ <function>ftp_site</function> Invia il comando specificato da
<parameter>cmd</parameter> al server FTP. I comandi SITE
- non sono standardizzati e cambiano da server a server. Sono utili
- per gestire cose come i permessi sui file e l'appartenenza ad un gruppo. </para>
+ non sono standardizzati, e cambiano da server a server. Sono utili
+ per gestire i permessi di accesso e di appartenenza ai gruppi
+ dei file.
+ </para>
+ <para>
+ Restituisce &true; se a buon fine, &false; in caso di errore.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ftp-close">
+ <refnamediv>
+ <refname>ftp_close</refname>
+ <refpurpose>Choude una connessione FTP</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>void</type><methodname>ftp_close</methodname>
+
+<methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam>
+ </methodsynopsis>
+ <note>
+ <para>
+ Questa funzione è disponibile solo nella versione CVS.
+ </para>
+ </note>
+ <para>
+ <function>ftp_close</function> chiude <parameter>ftp_stream</parameter>
+ e rilascia la risorsa. Non si può riutilizzare questa risorsa, ma è necessario
+ crearne una nuova usando <function>ftp_connect</function>.
+ </para>
</refsect1>
</refentry>
<refentry id="function.ftp-quit">
<refnamediv>
<refname>ftp_quit</refname>
- <refpurpose>Chiude un connessione FTP</refpurpose>
+ <refpurpose>Chiude una connessione FTP.</refpurpose>
</refnamediv>
<refsect1>
<title>Descrizione</title>
@@ -501,11 +587,149 @@
<methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
</methodsynopsis>
<para>
- <function>ftp_connect</function> chiude<parameter>ftp_stream</parameter>.
+ <function>ftp_quit</function> chiude
+ <parameter>ftp_stream</parameter>.
</para>
</refsect1>
</refentry>
+ <refentry id='function.ftp-exec'>
+ <refnamediv>
+ <refname>ftp_exec</refname>
+ <refpurpose>
+ Richiede l'esecuzione di un programma sul server ftp.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>ftp_exec</methodname>
+ <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+ <methodparam><type>string</type><parameter>command</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Invia una richiesta SITE EXEC <parameter>command</parameter> al server
+ ftp. Restituisce &false; se la richiesta fallisce, altrimenti restituisce
+l'output
+ del comando.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.ftp-set-option'>
+ <refnamediv>
+ <refname>ftp_set_option</refname>
+ <refpurpose>
+ Imposta alcune opzioni runtime generiche dell'FTP.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>ftp_set_option</methodname>
+ <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+ <methodparam><type>int</type><parameter>opzione</parameter></methodparam>
+ <methodparam><type>mixed</type><parameter>valore</parameter></methodparam>
+ </methodsynopsis>
+ <note>
+ <para>
+ Questa funzione è disponibile solo nella versione CVS.
+ </para>
+ </note>
+ <para>
+ Restituisce &true; se l'opzione può essere impostata; &false; altrimenti. Un
+messaggio di
+ avviso verrà generato se <parameter>opzione</parameter> non è supportata
+ o se <parameter>valore</parameter> non corrisponde al valore
+ atteso per quella data <parameter>opzione</parameter>.
+ </para>
+ <para>
+ Questa funzione controlla diverse opzioni runtime per lo stream FTP
+ specificato. Il parametro <parameter>valore</parameter> dipende da quale
+parametro
+ <parameter>opzione</parameter> si sceglie di alterare.
+ Attualmente, sono supportate le seguenti opzioni:
+ <table>
+ <title>Opzioni runtime FTP supportate</title>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>FTP_TIMEOUT_SEC</entry>
+ <entry>Cambia il timeout in secondi usato per tutte le funzioni orientate
+alla
+ rete. Il parametro <parameter>value</parameter> deve essere di tipo
+ int e deve essere maggiore di 0. Il valore predefinito di timeout è 90
+ secondi.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ <example>
+ <title>Esempio di <function>ftp_set_option</function></title>
+ <programlisting role="php">
+<![CDATA[
+// Imposta il timeout di rete a 10 secondi
+ftp_set_option($conn_id, FTP_TIMEOUT_SEC, 10);
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.ftp-get-option'>
+ <refnamediv>
+ <refname>ftp_get_option</refname>
+ <refpurpose>
+ Richiama vari comportamenti runtime dello stream FTP attualmente in uso.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>mixed</type><methodname>ftp_get_option</methodname>
+ <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+ <methodparam><type>int</type><parameter>opzione</parameter></methodparam>
+ </methodsynopsis>
+ <note>
+ <para>
+ Questa funzione è disponibile solo nella versione CVS.
+ </para>
+ </note>
+ <para>
+ Restituisce il valore in caso di successo o &false; se la data
+ <parameter>opzione</parameter> non è supportata. Nel secondo caso
+ viene inoltre generato un messaggio di avviso.
+ </para>
+ <para>
+ Questa funzione restituisce il valore corrispondente all'
+ <parameter>opzione</parameter> richiesta, prendendolo dallo <parameter>
+ stream</parameter> specificato. Al momento sono supportate le seguenti opzioni:
+ <table>
+ <title>Opzioni runtime FTP supportate</title>
+ <tgroup cols="2">
+ <tbody>
+ <row>
+ <entry>FTP_TIMEOUT_SEC</entry>
+ <entry>Restituisce l'attuale timeout usato per le operazioni relative alla
+ rete.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ <example>
+ <title>Esempio di <function>ftp_get_option</function></title>
+ <programlisting role="php">
+<![CDATA[
+// Ottiene il timeout del dato stream FTP
+$timeout = ftp_get_option($conn_id, FTP_TIMEOUT_SEC);
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
</reference>
<!-- Keep this comment at the end of the file
Local variables:
@@ -516,12 +740,13 @@
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
-indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
--->
-
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=xml
+vi: ts=1 sw=1
+-->
\ No newline at end of file
