cvs: phpdoc-it /reference/ftp/functions ftp-raw.xml ftp-set-option.xml ftp-site.xml ftp-size.xml ftp-ssl-connect.xml ftp-systype.xml

From:	Andrioli Darvin	Date:	Mon, 24 Jan 2005 13:11:36 +0000
Subject:	cvs: phpdoc-it /reference/ftp/functions ftp-raw.xml ftp-set-option.xml ftp-site.xml ftp-size.xml ftp-ssl-connect.xml ftp-systype.xml
Groups:	php.doc.it
Request:	Send a blank email to doc-it+get-681@lists.php.net to get a copy of this message

darvina Mon Jan 24 08:11:36 2005 EDT Added files: /phpdoc-it/reference/ftp/functions ftp-raw.xml ftp-ssl-connect.xml Modified files: /phpdoc-it/reference/ftp/functions ftp-set-option.xml ftp-site.xml ftp-size.xml ftp-systype.xml Log: Translation update by Afparam

http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-set-option.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-set-option.xml diff -u phpdoc-it/reference/ftp/functions/ftp-set-option.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-set-option.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-set-option.xml:1.2 Wed Apr 17 03:06:47 2002 +++ phpdoc-it/reference/ftp/functions/ftp-set-option.xml Mon Jan 24 08:11:35 2005 @@ -1,47 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - - + + + + + + <refentry id='function.ftp-set-option'> <refnamediv> <refname>ftp_set_option</refname> - <refpurpose>Imposta alcune opzioni runtime generiche dell'FTP</refpurpose> + <refpurpose>Imposta varie opzioni per l'esecuzione di 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> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>int</type><parameter>option</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</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>. + Restituisce &true; se e'stato possibile impostare l'opzione; &false; altrimenti. + Se l'opzione <parameter>option</parameter> non e' + supportata o il valore <parameter>value</parameter> del parametro passato alla funzione non corrisponde + al valore atteso per l'opzione <parameter>option</parameter> scelta, viene generato un messaggio di errore. </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: + Questa funzione controlla varie opzioni che hanno effetto durante + l'esecuzione dello stream FTP specificato. Il parametro <parameter>value</parameter> dipende da quale + parametro <parameter>option</parameter> viene scelto per essere modificato. + Attualmente sono riconosciute le seguenti opzioni: <table> - <title>Opzioni runtime FTP supportate</title> + <title>Opzioni supportate per l'esecuzione di FTP</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>valore</parameter> deve essere di tipo - int e deve essere maggiore di 0. Il valore predefinito di timeout è 90 - secondi.</entry> + <entry>Modifica il timeout in secondi utilizzata per tutte le funzioni + di rete. Il parametro <parameter>value</parameter> deve essere un intero maggiore di 0. + Il timeout predefinito e' di 90 secondi.</entry> + </row> + <row> + <entry>FTP_AUTOSEEK</entry> + <entry>Quando attivata, richieste GET or PUT con un parametro + <parameter>resumepos</parameter> o <parameter>startpos</parameter> + iniziano la ricerca dalla posizione richiesta all'interno del file. This is enabled + Questa opzione e' attivata di default. + </entry> </row> </tbody> </tgroup> @@ -49,15 +53,20 @@ </para> <para> <example> - <title>Esempio di <function>ftp_set_option</function></title> + <title>Esempio di funzione <function>ftp_set_option</function></title> <programlisting role="php"> <![CDATA[ +<?php // Imposta il timeout di rete a 10 secondi ftp_set_option($conn_id, FTP_TIMEOUT_SEC, 10); +?> ]]> </programlisting> </example> </para> + <para> + Vedere anche <function>ftp_get_option</function>. + </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-site.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-site.xml diff -u phpdoc-it/reference/ftp/functions/ftp-site.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-site.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-site.xml:1.2 Wed Apr 17 03:06:47 2002 +++ phpdoc-it/reference/ftp/functions/ftp-site.xml Mon Jan 24 08:11:36 2005 @@ -1,30 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> - - - - + + + + + <refentry id="function.ftp-site"> <refnamediv> <refname>ftp_site</refname> - <refpurpose>Invia un comando SITE al server</refpurpose> + <refpurpose>Invia al server un comando SITE</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>ftp_site</methodname> - <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> + <type>bool</type><methodname>ftp_site</methodname> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>cmd</parameter></methodparam> </methodsynopsis> <para> - <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 i permessi di accesso e di appartenenza ai gruppi - dei file. + La funzione <function>ftp_site</function> invia al server FTP + il comando specificato dal parametro <parameter>cmd</parameter>. + I comandi SITE non sono standardizzati e sono diversi da server a server. They are + Sono utili per operare, ad esempio, sui permessi dei file o sull'appartenenza a + gruppi. </para> <para> - Restituisce &true; se a buon fine, &false; in caso di errore. + <example> + <title>Invio di un comando SITE ad un server ftp</title> + <programlisting role="php"> +<![CDATA[ +<?php +/* Connessione al server FTP */ +$conn = ftp_connect('ftp.example.com'); +if (!$conn) die('Impossibile connettersi a ftp.example.com'); + +/* Collegarsi come "user" con password "pass" */ +if (!ftp_login($conn, 'user', 'pass')) die('Errore nel collegamento come "user" a ftp.example.com'); + +/* Invio: comando "SITE CHMOD 0600 /home/user/privatefile" al server ftp */ +if (ftp_site($conn, 'CHMOD 0600 /home/user/privatefile')) { + echo "Comando eseguito correttamente.\n"; +} else { + die('Errore nell'esecuzione del comando.'); +} +?> +]]> + </programlisting> + </example> + </para> + <para> + &return.success; </para> + <simpara> + Vedere anche: + <function>ftp_raw</function> + </simpara> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-size.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-size.xml diff -u phpdoc-it/reference/ftp/functions/ftp-size.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-size.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-size.xml:1.2 Wed Apr 17 03:06:47 2002 +++ phpdoc-it/reference/ftp/functions/ftp-size.xml Mon Jan 24 08:11:36 2005 @@ -1,27 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - - - + + + + <refentry id="function.ftp-size"> <refnamediv> <refname>ftp_size</refname> - <refpurpose>Restituisce la dimensione di un dato file</refpurpose> + <refpurpose>Restituisce le dimensioni del file specificato</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_size</methodname> - <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> </methodsynopsis> <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. + La funzione <function>ftp_size</function> restituisce le dimensioni del file + <parameter>remote_file</parameter> in bytes. Se si verifica un errore, se il file specificato + non esiste, o se e' una directory, viene restituito -1. Non tutti i server supportano questa caratteristica. </para> <para> - Restituisce la dimensione del file se a buon fine, oppure -1 in caso di errore. + Restituisce le dimensioni del file in caso di successo, o -1 in caso di errore. + </para> + <para> + <example> + <title>Esempio di funzione <function>ftp_size</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +$file = 'somefile.txt'; + +// stabilisce la connessione +$conn_id = ftp_connect($ftp_server); + +// si collega come username e password +$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); + +// recupera le dimensioni di $file +$res = ftp_size($conn_id, $file); + +if ($res != -1) { + echo "le dimensioni del file $file sono di $res bytes"; +} else { + echo "impossibile stabilire le dimensioni"; +} + +// chiude la connessione +ftp_close($conn_id); + +?> +]]> + </programlisting> + </example> + </para> + <para> + Vedere anche <function>ftp_rawlist</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-systype.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-systype.xml diff -u phpdoc-it/reference/ftp/functions/ftp-systype.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-systype.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-systype.xml:1.2 Wed Apr 17 03:06:47 2002 +++ phpdoc-it/reference/ftp/functions/ftp-systype.xml Mon Jan 24 08:11:36 2005 @@ -1,21 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?>  - - - + + + + <refentry id="function.ftp-systype"> <refnamediv> <refname>ftp_systype</refname> - <refpurpose>Restituisce l'identificatore del tipo di sistema del server FTP remoto</refpurpose> + <refpurpose>Restituisce l'identificatore di tipo del server FTP remoto</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>ftp_systype</methodname> - <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> </methodsynopsis> <para> - Restituisce il tipo di sistema remoto, oppure &false; in caso di errore. + Restituisce il tipo del sistema remoto, o &false; in caso di errore. + </para> + <para> + <example> + <title>Esempio di funzione<function>ftp_systype</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// connessione ftp +$ftp = ftp_connect('ftp.example.com'); +ftp_login($ftp, 'user', 'password'); + +// recupera il tipo del sistema +if ($type = ftp_systype($ftp)) { + echo "Example.com utilizza $type\n"; +} else { + echo "Impossibile determinare il tipo del sistema"; +} + +?> +]]> + </programlisting> + <para> + L'esempio precedente produrra' in uscita qualosa di simile a: + </para> + <screen> +<![CDATA[ +Example.com utilizza UNIX +]]> + </screen> + </example> </para> </refsect1> </refentry> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-raw.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-raw.xml +++ phpdoc-it/reference/ftp/functions/ftp-raw.xml <?xml version="1.0" encoding="iso-8859-1"?>      <refentry id="function.ftp-raw"> <refnamediv> <refname>ftp_raw</refname> <refpurpose>Invia un comando di qualsiasi tipo ad un server FTP</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>ftp_raw</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>command</parameter></methodparam> </methodsynopsis> <para> Invia un <parameter>command</parameter> di qualsiasi tipo al server FTP. Restituisce la risposta del server sotto forma di un array di stringhe. <function>ftp_raw</function> non esegue il parsing della stringa di risposta, ne' controlla se il comando e' stato eseguito correttamente. </para> <para> <example> <title>Utilizzo di <function>ftp_raw</function> per collegarsi in modo manuale ad un server FTP.</title> <programlisting role="php"> <![CDATA[ <?php $fp = ftp_connect("ftp.example.com"); /* Equivalente a: ftp_login($fp, "joeblow", "secret"); */ ftp_raw($fp, "USER joeblow"); ftp_raw($fp, "PASS secret"); ?> ]]> </programlisting> </example> </para> <para> Vedi anche: <function>ftp_exec</function> </para> </refsect1> </refentry>  http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-ssl-connect.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-ssl-connect.xml +++ phpdoc-it/reference/ftp/functions/ftp-ssl-connect.xml <?xml version="1.0" encoding="iso-8859-1"?>      <refentry id="function.ftp-ssl-connect"> <refnamediv> <refname>ftp_ssl_connect</refname> <refpurpose>Apre una connessione SSL-FTP connessione</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>resource</type><methodname>ftp_ssl_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>timeout</parameter></methodparam> </methodsynopsis> <para> Restituisce uno stream SSL-FTP in caso di successo o &false; in caso di errore. </para> <para> La funzione <function>ftp_ssl_connect</function> apre una connessione SSL-FTP verso il server <parameter>host</parameter>. Il parametro <parameter>port</parameter> specifica una porta alternativa a cui connettersi. Se omesso o impostato a zero allora viene usata la porta 21 standard. </para> <para> Il parametro <parameter>timeout</parameter> specifica il timeout per tutte le operazioni di rete successive. Se omesso il valore predefinito e' di 90 secondi. Il timeout puo' essere interrogato o modificato in qualsiasi momento con le funzioni <function>ftp_set_option</function> e <function>ftp_get_option</function>. </para> <para> <example> <title>Esempio di funzione <function>ftp_ssl_connect</function></title> <programlisting role="php"> <![CDATA[ <?php // stabilisce una connessione ssl $conn_id = ftp_ssl_connect($ftp_server); // si collega come username e password $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); echo ftp_pwd($conn_id); // / // chiude la connessione ssl ftp_close($conn_id); ?> ]]> </programlisting> </example> </para> <note> <title>Perche' questa funzione puo' non essere presente</title> <para> La funzione <function>ftp_ssl_connect</function> e' disponibile solo se il supporto <link linkend="ref.openssl">OpenSSL</link> e' abilitato nella versione corrente di PHP. Se non e' definito ed e' stato incluso il supporto a FTP durante la compilazione, questa e' la ragione per cui la funzione non e' presente. </para> </note> <para> Vedere anche <function>ftp_connect</function>. </para> </refsect1> </refentry>