cvs: phpdoc-it /reference/ftp/functions ftp-nb-continue.xml ftp-nb-fget.xml ftp-nb-fput.xml ftp-nb-get.xml ftp-nb-put.xml ftp-nlist.xml
| From: | Andrioli Darvin | Date: | Thu, 07 Oct 2004 12:43:55 +0000 |
| Subject: | cvs: phpdoc-it /reference/ftp/functions ftp-nb-continue.xml ftp-nb-fget.xml ftp-nb-fput.xml ftp-nb-get.xml ftp-nb-put.xml ftp-nlist.xml | ||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-675@lists.php.net to get a copy of this message | ||
darvina Thu Oct 7 08:43:55 2004 EDT
Added files:
/phpdoc-it/reference/ftp/functions ftp-nb-continue.xml
ftp-nb-fget.xml ftp-nb-fput.xml
ftp-nb-get.xml ftp-nb-put.xml
Modified files:
/phpdoc-it/reference/ftp/functions ftp-nlist.xml
Log:
New files translated by Andrea
http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-nlist.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-nlist.xml diff -u phpdoc-it/reference/ftp/functions/ftp-nlist.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-nlist.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-nlist.xml:1.2 Wed Apr 17 03:06:46 2002 +++ phpdoc-it/reference/ftp/functions/ftp-nlist.xml Thu Oct 7 08:43:52 2004 @@ -1,23 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> -<!-- last change to 'ftp-nlist' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: colombo Status: working --> -<!-- OLD-Revision: 1.43/EN.1.2 --> +<!-- last change to 'ftp-nlist' in en/ tree in rev 1.7 --> +<!-- EN-Revision: 1.5 Maintainer: afparam Status: ready --> +<!-- CREDITS: Colombo --> +<!-- OLD-Revision: 1.43/EN.1.7 --> +<!-- splitted from ./en/functions/ftp.xml, last change in rev 1.2 --> <refentry id="function.ftp-nlist"> <refnamediv> <refname>ftp_nlist</refname> - <refpurpose>Restituisce l'elenco dei file in una data directory</refpurpose> + <refpurpose>Restituisce la lista dei file nella directory prescelta</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>ftp_nlist</methodname> - <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </methodsynopsis> <para> - Restituisce una array di nomi di file se a buon fine, &false; - in caso di errore. + Restituisce un array di nomi di file dalla directory specificata + in caso di corretta esecuzione oppure &false; in caso di errore. + </para> + <example> + <title>Esempio di funzione <function>ftp_nlist</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// stabilisce la connessione +$conn_id = ftp_connect($ftp_server); + +// si collega con nome utente e password +$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); + +// recupera il contenuto della directory corrente +$contents = ftp_nlist($conn_id, "."); + +// visualizza $contents +var_dump($contents); + +?> +]]> + </programlisting> + <para> + L'esempio precedente visualizza qualcosa del tipo: + </para> + <screen> +<![CDATA[ +array(3) { + [0]=> + string(11) "public_html" + [1]=> + string(10) "public_ftp" + [2]=> + string(3) "www" +]]> + </screen> + </example> + <para> + Vedere anche <function>ftp_rawlist</function>. </para> </refsect1> </refentry> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-continue.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-continue.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-continue.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-continue' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.5 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-continue"> <refnamediv> <refname>ftp_nb_continue</refname> <refpurpose>Continua a ricevere/trasmettere un file in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_continue</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> </methodsynopsis> <para> Continua a ricevere/trasmettere un file in modalita' non bloccante. </para> <para> <example> <title>Esempio di funzione<function>ftp_nb_continue</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizia lo scaricamento $ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY); while ($ret == FTP_MOREDATA) { // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } ?> ]]> </programlisting> </example> </para> <para> Restituisce <constant>FTP_FAILED</constant> oppure <constant>FTP_FINISHED</constant> oppure <constant>FTP_MOREDATA</constant>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-fget.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-fget.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-fget.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-fget' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.7 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-fget"> <refnamediv> <refname>ftp_nb_fget</refname> <refpurpose>Recupera un file dal server FTP e lo scrive su un file aperto, in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_fget</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>resumepos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_fget</function> recupera <parameter>remote_file</parameter> dal server FTP, e lo scrive nella posizione cui punta il puntatore a file <parameter>handle</parameter>. La modalita' di trasferimento, <parameter>mode</parameter>, specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_fget</function> e' che questa funzione recupera il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni mentre il file viene scaricato. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_fget</function></title> <programlisting role="php"> <![CDATA[ <?php // apre un file in lettura $file = 'index.php'; $fp = fopen($file, 'w'); $conn_id = ftp_connect($ftp_server); $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); // Inizia lo scaricamento $ret = ftp_nb_fget($conn_id, $fp, $file, FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua lo scaricamento... $ret = ftp_nb_continue($conn_id); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } // close filepointer fclose($fp); ?> ]]> </programlisting> </example> </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> Vedere anche <function>ftp_nb_get</function>, <function>ftp_nb_continue</function>, <function>ftp_fget</function>, and <function>ftp_get</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-fput.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-fput.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-fput.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-fput' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.8 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-fput"> <refnamediv> <refname>ftp_nb_fput</refname> <refpurpose>Salva il contenuto di un file aperto sul server FTP in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_fput</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>startpos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_fput</function> carica i dati dalla posizione puntata dal puntatore <parameter>handle</parameter> fino a quando non raggiunge la fine del file. Il risultato e' salvato in <parameter>remote_file</parameter> sul server FTP. La modalita' di trasferimento, <parameter>mode</parameter> specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_fput</function> e' che questa funzione trasferisce il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni mentre il file viene caricato. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_fput</function></title> <programlisting role="php"> <![CDATA[ <?php $file = 'index.php'; $fp = fopen($file, 'r'); $conn_id = ftp_connect($ftp_server); $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); // Inizia il trasferimento del file al server $ret = ftp_nb_fput($conn_id, $file, $fp, FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // continua il trasferimento... $ret = ftp_nb_continue($conn_id); } if ($ret != FTP_FINISHED) { echo "Errore nel trasferimento del file al server..."; exit(1); } fclose($fp); ?> ]]> </programlisting> </example> </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> Vedere anche <function>ftp_nb_put</function>, <function>ftp_nb_continue</function>, <function>ftp_put</function> e <function>ftp_fput</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-get.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-get.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-get' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.8 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-get"> <refnamediv> <refname>ftp_nb_get</refname> <refpurpose>Recupera un file dal server FTP e lo scrive su un file locale in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_get</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>local_file</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>resumepos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_get</function> recupera <parameter>remote_file</parameter> dal server FTP, e lo salva localmente su <parameter>local_file</parameter>. La modalita' di trasferimento, <parameter>mode</parameter>, specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_get</function> e' che questa funzione recupera il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni mentre il file viene scaricato. </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_get</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizia lo scaricamento $ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } ?> ]]> </programlisting> </example> <example> <title>Ripresa di uno scaricamento con <function>ftp_nb_get</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizio $ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY, filesize("test")); // oppure: $ret = ftp_nb_get($my_connection, "test", "README", // FTP_BINARY, FTP_AUTORESUME); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } ?> ]]> </programlisting> </example> <example> <title> Ripresa di uno scaricamento dalla posizione 100 su un nuovo file con <function>ftp_nb_get</function> </title> <programlisting role="php"> <![CDATA[ <?php // Esclusione di Autoseek (ricerca automatica) ftp_set_option($my_connection, FTP_AUTOSEEK, false); // Inizio $ret = ftp_nb_get($my_connection, "newfile", "README", FTP_BINARY, 100); while ($ret == FTP_MOREDATA) { /* ... */ // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } ?> ]]> </programlisting> </example> </para> <para> Nell'esempio precedente, <filename>"newfile"</filename> e' 100 bytes piu' piccolo di <filename>"README"</filename> sul server FTP perche' la lettura e' iniziata dall'offset 100. Se <constant>FTP_AUTOSEEK</constant>non fosse stata disabilitata, i primi 100 bytes di <filename>"newfile"</filename> sarebbero stati <literal>'\0'</literal>. </para> <para> Vedere anche <function>ftp_nb_fget</function>, <function>ftp_nb_continue</function>, <function>ftp_get</function>, e <function>ftp_fget</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-put.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-put.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-put.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-put' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.7 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-put"> <refnamediv> <refname>ftp_nb_put</refname> <refpurpose>Salva un file sul server FTP in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_put</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>string</type><parameter>local_file</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>startpos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_put</function> salva <parameter>local_file</parameter> sul server FTP come <parameter>remote_file</parameter>. La modalita' di trasferimento, <parameter>mode</parameter> specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_put</function> e' che questa funzione trasferisce il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni durante il trasferimento. </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_put</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizia il trasferimento $ret = ftp_nb_put($my_connection, "test.remote", "test.local", FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // continua il trasferimento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nel trasferimento del file..."; exit(1); } ?> ]]> </programlisting> </example> <example> <title>Ripresa di un trasferimento con <function>ftp_nb_put</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizio $ret = ftp_nb_put($my_connection, "test.remote", "test.local", FTP_BINARY, ftp_size("test.remote")); // oppure: $ret = ftp_nb_put($my_connection, "test.remote", "test.local", // FTP_BINARY, FTP_AUTORESUME); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua il trasferimento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nel trasferimento del file..."; exit(1); } ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>ftp_nb_fput</function>, <function>ftp_nb_continue</function>, <function>ftp_put</function>, e <function>ftp_fput</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-nlist.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-nlist.xml diff -u phpdoc-it/reference/ftp/functions/ftp-nlist.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-nlist.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-nlist.xml:1.2 Wed Apr 17 03:06:46 2002 +++ phpdoc-it/reference/ftp/functions/ftp-nlist.xml Thu Oct 7 08:43:52 2004 @@ -1,23 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> -<!-- last change to 'ftp-nlist' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: colombo Status: working --> -<!-- OLD-Revision: 1.43/EN.1.2 --> +<!-- last change to 'ftp-nlist' in en/ tree in rev 1.7 --> +<!-- EN-Revision: 1.5 Maintainer: afparam Status: ready --> +<!-- CREDITS: Colombo --> +<!-- OLD-Revision: 1.43/EN.1.7 --> +<!-- splitted from ./en/functions/ftp.xml, last change in rev 1.2 --> <refentry id="function.ftp-nlist"> <refnamediv> <refname>ftp_nlist</refname> - <refpurpose>Restituisce l'elenco dei file in una data directory</refpurpose> + <refpurpose>Restituisce la lista dei file nella directory prescelta</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>array</type><methodname>ftp_nlist</methodname> - <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>directory</parameter></methodparam> </methodsynopsis> <para> - Restituisce una array di nomi di file se a buon fine, &false; - in caso di errore. + Restituisce un array di nomi di file dalla directory specificata + in caso di corretta esecuzione oppure &false; in caso di errore. + </para> + <example> + <title>Esempio di funzione <function>ftp_nlist</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +// stabilisce la connessione +$conn_id = ftp_connect($ftp_server); + +// si collega con nome utente e password +$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); + +// recupera il contenuto della directory corrente +$contents = ftp_nlist($conn_id, "."); + +// visualizza $contents +var_dump($contents); + +?> +]]> + </programlisting> + <para> + L'esempio precedente visualizza qualcosa del tipo: + </para> + <screen> +<![CDATA[ +array(3) { + [0]=> + string(11) "public_html" + [1]=> + string(10) "public_ftp" + [2]=> + string(3) "www" +]]> + </screen> + </example> + <para> + Vedere anche <function>ftp_rawlist</function>. </para> </refsect1> </refentry> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-continue.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-continue.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-continue.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-continue' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.5 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-continue"> <refnamediv> <refname>ftp_nb_continue</refname> <refpurpose>Continua a ricevere/trasmettere un file in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_continue</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> </methodsynopsis> <para> Continua a ricevere/trasmettere un file in modalita' non bloccante. </para> <para> <example> <title>Esempio di funzione<function>ftp_nb_continue</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizia lo scaricamento $ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY); while ($ret == FTP_MOREDATA) { // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } ?> ]]> </programlisting> </example> </para> <para> Restituisce <constant>FTP_FAILED</constant> oppure <constant>FTP_FINISHED</constant> oppure <constant>FTP_MOREDATA</constant>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-fget.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-fget.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-fget.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-fget' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.7 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-fget"> <refnamediv> <refname>ftp_nb_fget</refname> <refpurpose>Recupera un file dal server FTP e lo scrive su un file aperto, in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_fget</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>resumepos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_fget</function> recupera <parameter>remote_file</parameter> dal server FTP, e lo scrive nella posizione cui punta il puntatore a file <parameter>handle</parameter>. La modalita' di trasferimento, <parameter>mode</parameter>, specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_fget</function> e' che questa funzione recupera il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni mentre il file viene scaricato. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_fget</function></title> <programlisting role="php"> <![CDATA[ <?php // apre un file in lettura $file = 'index.php'; $fp = fopen($file, 'w'); $conn_id = ftp_connect($ftp_server); $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); // Inizia lo scaricamento $ret = ftp_nb_fget($conn_id, $fp, $file, FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua lo scaricamento... $ret = ftp_nb_continue($conn_id); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } // close filepointer fclose($fp); ?> ]]> </programlisting> </example> </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> Vedere anche <function>ftp_nb_get</function>, <function>ftp_nb_continue</function>, <function>ftp_fget</function>, and <function>ftp_get</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-fput.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-fput.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-fput.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-fput' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.8 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-fput"> <refnamediv> <refname>ftp_nb_fput</refname> <refpurpose>Salva il contenuto di un file aperto sul server FTP in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_fput</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>resource</type><parameter>handle</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>startpos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_fput</function> carica i dati dalla posizione puntata dal puntatore <parameter>handle</parameter> fino a quando non raggiunge la fine del file. Il risultato e' salvato in <parameter>remote_file</parameter> sul server FTP. La modalita' di trasferimento, <parameter>mode</parameter> specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_fput</function> e' che questa funzione trasferisce il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni mentre il file viene caricato. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_fput</function></title> <programlisting role="php"> <![CDATA[ <?php $file = 'index.php'; $fp = fopen($file, 'r'); $conn_id = ftp_connect($ftp_server); $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); // Inizia il trasferimento del file al server $ret = ftp_nb_fput($conn_id, $file, $fp, FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // continua il trasferimento... $ret = ftp_nb_continue($conn_id); } if ($ret != FTP_FINISHED) { echo "Errore nel trasferimento del file al server..."; exit(1); } fclose($fp); ?> ]]> </programlisting> </example> </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> Vedere anche <function>ftp_nb_put</function>, <function>ftp_nb_continue</function>, <function>ftp_put</function> e <function>ftp_fput</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-get.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-get.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-get.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-get' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.8 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-get"> <refnamediv> <refname>ftp_nb_get</refname> <refpurpose>Recupera un file dal server FTP e lo scrive su un file locale in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_get</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>local_file</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>resumepos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_get</function> recupera <parameter>remote_file</parameter> dal server FTP, e lo salva localmente su <parameter>local_file</parameter>. La modalita' di trasferimento, <parameter>mode</parameter>, specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_get</function> e' che questa funzione recupera il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni mentre il file viene scaricato. </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_get</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizia lo scaricamento $ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } ?> ]]> </programlisting> </example> <example> <title>Ripresa di uno scaricamento con <function>ftp_nb_get</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizio $ret = ftp_nb_get($my_connection, "test", "README", FTP_BINARY, filesize("test")); // oppure: $ret = ftp_nb_get($my_connection, "test", "README", // FTP_BINARY, FTP_AUTORESUME); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nello scaricamento del file..."; exit(1); } ?> ]]> </programlisting> </example> <example> <title> Ripresa di uno scaricamento dalla posizione 100 su un nuovo file con <function>ftp_nb_get</function> </title> <programlisting role="php"> <![CDATA[ <?php // Esclusione di Autoseek (ricerca automatica) ftp_set_option($my_connection, FTP_AUTOSEEK, false); // Inizio $ret = ftp_nb_get($my_connection, "newfile", "README", FTP_BINARY, 100); while ($ret == FTP_MOREDATA) { /* ... */ // Continua lo scaricamento... $ret = ftp_nb_continue($my_connection); } ?> ]]> </programlisting> </example> </para> <para> Nell'esempio precedente, <filename>"newfile"</filename> e' 100 bytes piu' piccolo di <filename>"README"</filename> sul server FTP perche' la lettura e' iniziata dall'offset 100. Se <constant>FTP_AUTOSEEK</constant>non fosse stata disabilitata, i primi 100 bytes di <filename>"newfile"</filename> sarebbero stati <literal>'\0'</literal>. </para> <para> Vedere anche <function>ftp_nb_fget</function>, <function>ftp_nb_continue</function>, <function>ftp_get</function>, e <function>ftp_fget</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-it/reference/ftp/functions/ftp-nb-put.xml?r=1.1&p=1 Index: phpdoc-it/reference/ftp/functions/ftp-nb-put.xml +++ phpdoc-it/reference/ftp/functions/ftp-nb-put.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> <!-- last change to 'ftp-nb-put' in en/ tree in rev 1.7 --> <!-- EN-Revision: 1.7 Maintainer: afparam Status: ready --> <!-- CREDITS: Colombo --> <!-- OLD-Revision: 1.43/EN.1.7 --> <refentry id="function.ftp-nb-put"> <refnamediv> <refname>ftp_nb_put</refname> <refpurpose>Salva un file sul server FTP in modalita' non bloccante</refpurpose> </refnamediv> <refsect1> <title>Descrizione</title> <methodsynopsis> <type>int</type><methodname>ftp_nb_put</methodname> <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> <methodparam><type>string</type><parameter>remote_file</parameter></methodparam> <methodparam><type>string</type><parameter>local_file</parameter></methodparam> <methodparam><type>int</type><parameter>mode</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>startpos</parameter></methodparam> </methodsynopsis> <para> La funzione <function>ftp_nb_put</function> salva <parameter>local_file</parameter> sul server FTP come <parameter>remote_file</parameter>. La modalita' di trasferimento, <parameter>mode</parameter> specificata deve essere <constant>FTP_ASCII</constant> oppure <constant>FTP_BINARY</constant>. La differenza tra questa funzione e la funzione <function>ftp_put</function> e' che questa funzione trasferisce il file in modo asincrono, cosicche' il programma puo' eseguire altre operazioni durante il trasferimento. </para> <para> Restituisce <constant>FTP_FAILED</constant>, <constant>FTP_FINISHED</constant>, oppure <constant>FTP_MOREDATA</constant>. </para> <para> <example> <title>Esempio di funzione <function>ftp_nb_put</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizia il trasferimento $ret = ftp_nb_put($my_connection, "test.remote", "test.local", FTP_BINARY); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // continua il trasferimento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nel trasferimento del file..."; exit(1); } ?> ]]> </programlisting> </example> <example> <title>Ripresa di un trasferimento con <function>ftp_nb_put</function></title> <programlisting role="php"> <![CDATA[ <?php // Inizio $ret = ftp_nb_put($my_connection, "test.remote", "test.local", FTP_BINARY, ftp_size("test.remote")); // oppure: $ret = ftp_nb_put($my_connection, "test.remote", "test.local", // FTP_BINARY, FTP_AUTORESUME); while ($ret == FTP_MOREDATA) { // esegue altre operazioni echo "."; // Continua il trasferimento... $ret = ftp_nb_continue($my_connection); } if ($ret != FTP_FINISHED) { echo "Errore nel trasferimento del file..."; exit(1); } ?> ]]> </programlisting> </example> </para> <para> Vedere anche <function>ftp_nb_fput</function>, <function>ftp_nb_continue</function>, <function>ftp_put</function>, e <function>ftp_fput</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil 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=sgml vi: ts=1 sw=1 -->