cvs: phpdoc-it /reference/ftp/functions ftp-close.xml ftp-connect.xml ftp-delete.xml ftp-exec.xml

From: Date: Wed, 14 Jul 2004 11:56:55 +0000
Subject: cvs: phpdoc-it /reference/ftp/functions ftp-close.xml ftp-connect.xml ftp-delete.xml ftp-exec.xml
Groups: php.doc.it 
Request: Send a blank email to doc-it+get-604@lists.php.net to get a copy of this message
darvina Wed Jul 14 07:56:55 2004 EDT Modified files: /phpdoc-it/reference/ftp/functions ftp-close.xml ftp-connect.xml ftp-delete.xml ftp-exec.xml Log: Sync to En tree

http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-close.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-close.xml diff -u phpdoc-it/reference/ftp/functions/ftp-close.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-close.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-close.xml:1.2 Wed Apr 17 03:06:45 2002 +++ phpdoc-it/reference/ftp/functions/ftp-close.xml Wed Jul 14 07:56:55 2004 @@ -1,8 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- splitted from ./it/functions/ftp.xml, last change in rev 1.2 --> -<!-- last change to 'ftp-close' in en/ tree in rev 1.34 --> -<!-- EN-Revision: 1.2 Maintainer: colombo Status: working --> -<!-- OLD-Revision: 1.43/EN.1.34 --> +<!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> +<!-- last change to 'ftp-close' 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-close"> <refnamediv> <refname>ftp_close</refname> @@ -14,16 +15,38 @@ <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> + <simpara> + <function>ftp_close</function> chiude <parameter>ftp_stream</parameter> + e rilascia la risorsa. Dopo aver chiamato questa funzione, + non e' piu' possibile usare la connessione FTP ed e' necessario crearne una nuova + con <function>ftp_connect</function>. + </simpara> <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>. + <example> + <title>esempio di funzione <function>ftp_close</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); + +// stampa la directory corrente +echo ftp_pwd($conn_id); // / + +// chiude la connessione +ftp_close($conn_id); +?> +]]> + </programlisting> + </example> </para> + <simpara> + Vedere anche <function>ftp_connect</function> + </simpara> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-connect.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-connect.xml diff -u phpdoc-it/reference/ftp/functions/ftp-connect.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-connect.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-connect.xml:1.2 Wed Apr 17 03:06:45 2002 +++ phpdoc-it/reference/ftp/functions/ftp-connect.xml Wed Jul 14 07:56:55 2004 @@ -1,8 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> -<!-- last change to 'ftp-connect' 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-connect' 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-connect"> <refnamediv> <refname>ftp_connect</refname> @@ -10,7 +11,7 @@ </refnamediv> <refsect1> <title>Descrizione</title> - <methodsynopsis> + <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> @@ -20,22 +21,43 @@ Restituisce un flusso FTP stream in caso di successo, &false; in caso di errore. </para> <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. + La funzione <function>ftp_connect</function> apre una connessione FTP all' + <parameter>host</parameter> specificato. <parameter>host</parameter> + non deve essere seguito da barre e non deve essere precedeuto da + <literal>ftp://</literal>. Il parametro <parameter>port</parameter> + specifica una porta alternativa cui connettersi. Se e' + omesso o impostato a zero verra' usata la porta 21, default di 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 + le successive operazioni di rete. Se omesso il valore predefinito e' di 90 + secondi. Il timeout puo' essere modificato o interrogato in qualsiasi momento con <function>ftp_set_option</function> e <function>ftp_get_option</function>. <note> <para> - Questo parametro è disponibile solo nella versione CVS. + Il parametro <parameter>timeout</parameter> e' disponibile a partire dalla release PHP 4.2.0. </para> </note> + </para> + <example> + <title> Esempio di funzione <function>ftp_connect</function> </title> + <programlisting role="php"> +<![CDATA[ +<?php + +$ftp_server = "ftp.example.com"; + +// stabilisce una connessione o esce +$conn_id = ftp_connect($ftp_server) or die("Impossibile collegarsi a $ftp_server"); + +?> +]]> + </programlisting> + </example> + <para> + Vedere anche <function>ftp_close</function>, e + <function>ftp_ssl_connect</function>. </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-delete.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-delete.xml diff -u phpdoc-it/reference/ftp/functions/ftp-delete.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-delete.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-delete.xml:1.2 Wed Apr 17 03:06:46 2002 +++ phpdoc-it/reference/ftp/functions/ftp-delete.xml Wed Jul 14 07:56:55 2004 @@ -1,8 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.1 --> -<!-- last change to 'ftp-delete' 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-delete' 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-delete"> <refnamediv> <refname>ftp_delete</refname> @@ -11,16 +12,46 @@ <refsect1> <title>Descrizione</title> <methodsynopsis> - <type>int</type><methodname>ftp_delete</methodname> - <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> - <methodparam><type>string</type><parameter>percorso</parameter></methodparam> + <type>bool</type><methodname>ftp_delete</methodname> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>path</parameter></methodparam> </methodsynopsis> <para> <function>ftp_delete</function> cancella il file specificato da - <parameter>percorso</parameter> dal server FTP. + <parameter>path</parameter> dal server FTP. </para> <para> - Restituisce &true; se a buon fine, &false; in caso di errore. + <example> + <title> Esempio di funzione <function>ftp_delete</function> </title> + <programlisting role="php"> +<![CDATA[ +<?php +$file = 'public_html/old.txt'; + +// 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); + +// prova a cancellare $file +if (ftp_delete($conn_id, $file)) { + echo "$file cancellato correttamente\n"; +} else { + echo "impossibile cancellare $file\n"; +} + +// chiude la connessione +ftp_close($conn_id); +?> +]]> + </programlisting> + </example> + </para> + <para> + &return.success; </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-it/reference/ftp/functions/ftp-exec.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/ftp/functions/ftp-exec.xml diff -u phpdoc-it/reference/ftp/functions/ftp-exec.xml:1.2 phpdoc-it/reference/ftp/functions/ftp-exec.xml:1.3 --- phpdoc-it/reference/ftp/functions/ftp-exec.xml:1.2 Wed Apr 17 03:06:46 2002 +++ phpdoc-it/reference/ftp/functions/ftp-exec.xml Wed Jul 14 07:56:55 2004 @@ -1,8 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> <!-- splitted from ./it/functions/ftp.xml, last change in rev 1.12 --> -<!-- last change to 'ftp-exec' in en/ tree in rev 1.32 --> -<!-- EN-Revision: 1.2 Maintainer: colombo Status: working --> -<!-- OLD-Revision: 1.43/EN.1.32 --> +<!-- last change to 'ftp-exec' in en/ tree in rev 1.9 --> +<!-- EN-Revision: 1.9 Maintainer: afparam Status: ready --> +<!-- CREDITS: Colombo --> +<!-- OLD-Revision: 1.43/EN.1.9 --> + <refentry id='function.ftp-exec'> <refnamediv> <refname>ftp_exec</refname> @@ -12,13 +14,41 @@ <title>Descrizione</title> <methodsynopsis> <type>bool</type><methodname>ftp_exec</methodname> - <methodparam><type>resource</type><parameter>stream</parameter></methodparam> - <methodparam><type>string</type><parameter>comando</parameter></methodparam> + <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam> + <methodparam><type>string</type><parameter>command</parameter></methodparam> </methodsynopsis> <para> - Invia una richiesta SITE EXEC <parameter>comando</parameter> al server - ftp. Restituisce &false; se la richiesta fallisce, altrimenti restituisce l'output - del comando. + Invia una richiesta SITE EXEC <parameter>command</parameter> al server FTP. + Restituisce &true; se il comando viene eseguito correttamente (codice di risposta: + <literal>200</literal> da parte del server); altrimenti restituisce &false;. + </para> + <para> + <example> + <title> Esempio di funzione <function>ftp_exec</function> </title> + <programlisting role="php"> +<![CDATA[ +<?php + +$command = 'ls -al'; + +$conn_id = ftp_connect($ftp_server); + +$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); + +if ($res = ftp_exec($conn_id, $command)) { + echo "$comando eseguito correttamente<br />\n"; + echo nl2br($res); +} else { + echo 'impossibile eseguire ' . $command; +} + +?> +]]> + </programlisting> + </example> + </para> + <para> + Vedere anche <function>ftp_raw</function>. </para> </refsect1> </refentry>
« previous php.doc.it (#604) next »