cvs: phpdoc-it /reference/curl constants.xml /reference/curl/functions curl-getinfo.xml curl-init.xml curl-multi-exec.xml curl-setopt.xml
curl-version.xml
| From: | Andrioli Darvin | Date: | Mon, 03 Jan 2005 13:30:13 +0000 |
| Subject: | cvs: phpdoc-it /reference/curl constants.xml /reference/curl/functions curl-getinfo.xml curl-init.xml curl-multi-exec.xml curl-setopt.xml curl-version.xml |
||
| Groups: | php.doc.it | ||
| Request: | Send a blank email to doc-it+get-679@lists.php.net to get a copy of this message | ||
darvina Mon Jan 3 08:30:13 2005 EDT
Modified files:
/phpdoc-it/reference/curl constants.xml
/phpdoc-it/reference/curl/functions curl-getinfo.xml curl-init.xml
curl-multi-exec.xml
curl-setopt.xml
curl-version.xml
Log:
Translation update by Fernando
http://cvs.php.net/diff.php/phpdoc-it/reference/curl/constants.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/curl/constants.xml diff -u phpdoc-it/reference/curl/constants.xml:1.3 phpdoc-it/reference/curl/constants.xml:1.4 --- phpdoc-it/reference/curl/constants.xml:1.3 Thu Aug 12 09:55:08 2004 +++ phpdoc-it/reference/curl/constants.xml Mon Jan 3 08:30:11 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <section id="curl.constants"> &reftitle.constants; &extension.constants; @@ -32,6 +33,19 @@ <variablelist> <varlistentry> <term> + <constant>CURLOPT_FTPSSLAUTH</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Disponibile da PHP 5.1.0 + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> <constant>CURLOPT_PORT</constant> (<type>integer</type>) </term> @@ -1269,6 +1283,19 @@ <variablelist> <varlistentry> <term> + <constant>CURLOPT_PROXYAUTH</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> <constant>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</constant> (<type>integer</type>) </term> @@ -2483,7 +2510,45 @@ </term> <listitem> <simpara> - + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + <constant>CURLFTPAUTH_DEFAULT</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Available since PHP 5.1.0 + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + <constant>CURLFTPAUTH_SSL</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Available since PHP 5.1.0 + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + <constant>CURLFTPAUTH_TLS</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Disponibile da PHP 5.1.0 </simpara> </listitem> </varlistentry> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-getinfo.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/curl/functions/curl-getinfo.xml diff -u phpdoc-it/reference/curl/functions/curl-getinfo.xml:1.5 phpdoc-it/reference/curl/functions/curl-getinfo.xml:1.6 --- phpdoc-it/reference/curl/functions/curl-getinfo.xml:1.5 Fri Jan 16 15:55:15 2004 +++ phpdoc-it/reference/curl/functions/curl-getinfo.xml Mon Jan 3 08:30:12 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.5 --> <refentry id='function.curl-getinfo'> <refnamediv> @@ -132,7 +133,7 @@ </listitem> <listitem> <simpara> - "http_encode" + "http_code" </simpara> </listitem> <listitem> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-init.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/curl/functions/curl-init.xml diff -u phpdoc-it/reference/curl/functions/curl-init.xml:1.5 phpdoc-it/reference/curl/functions/curl-init.xml:1.6 --- phpdoc-it/reference/curl/functions/curl-init.xml:1.5 Thu Aug 12 09:55:09 2004 +++ phpdoc-it/reference/curl/functions/curl-init.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.1 --> <refentry id="function.curl-init"> <refnamediv> @@ -35,7 +36,7 @@ curl_setopt($ch, CURLOPT_HEADER, 0); // scarica l'URL e lo passa al browser curl_exec($ch); -// chiude la risorsa curl +// chiude la risorsa curl e rilascia le risorse di sistema curl_close($ch); ?> ]]> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-multi-exec.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/curl/functions/curl-multi-exec.xml diff -u phpdoc-it/reference/curl/functions/curl-multi-exec.xml:1.2 phpdoc-it/reference/curl/functions/curl-multi-exec.xml:1.3 --- phpdoc-it/reference/curl/functions/curl-multi-exec.xml:1.2 Thu Aug 12 09:55:09 2004 +++ phpdoc-it/reference/curl/functions/curl-multi-exec.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: fernando Status: ready --> +<!-- CREDITS: darvina --> <refentry id="function.curl-multi-exec"> <refnamediv> <refname>curl_multi_exec</refname> @@ -12,9 +13,8 @@ <methodsynopsis> <type>int</type><methodname>curl_multi_exec</methodname> <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - <methodparam><type>int</type><parameter>&still_running</parameter></methodparam> + <methodparam><type>int</type><parameter role="reference">still_running</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; <simpara> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-setopt.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/curl/functions/curl-setopt.xml diff -u phpdoc-it/reference/curl/functions/curl-setopt.xml:1.5 phpdoc-it/reference/curl/functions/curl-setopt.xml:1.6 --- phpdoc-it/reference/curl/functions/curl-setopt.xml:1.5 Fri Jan 16 15:55:15 2004 +++ phpdoc-it/reference/curl/functions/curl-setopt.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.16 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.1 --> <refentry id="function.curl-setopt"> <refnamediv> @@ -11,414 +12,1101 @@ <methodsynopsis> <type>bool</type><methodname>curl_setopt</methodname> <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - <methodparam><type>string</type><parameter>opzione</parameter></methodparam> + <methodparam><type>int</type><parameter>option</parameter></methodparam> <methodparam><type>mixed</type><parameter>valore</parameter></methodparam> </methodsynopsis> <para> - La funzione <function>curl_setopt</function> imposta le opzioni - per una sessione CURL identificata dal parametro - <parameter>ch</parameter>. Il parametro <parameter>opzione</parameter> indica - l'opzione che si vuole impostare e <parameter>valore</parameter> è il - valore dell'opzione data da - <parameter>opzione</parameter>. + Imposta le opzioni per una sessione CURL identificata dal parametro + <parameter>ch</parameter>. <parameter>opzione</parameter> + specifica quale opzione impostare e + <parameter>valore</parameter> specifica il valore per l'opzione data. </para> <para> - Il <parameter>valore</parameter> dovrebbe essere di tipo long per - le seguenti opzioni (specificato nel parametro - <parameter>opzione</parameter>): - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_INFILESIZE</parameter>: Quando si carica - un file su un server remoto, questa opzione dovrebbe essere usata - per dire a PHP quale dimensione attendersi dal file in arrivo. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_VERBOSE</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che CURL to segnali tutto quello che sta - avvenendo. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_HEADER</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che gli header vengano inclusi - nell'output. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_NOPROGRESS</parameter>: Impostare questa opzione a un valore - diverso da zero se non si vuole che PHP mostri l'indicazione di avanzamento - nei trasferimenti CURL. - <note> - <simpara> - PHP imposta automaticamente questa opzione a un valore non-zero, - esso dovrebbe essere cambiato solo per eseguire il debug. - </simpara> - </note> - </para> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NOBODY</parameter>: Impostare questa opzione a un valore - diverso da zero se non si desidera l'inclusione del body - nell'output. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FAILONERROR</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che PHP termini senza generare messaggi se il codice HTTP - restituito è maggiore di 300. Il comportamento di default è - di restituire la pagina comunque, ignorando la presenza del codice. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_UPLOAD</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che PHP si prepari per un upload. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POST</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che PHP esegua un comune HTTP POST. - Questo POST è di tipo <literal>application/x-www-form-urlencoded</literal>, - molto spesso usato nei form HTML. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPLISTONLY</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP semplicemente elencherà i nomi in una directory - FTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPAPPEND</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP accoderà l'output al file remoto invece di - sovrascrivere. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NETRC</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP leggerà il vostro file <filename>~./netrc</filename> - al fine di trovare username e password per il server remoto verso il quale - si sta eseguendo la connessione. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Impostare questa opzione a un valore - diverso da zero per seguire ogni header "Location: " che il server dovesse - inviare come parte degli header HTTP (si noti che questo - è ricorsivo, PHP seguirà tutti gli header "Location: " che dovessero essere - inviati.) - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PUT</parameter>: Impostare questa opzione a un valore - diverso da zero per eseguire un HTTP PUT su un file. Il file su cui eseguire PUT deve essere impostato - con <parameter>CURLOPT_INFILE</parameter> e <parameter>CURLOPT_INFILESIZE</parameter>. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_MUTE</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP resterà silenzioso riguardo alle - funzioni CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEOUT</parameter>: Passa un tipo di dato long come - parametro che contiene il tempo massimo, in secondi, che - si è disposti a concedere alle funzioni CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passa un tipo di dato long come - parametro contenente la velocità di trasferimento espressa in byte al - secondo, velocità al di sotto della quale il trasferimento dovrà rimanere per - <parameter>CURLOPT_LOW_SPEED_TIME</parameter> secondi affinché PHP lo consideri troppo lento - e lo termini. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passa un tipo di dato long come - parametro che contiene il tempo in secondi che il trasferimento dovrà rimanere - al di sotto del valore <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter> affinché PHP lo consideri troppo - lento e lo termini. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RESUME_FROM</parameter>: Passa un tipo di dato long come - parametro che contiene l'offset, in byte, dal quale partire - per effettuare il trasferimento. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_CAINFO</parameter>: Passa il nome di un file - contenente uno o più certificati da validare con la controparte. Questo ha senso solo - quando viene usato con il parametro <parameter> - CURLOPT_SSL_VERIFYPEER</parameter>. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSL_VERIFYPEER</parameter>: Passa un long che se impostato - a zero ferma la verifica dei certificati da parte di curl - (per default curl 7.10 ha questa opzione impostata a &true;). - Si possono specificare certificati alternativi usando l'opzione - <parameter>CURLOPT_CAINFO</parameter> (aggiunta in curl 7.9.8) - oppure si può specificare una directory contenente i certificati usando <parameter> - CURLOPT_CAPATH</parameter>. Dalla versione 7.10 curl installa - un'area di default. Può essere necessario impostare il parametro - <parameter>CURLOPT_SSL_VERIFYHOST</parameter> a 1 oppure 0 se - <parameter>CURLOPT_SSL_VERIFYPEER</parameter> è disabilitato (per default è impostato a 2). - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLVERSION</parameter>: Passa un tipo di dato long come - parametro che contiene la versione SSL (2 o 3) da usare. Di - default PHP cercherà di determinare questo dato sè, ciononostante, - in alcuni casi andrà impostato manualmente. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSL_VERIFYHOST</parameter>: Passa un tipo di dato long se - CURL deve verificare il common name del peer certificate durante - l'handshake SSL. Un valore di 1 denota che si deve cercare - l'esistenza del common name, un valore di 2 denota che dovremo assicurarci - che corrisponda all'hostname fornito. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMECONDITION</parameter>: Passa un tipo di dato long come - parametro che che definisce come trattare <parameter>CURLOPT_TIMEVALUE</parameter>. - Si può impostare questo parametro a TIMECOND_IFMODSINCE o - TIMECOND_ISUNMODSINCE. Questa è una caratteristica del solo HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEVALUE</parameter>: Passa un tipo di dato long come - parametro che rappresenta il tempo espresso in secondi trascorsi dal 1 Gennaio 1970. - Il tempo verrà usato come specificato dall'opzione <parameter>CURLOPT_TIMECONDITION</parameter> - o di default verrà usato TIMECOND_IFMODSINCE. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RETURNTRANSFER</parameter>: Passa un valore diverso da zero - se si desidera che CURL restituisca direttamente il trasferimento invece - di stamparlo. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Il parametro <parameter>valore</parameter> deve essere una stringa per i - seguenti valori del parametro - <parameter>opzione</parameter>: - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_URL</parameter>: Questo è l'URL che si desidera - far salvare da PHP. Si può anche impostare questa opzione quando si - inizializza una sessione con la funzione - <function>curl_init</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERPWD</parameter>: Passa una stringa - formattata come [username]:[password], che sarà usata da PHP per - la connessione. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passa una stringa - formattata come [username]:[password], per la connessione - al proxy HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RANGE</parameter>: Passa il range richiesto. - Deve essere nel formato "X-Y", dove X o Y possono - essere omessi. I trasferimenti HTTP supportano anche intervalli multipli, - separati da virgole come in X-Y,N-M. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POSTFIELDS</parameter>: Passa una stringa - contenente tutti i dati da inviare durante una richiesta HTTP "POST". - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_REFERER</parameter>: Passa una stringa - contenente l'header "referer" che verrà usato in una richiesta HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERAGENT</parameter>: Passa una stringa - contenente l'header "user-agent" che sarà usato nella richiesta - HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPPORT</parameter>: Passa una stringa - contenente il valore che verrà usato per ottenere l'indirizzo IP da - usarsi per l'istruzione "POST" dell'ftp. L'istruzione POST dice - al server remoto di collegarsi al nostro indirizzo IP specificato. La - stringa può essere un semplice indirizzo IP, un hostname, il nome di una - interfaccia di rete (sotto Unix) o semplicemente un '-' per indicare di usare - l'indirizzo IP di default del sistema. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIE</parameter>: Passa una stringa - contenente il contenuto del cookie da impostare nell'header - HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERT</parameter>: Passa una stringa - contenente il filename del certificato formattato secondo PEM. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passa una stringa - contenente la password richiesta per usare il certificato - <parameter>CURLOPT_SSLCERT</parameter> . - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIEFILE</parameter>: Passa una stringa - contenente il nome del file contenente i dati relativi al cookie. - Il file del cookie può essere in formato Netscape o semplicemente - un dump degli header in stile HTTP. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passa una stringa - da usare al posto di <literal>GET</literal> o - <literal>HEAD</literal> nell'effettuare una richiesta HTTP. Questo è - utile per effettuare un <literal>DELETE</literal> o altre, più oscure - richieste HTTP. Valori validi sono cose del tipo - <literal>GET</literal>, <literal>POST</literal> e così via; - per esempio non inserire qui una richiesta HTTP intera. Per esempio, - inserire 'GET /index.html HTTP/1.0\r\n\r\n' sarebbe sbagliato. - <note> - <simpara> - Non eseguire se non si è sicuri che il proprio server supporti - il comando. - </simpara> - </note> - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_PROXY</parameter>: Indica il nome del server proxy HTTP - attraverso il quale inviare le richieste. - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_INTERFACE</parameter>: Passa il nome dell'interfaccia di - rete da usare in uscita. Questo può essere il nome di un'interfaccia, - un indirizzo IP o un nome di host. + <parameter>valore</parameter> dovrebbe essere di tipo booleano per + i seguenti valori del parametro <parameter>opzione</parameter>): + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_BINARYTRANSFER</constant></entry> + <entry> + &true; restituisce la riga di output quando + <constant>CURLOPT_RETURNTRANSFER</constant> è usata. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CRLF</constant></entry> + <entry> + &true; per convertire la Unix newlines in CRLF newlines + per i trasferimenti. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry> + <entry> + &true; per usare una cache gobale DNS. Questa opzione non è + thread-safe ed è abilitata per default. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FAILONERROR</constant></entry> + <entry> + &true; per terminare in maniera silenziosa se il codice HTTP restituito + è maggiore di 300. Il comportamento di default è di restituire la + pagina normalmente, ignorando il codice. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FILETIME</constant></entry> + <entry> + &true; per cercare di recuperare la data di modifica + del documento remoto. Si può cercare di ripristinare questo valore usando + l'opzione <parameter>CURLINFO_FILETIME</parameter> con + <function>curl_getinfo</function>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FOLLOWLOCATION</constant></entry> + <entry> + &true; per seguire una qualunque + <literal>"Location: "</literal> intestazione inviata dal server come + parte dell' header HTTP (notare che è ricorsiva, PHP seguirà come molte + <literal>"Location: "</literal> intestazioni inviate, + a meno che <constant>CURLOPT_MAXREDIRS</constant> sia impostata). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FORBID_REUSE</constant></entry> + <entry> + &true; forza la chiusura esplicita della connessione + quando ha finito il processo e non può essere riutilizzata. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FRESH_CONNECT</constant></entry> + <entry> + &true; forza l'uso di una nuova connessione + invece di usarne una in cache. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTP_USE_EPRT</constant></entry> + <entry> + &true; per usare EPRT (e LPRT) quando si opera un + download FTP. Usa &false; per disaibilitare EPRT e LPRT e usare PORT + solamente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTP_USE_EPSV</constant></entry> + <entry> + &true; prima cerca un comando EPSV per trasferimento + FTP prima di ritornare alla modalità PASV. Imposta a &false; + per disabilitare EPSV. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPAPPEND</constant></entry> + <entry> + &true; per accodare aò file remoto invece di + sovrascriverlo. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPASCII</constant></entry> + <entry> + Un alias di + <constant>CURLOPT_TRANSFERTEXT</constant>. Usarlo al suo posto. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPLISTONLY</constant></entry> + <entry> + &true; per elencare solamente i nomi di + una directory FTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HEADER</constant></entry> + <entry> + &true; per includere l'intestazione in output. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPGET</constant></entry> + <entry> + &true; per resettare la richiesta HTTP col metodo GET. + Dopo che GET è il default, diventa necessario solo se il metodo + di richiesta è cambiato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry> + <entry> + &true; per passare attraverso un proxy HTTP fornito. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MUTE</constant></entry> + <entry> + &true; per essere totalemtne silenzioso nei riguardi di + una funzione CURL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NETRC</constant></entry> + <entry> + &true; per condurre il file <filename>~/.netrc</filename> + a trovare username e password per il sito remoto col + quale si stabilisce una connessione. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOBODY</constant></entry> + <entry> + &true; esclude il corpo dall'output. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOPROGRESS</constant></entry> + <entry> + &true; per disabilitare il progress meter per trasferimetni CURL. + <note> + <para> + PHP automaticamente imposta questa opzione a &true; dovrebbe essere cambiata + solo per operazioni di debug. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOSIGNAL</constant></entry> + <entry> + &true; per ignorare qualunque funzione CURL che causa + l'invio di un segnale a un processo PHP. Ciò è settato come default + con le multi-threaded SAPI in modo che le opzioni di timeout possano essere ancora + usate. + </entry> + <entry> + Aggiunto in CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_POST</constant></entry> + <entry> + &true; per compiere un regolare HTTP POST. Questo POST è il tipo + normale di <literal>application/x-www-form-urlencoded</literal>, + più comunemente usata dai form HTML. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PUT</constant></entry> + <entry> + &true; per HTTP PUT un file. Il file da PUT deve + essere impostato con <constant>CURLOPT_INFILE</constant> e + <constant>CURLOPT_INFILESIZE</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RETURNTRANSFER</constant></entry> + <entry> + &true; per restituire il trasferimento come una stringa del + valore restituito di <function>curl_exec</function> al posto di metterlo in + output direttamente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_VERIFYPEER</constant></entry> + <entry> + &false; per fermare CURL dal verificare i certificati dei peer. + Un certificato alternativo di verificare può essere specificato + con l'opzione <constant>CURLOPT_CAINFO</constant> + o una directory certificata può essere specificata con l'opzione + <constant>CURLOPT_CAPATH</constant> . + <constant>CURLOPT_SSL_VERIFYHOST</constant> può anche dover essere messa + &true; o &false; se + <constant>CURLOPT_SSL_VERIFYPEER</constant> è disabilitata (il + default è 2). + </entry> + <entry> + &true; per default nel CURL 7.10. Default bundle installed as of + CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_TRANSFERTEXT</constant></entry> + <entry> + &true; per usare la modalità ASCII per trasferimenti FTP. + Per LDAP, riporta i dati in testo iano invece che in HTML. Sui + sistemi Windows, non imposterà <literal>STDOUT</literal> alla modalità + binaria. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry> + <entry> + &true; invia username e password + quando le seguenti locazioni (che usano + <constant>CURLOPT_FOLLOWLOCATION</constant>), anche quando + l'hostname è cambiato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_UPLOAD</constant></entry> + <entry> + &true; per preparare un upload. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_VERBOSE</constant></entry> + <entry> + &true; per inviare un'informazione di tipo verbose. Scrive + l'output su <literal>STDERR</literal>, o sul file specificato usando + <constant>CURLOPT_STDERR</constant>. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + + <parameter>value</parameter> dovrebbe essere un intero per i + seguenti valori del parametro <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_BUFFERSIZE</constant></entry> + <entry> + La dimensione del buffer da utilizzare per ogni lettura. Non è garantito + che questa richiesta venga soddisfatta, comunque. + </entry> + <entry> + Aggiunto in CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_CLOSEPOLICY</constant></entry> + <entry> + Anche + <parameter>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</parameter> or + <parameter>CURLCLOSEPOLICY_OLDEST</parameter>. + Ci sono altri tre <literal>CURLCLOSEPOLICY_</literal> + costanti, ma CURL non li supporta ancora. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry> + <entry> + Il numero di secondi da aspettare mentre si cerca di connettersi. Usare 0 per + aspettare indefinitamente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry> + <entry> + Il numero di secondi con cui mantenere le istanze DNS in memoria. + Questa opzio è posta a 120 (2 minuti) per default. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPSSLAUTH</constant></entry> + <entry> + Il metodo di autenticazione FTP (quando attivato): + <literal>CURLFTPAUTH_SSL</literal> (cerca per primo SSL), + <literal>CURLFTPAUTH_TLS</literal> (cerca per primo SSL), o + <literal>CURLFTPAUTH_DEFAULT</literal> (lascia decidere a CURL). + </entry> + <entry> + Aggiunto in CURL 7.12.2 e disponibile da PHP 5.1.0 + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTP_VERSION</constant></entry> + <entry> + <parameter>CURL_HTTP_VERSION_NONE</parameter> (default, lascia decidere CURL + quale versione usare), + <parameter>CURL_HTTP_VERSION_1_0</parameter> (forza HTTP/1.0), + o <parameter>CURL_HTTP_VERSION_1_1</parameter> (forza HTTP/1.1). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPAUTH</constant></entry> + <entry> + <para> + Il metodo(i) di autenticazione HTTP da usare. Le opzioni sono: + <parameter>CURLAUTH_BASIC</parameter>, + <parameter>CURLAUTH_DIGEST</parameter>, + <parameter>CURLAUTH_GSSNEGOTIATE</parameter>, + <parameter>CURLAUTH_NTLM</parameter>, + <parameter>CURLAUTH_ANY</parameter>, e + <parameter>CURLAUTH_ANYSAFE</parameter>. + </para> + <para> + Si può usre l'operatore binario <literal>|</literal> (or) per combinare + più di un metodo. In questo caso, CURL testerà il server per vedere + quali metodi esso supporta e sceglierà il migliore. </para> - </listitem> - <listitem> <para> - <parameter>CURLOPT_KRB4LEVEL</parameter>: Passa il security level - KRB4 (Kerberos 4). Ognuna delle seguenti stringhe (in - ordine dalla meno alla più potente): 'clear', 'safe', - 'confidential', 'private'. Se la stringa inviata non corrisponde a nessuna di - queste, verrà usata 'private'. Se si imposta a <literal>NULL</literal>, - la security KRB4 verrà disabilitata. La security KRB4, al momento, funziona solamente - con le transazioni FTP. + <parameter>CURLAUTH_ANY</parameter> è un alias per + <literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. </para> - </listitem> - <listitem> <para> - <parameter>CURLOPT_HTTPHEADER</parameter>: Passa un array di campi header - HTTP da impostare. - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_QUOTE</parameter>: Passa un array di - comandi FTP da eseguire sul server, prima della richiesta FTP. - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_POSTQUOTE</parameter>: Passa un array di - comandi FTP da eseguire sul server, dopo che la richiesta FTP è stata - eseguita. - </para> - </listitem> - </itemizedlist> - </para> - <para> - Le opzioni seguenti richiedono un descrittore a file che è ottenuto usando - la funzione <function>fopen</function>: - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_FILE</parameter>: Il file dove mettere l'output - del trasferimento, di default è STDOUT. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_INFILE</parameter>: Il file da cui - proviene l'input del trasferimento. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_WRITEHEADER</parameter>: Il file sul quale scrivere - la parte di output contenente gli header. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_STDERR</parameter>: Il file sul quale scrivere gli - errori invece di stderr. - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - + <parameter>CURLAUTH_ANYSAFE</parameter> è un alias per + <literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. + </para> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INFILESIZE</constant></entry> + <entry> + La grandezza attesa, in bytes, del file quando si invia (upload) un file a un + sito remoto. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry> + <entry> + La velocità di trasferimento, in bytes al secondo, in cui la trasmissione dovrebbe stare al di sotto + durante <constant>CURLOPT_LOW_SPEED_TIME</constant> secondi + affinchè PHP to consideri la trasmissione troppo lenta e la abortisca. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_LOW_SPEED_TIME</constant></entry> + <entry> + Il numero di secondi in cui il trasferimento dovrebbe stare al di sotto + <constant>CURLOPT_LOW_SPEED_LIMIT</constant> in modo che PHP consideri + la rasmisiosne troppo lenta e la abortisca. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MAXCONNECTS</constant></entry> + <entry> + L'ammontare massimo di connessioni persistenti consentite. + Quando il limite è raggiunto, + <constant>CURLOPT_CLOSEPOLICY</constant> viene usata per determinare + quale connessione chiudere. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MAXREDIRS</constant></entry> + <entry> + L'ammontare massimo di redirezioni HTTP da seguire. Usare questa opzione + insieme a <constant>CURLOPT_FOLLOWLOCATION</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PORT</constant></entry> + <entry> + Un numero di porta alternativo a cui connettersi. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYAUTH</constant></entry> + <entry> + Il metodo di autenticazione HTTP da usare per la connessione al proxy. + Usare la stessa bitmask come descritto in in + <constant>CURLOPT_HTTPAUTH</constant>. Per l'autenticazione del proxy, + solo <parameter>CURLAUTH_BASIC</parameter> e + <parameter>CURLAUTH_NTLM</parameter> sono attualmente supportate. + </entry> + <entry> + Aggiunto in CURL 7.10.7 e PHP 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYPORT</constant></entry> + <entry> + Il numero di porta del proxy alla quale connettersi. Questo numero può essere + anche impostato in <constant>CURLOPT_PROXY</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYTYPE</constant></entry> + <entry> + Anche <parameter>CURLPROXY_HTTP</parameter> (default) o + <parameter>CURLPROXY_SOCKS5</parameter>. + </entry> + <entry> + Aggiunto in CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_RESUME_FROM</constant></entry> + <entry> + L' offset, in byte, per ripristinare un trasferimento. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_VERIFYHOST</constant></entry> + <entry> + 1 per verificare l'esistenza di un nome comune nel certificato + SSL peer . 2 per verificare l'esistenza di + un nome comune e verificare inoltre che soddisfi l'hostname + fornito. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLVERSION</constant></entry> + <entry> + La versione SSL (2 or 3) da usare. Per default PHP cercherà di determinare + ciò da se stesso, benchè in alcuni casi si possa impostarlo manualmente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMECONDITION</constant></entry> + <entry> + Come <constant>CURLOPT_TIMEVALUE</constant> è trattato. + Usare <parameter>CURL_TIMECOND_IFMODSINCE</parameter> per restituire la + pagina solo se è stata mpdificata dalla data specificata in + <constant>CURLOPT_TIMEVALUE</constant>. Se non è stata modificata, + un <literal>"304 Not Modified"</literal> header sarà restituito + assumendo che <constant>CURLOPT_HEADER</constant> è &true;. + Usare <parameter>CURL_TIMECOND_ISUNMODSINCE</parameter> per l'effetto + opposto. <parameter>CURL_TIMECOND_IFMODSINCE</parameter> è il + default. + </entry> + <entry> + Aggiunto in PHP 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMEOUT</constant></entry> + <entry> + Il numero massimo di secondi per permettere alle funzioni CURL di essere eseguite. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMEVALUE</constant></entry> + <entry> + Il tempo in secondi dal 1 Gennaio 1970. Il tempo verrà usato + da <constant>CURLOPT_TIMECONDITION</constant>. Per default, + <parameter>CURL_TIMECOND_IFMODSINCE</parameter> è usato. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere una stringa per i seguenti + valori del parametro <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_CAINFO</constant></entry> + <entry> + Il nome di un file contenente uno o più certificati che verificano la + parità. Ciò ha significato solo quando usato in combinazione con + <constant>CURLOPT_SSL_VERIFYPEER</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CAPATH</constant></entry> + <entry> + Una directory che contiene certificati multipli CA. Usare questa opzione + insieme a <constant>CURLOPT_SSL_VERIFYPEER</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIE</constant></entry> + <entry> + The contents of the <literal>"Set-Cookie: "</literal> header to be + used in the HTTP request. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIEFILE</constant></entry> + <entry> + Il nome del file che contiene i dati del cookie. Il cookie può + essere nel formato Netscape, o solo un semplice header HTTP-style allegato in un + file. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIEJAR</constant></entry> + <entry> + Il nome di un file in cui salvare tutti i cookie interni finchè la + connessione termina. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CUSTOMREQUEST</constant></entry> + <entry> + Un metodo custom di richiesta da usare al posto di + <literal>"GET"</literal> o <literal>"HEAD"</literal> quando avviene una + richiesta HTTP. Ciò è utile per un + <literal>"DELETE"</literal> o altro, in più nasconde le richieste HTTP. + Valori validi sono termini quali <literal>"GET"</literal>, + <literal>"POST"</literal>, <literal>"CONNECT"</literal> e così via; + i.e. Non inserire un'intera riga di richieste HTTP qui. Ad esempio, + scrivere <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal> + sarebbe errato. + <note> + <para> + Non fare ciò senza essere sicuri che innanzitutto il vostro server supporti + il metodo di richiesta custom. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_EGBSOCKET</constant></entry> + <entry> + Come <constant>CURLOPT_RANDOM_FILE</constant>, ecetto un filename + per un Entropy Gathering Daemon socket. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_ENCODING</constant></entry> + <entry> + I contenuti di un' <literal>"Accept-Encoding: "</literal> header. + Ciò abilita la decodifica della risposta. Termini supportati sono + <literal>"identity"</literal>, <literal>"deflate"</literal>, e + <literal>"gzip"</literal>. Se viene impostata una stringa vuota, <literal>""</literal>, + viene inviato un header contenente tutti i tipi di termini supportati. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPPORT</constant></entry> + <entry> + Il valore che verrà utilizzato per ottenere un indirizzo IP da usare + per l'istruzione FTP "POST" . L'istruzione "POST" indica + al server remoto il proprio indirizzo IP a cui connettersi. La + stringa può essere un semplice indirizzo IP, un hostname, un nome di un'interfaccia + di rete (sotto Unix), o un semplice '-' per usare l'indirizzo + Ip del sistema di default. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INTERFACE</constant></entry> + <entry> + Il nome di un'interfaccia di rete di uscita da usare. Può essere + il nome di un'interfaccia, un indirizzo IP o un host name. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_KRB4LEVEL</constant></entry> + <entry> + Il livello di sicurezza KRB4 (Kerberos 4). Uno qualunque dei valori seguenti + (in ordine dal meno al più significativo) sono validi: + <literal>"clear"</literal>, + <literal>"safe"</literal>, + <literal>"confidential"</literal>, + <literal>"private".</literal>. + Se la stringa non corrisponde a uno di questi, si usa + <literal>"private"</literal>. Impostando questa opzione a &null; + disabilita la sicurezza KRB4. Attualmente la sicurezza KRB4 lavora solamente con + transazioni FTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_POSTFIELDS</constant></entry> + <entry> + I dati completi da mandare in post in un'operazione HTTP "POST" . + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXY</constant></entry> + <entry> + Il proxy HTTP in cui veicolare le richieste. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYUSERPWD</constant></entry> + <entry> + Username e password formattate come + <literal>"[username]:[password]"</literal> da usare per la + connessione al proxy. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RANDOM_FILE</constant></entry> + <entry> + IL nome del file da passare al generatore di numeri casuali per SSL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RANGE</constant></entry> + <entry> + Intervallo(i) di dati da ricevere nel formato + <literal>"X-Y"</literal> dove X o Y sono opzionali. I trasferimenti HTTP + supportano inoltre svariati intervalli, separati da virgole nel formato + <literal>"X-Y,N-M"</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_REFERER</constant></entry> + <entry> + Il contenuto dell'header <literal>"Referer: "</literal> da usare in una + richiesta HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry> + <entry> + Elenco di cifre da usare con SSL. Per esempio, + <literal>RC4-SHA</literal> e <literal>TLSv1</literal> sono elenchi + validi di cifre. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERT</constant></entry> + <entry> + Il nome di un file contenente un certificato PEM formattato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERTPASSWD</constant></entry> + <entry> + La password richiesta per usare il + <constant>CURLOPT_SSLCERT</constant> certificato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERTTYPE</constant></entry> + <entry> + Il formato del certificato. Formati ammessi sono + <literal>"PEM"</literal> (default), <literal>"DER"</literal>, + e <literal>"ENG"</literal>. + </entry> + <entry> + Aggiunto in CURL 7.9.3. + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLENGINE</constant></entry> + <entry> + L' identificatore per il cripto-motore della chiave privata SSL + specificata in <constant>CURLOPT_SSLKEY</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry> + <entry> + L' identificatore per il motore crypto usato per cripto-operazioni + asimmetriche. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEY</constant></entry> + <entry> + Il nome di un file contenente una chiave privata SSL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEYPASSWD</constant></entry> + <entry> + La password segreta necessaria per usare la chiave privata SSL specificata in + <constant>CURLOPT_SSLKEY</constant>. + <note> + <para> + Siccome questa opzione contiene una password di tipo sensitive, bisogna ricordarsi di mantenere + lo script PHP, in cui è contenuto, sicuro. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEYTYPE</constant></entry> + <entry> + Il tipo di chiave della chiave privata SSL specificata in + <constant>CURLOPT_SSLKEY</constant>. I tipi di chiavi supportate sono + <literal>"PEM"</literal> (default), <literal>"DER"</literal>, + e <literal>"ENG"</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_URL</constant></entry> + <entry> + L' URL da raggiungere. E' possibnile impostarla quando si inizializza + una sessione con <function>curl_init</function>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_USERAGENT</constant></entry> + <entry> + I contenuti dell'header <literal>"User-Agent: "</literal> da usare in + una richiesta HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_USERPWD</constant></entry> + <entry> + Username e password formattate come + <literal>"[username]:[password]"</literal> da usare per la + connessione. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere un array per i + seguenti valori del parametro <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_HTTP200ALIASES</constant></entry> + <entry> + Un array di 200 risposte HTTP che saranno trattate come risposte valide + e non come errori. + </entry> + <entry> + Aggiunto in CURL 7.10.3. + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPHEADER</constant></entry> + <entry> + Un array di campi di header HTTP da impostare. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_POSTQUOTE</constant></entry> + <entry> + Un array di comandi FTP da eseguire sul server dopo che la richiesta FTP + è stata eseguita. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_QUOTE</constant></entry> + <entry> + Un array di comandi FTP commands da eseguire sul server prima della richiesta + FTP. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere una risorsa di streaming (usando + <function>fopen</function>, per esempio) per i seguenti valori del parametro + <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_FILE</constant></entry> + <entry> + Il file che il trasferimento dovrebbe scrivere. Il default + è <literal>STDOUT</literal> (la finestra del browser). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INFILE</constant></entry> + <entry> + Il file ce il trasferimento dovrebbe leggere quando si fa un upload. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_STDERR</constant></entry> + <entry> + Una locazione alternativa per gli errori di output al posto di + <literal>STDERR</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_WRITEHEADER</constant></entry> + <entry> + Il file su cui viene scritto l' header parte del trasferimento. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere una stringa col nome di una funzione + di callback valida per i seguenti valori del parametro + <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_HEADERFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback la quale prende due + parametri. il primo è la risorsa CURL, il secondo è una + stringa con i dati dell'header da scrivere. Usando questa funzione di + callback, diventa propria la responsabilità di scrivere i dati di header. + Restituisce il numero di bytes scritti. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PASSWDFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback che prende tre + parametri. Il primo è la risorsa CURL, il secondo è una + stringa contenente la richiesta di password e il terzo è la lunghezza + massima della password. Restituisce la stringa che contiene la password. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_READFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback che prende due + parametri. Il primo è la risorsa CURL, e il secondo è una + stringa con i dati da leggere. Usindo questa funzione di callback, + diventa propria la responsabilità di leggere i dati. Restituisce il numero di + bytes letti. Restituisce 0 per un segnale di <literal>EOF</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_WRITEFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback che prende due + parametri. Il primo è la risorsa CURL, e il secondo è una stringa + con i dati da scrivere. Usindo questa funzione di callback, + diventa propria la responsabilità di scrivere i dati. Deve restituire l'esatto + numero di bytes scritti altrimenti fallisce. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <example> + <title> + Inizializza una sessione CURL nuova e carica una pagina web + </title> + <programlisting role="php"> + <![CDATA[ + <?php + // crea una nuova risorsa CURL + $ch = curl_init(); + + // imposta l'URL e altre opzioni spedifiche + curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); + curl_setopt($ch, CURLOPT_HEADER, false); + + // carica l' URL e la passa al browser + curl_exec($ch); + + // chiude la risorsa CURL e rilascia le risorse di sistema + curl_close($ch); + ?> + ]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-version.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/curl/functions/curl-version.xml diff -u phpdoc-it/reference/curl/functions/curl-version.xml:1.3 phpdoc-it/reference/curl/functions/curl-version.xml:1.4 --- phpdoc-it/reference/curl/functions/curl-version.xml:1.3 Fri Jan 17 07:37:17 2003 +++ phpdoc-it/reference/curl/functions/curl-version.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.1 --> <refentry id="function.curl-version"> <refnamediv> @@ -10,7 +11,7 @@ <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>curl_version</methodname> - <void/> + <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> </methodsynopsis> <para> La funzione <function>curl_version</function> restituisce una stringa
http://cvs.php.net/diff.php/phpdoc-it/reference/curl/constants.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/curl/constants.xml diff -u phpdoc-it/reference/curl/constants.xml:1.3 phpdoc-it/reference/curl/constants.xml:1.4 --- phpdoc-it/reference/curl/constants.xml:1.3 Thu Aug 12 09:55:08 2004 +++ phpdoc-it/reference/curl/constants.xml Mon Jan 3 08:30:11 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.3 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <section id="curl.constants"> &reftitle.constants; &extension.constants; @@ -32,6 +33,19 @@ <variablelist> <varlistentry> <term> + <constant>CURLOPT_FTPSSLAUTH</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Disponibile da PHP 5.1.0 + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> <constant>CURLOPT_PORT</constant> (<type>integer</type>) </term> @@ -1269,6 +1283,19 @@ <variablelist> <varlistentry> <term> + <constant>CURLOPT_PROXYAUTH</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> <constant>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</constant> (<type>integer</type>) </term> @@ -2483,7 +2510,45 @@ </term> <listitem> <simpara> - + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + <constant>CURLFTPAUTH_DEFAULT</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Available since PHP 5.1.0 + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + <constant>CURLFTPAUTH_SSL</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Available since PHP 5.1.0 + </simpara> + </listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term> + <constant>CURLFTPAUTH_TLS</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + Disponibile da PHP 5.1.0 </simpara> </listitem> </varlistentry> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-getinfo.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/curl/functions/curl-getinfo.xml diff -u phpdoc-it/reference/curl/functions/curl-getinfo.xml:1.5 phpdoc-it/reference/curl/functions/curl-getinfo.xml:1.6 --- phpdoc-it/reference/curl/functions/curl-getinfo.xml:1.5 Fri Jan 16 15:55:15 2004 +++ phpdoc-it/reference/curl/functions/curl-getinfo.xml Mon Jan 3 08:30:12 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.6 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.5 --> <refentry id='function.curl-getinfo'> <refnamediv> @@ -132,7 +133,7 @@ </listitem> <listitem> <simpara> - "http_encode" + "http_code" </simpara> </listitem> <listitem> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-init.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/curl/functions/curl-init.xml diff -u phpdoc-it/reference/curl/functions/curl-init.xml:1.5 phpdoc-it/reference/curl/functions/curl-init.xml:1.6 --- phpdoc-it/reference/curl/functions/curl-init.xml:1.5 Thu Aug 12 09:55:09 2004 +++ phpdoc-it/reference/curl/functions/curl-init.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.4 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.1 --> <refentry id="function.curl-init"> <refnamediv> @@ -35,7 +36,7 @@ curl_setopt($ch, CURLOPT_HEADER, 0); // scarica l'URL e lo passa al browser curl_exec($ch); -// chiude la risorsa curl +// chiude la risorsa curl e rilascia le risorse di sistema curl_close($ch); ?> ]]> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-multi-exec.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-it/reference/curl/functions/curl-multi-exec.xml diff -u phpdoc-it/reference/curl/functions/curl-multi-exec.xml:1.2 phpdoc-it/reference/curl/functions/curl-multi-exec.xml:1.3 --- phpdoc-it/reference/curl/functions/curl-multi-exec.xml:1.2 Thu Aug 12 09:55:09 2004 +++ phpdoc-it/reference/curl/functions/curl-multi-exec.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: darvina Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: fernando Status: ready --> +<!-- CREDITS: darvina --> <refentry id="function.curl-multi-exec"> <refnamediv> <refname>curl_multi_exec</refname> @@ -12,9 +13,8 @@ <methodsynopsis> <type>int</type><methodname>curl_multi_exec</methodname> <methodparam><type>resource</type><parameter>mh</parameter></methodparam> - <methodparam><type>int</type><parameter>&still_running</parameter></methodparam> + <methodparam><type>int</type><parameter role="reference">still_running</parameter></methodparam> </methodsynopsis> - &warn.undocumented.func; <simpara> http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-setopt.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-it/reference/curl/functions/curl-setopt.xml diff -u phpdoc-it/reference/curl/functions/curl-setopt.xml:1.5 phpdoc-it/reference/curl/functions/curl-setopt.xml:1.6 --- phpdoc-it/reference/curl/functions/curl-setopt.xml:1.5 Fri Jan 16 15:55:15 2004 +++ phpdoc-it/reference/curl/functions/curl-setopt.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.16 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.1 --> <refentry id="function.curl-setopt"> <refnamediv> @@ -11,414 +12,1101 @@ <methodsynopsis> <type>bool</type><methodname>curl_setopt</methodname> <methodparam><type>resource</type><parameter>ch</parameter></methodparam> - <methodparam><type>string</type><parameter>opzione</parameter></methodparam> + <methodparam><type>int</type><parameter>option</parameter></methodparam> <methodparam><type>mixed</type><parameter>valore</parameter></methodparam> </methodsynopsis> <para> - La funzione <function>curl_setopt</function> imposta le opzioni - per una sessione CURL identificata dal parametro - <parameter>ch</parameter>. Il parametro <parameter>opzione</parameter> indica - l'opzione che si vuole impostare e <parameter>valore</parameter> è il - valore dell'opzione data da - <parameter>opzione</parameter>. + Imposta le opzioni per una sessione CURL identificata dal parametro + <parameter>ch</parameter>. <parameter>opzione</parameter> + specifica quale opzione impostare e + <parameter>valore</parameter> specifica il valore per l'opzione data. </para> <para> - Il <parameter>valore</parameter> dovrebbe essere di tipo long per - le seguenti opzioni (specificato nel parametro - <parameter>opzione</parameter>): - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_INFILESIZE</parameter>: Quando si carica - un file su un server remoto, questa opzione dovrebbe essere usata - per dire a PHP quale dimensione attendersi dal file in arrivo. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_VERBOSE</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che CURL to segnali tutto quello che sta - avvenendo. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_HEADER</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che gli header vengano inclusi - nell'output. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_NOPROGRESS</parameter>: Impostare questa opzione a un valore - diverso da zero se non si vuole che PHP mostri l'indicazione di avanzamento - nei trasferimenti CURL. - <note> - <simpara> - PHP imposta automaticamente questa opzione a un valore non-zero, - esso dovrebbe essere cambiato solo per eseguire il debug. - </simpara> - </note> - </para> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NOBODY</parameter>: Impostare questa opzione a un valore - diverso da zero se non si desidera l'inclusione del body - nell'output. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FAILONERROR</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che PHP termini senza generare messaggi se il codice HTTP - restituito è maggiore di 300. Il comportamento di default è - di restituire la pagina comunque, ignorando la presenza del codice. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_UPLOAD</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che PHP si prepari per un upload. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POST</parameter>: Impostare questa opzione a un valore - diverso da zero se si vuole che PHP esegua un comune HTTP POST. - Questo POST è di tipo <literal>application/x-www-form-urlencoded</literal>, - molto spesso usato nei form HTML. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPLISTONLY</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP semplicemente elencherà i nomi in una directory - FTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPAPPEND</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP accoderà l'output al file remoto invece di - sovrascrivere. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_NETRC</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP leggerà il vostro file <filename>~./netrc</filename> - al fine di trovare username e password per il server remoto verso il quale - si sta eseguendo la connessione. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Impostare questa opzione a un valore - diverso da zero per seguire ogni header "Location: " che il server dovesse - inviare come parte degli header HTTP (si noti che questo - è ricorsivo, PHP seguirà tutti gli header "Location: " che dovessero essere - inviati.) - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PUT</parameter>: Impostare questa opzione a un valore - diverso da zero per eseguire un HTTP PUT su un file. Il file su cui eseguire PUT deve essere impostato - con <parameter>CURLOPT_INFILE</parameter> e <parameter>CURLOPT_INFILESIZE</parameter>. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_MUTE</parameter>: Impostare questa opzione a un valore - diverso da zero e PHP resterà silenzioso riguardo alle - funzioni CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEOUT</parameter>: Passa un tipo di dato long come - parametro che contiene il tempo massimo, in secondi, che - si è disposti a concedere alle funzioni CURL. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passa un tipo di dato long come - parametro contenente la velocità di trasferimento espressa in byte al - secondo, velocità al di sotto della quale il trasferimento dovrà rimanere per - <parameter>CURLOPT_LOW_SPEED_TIME</parameter> secondi affinché PHP lo consideri troppo lento - e lo termini. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passa un tipo di dato long come - parametro che contiene il tempo in secondi che il trasferimento dovrà rimanere - al di sotto del valore <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter> affinché PHP lo consideri troppo - lento e lo termini. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RESUME_FROM</parameter>: Passa un tipo di dato long come - parametro che contiene l'offset, in byte, dal quale partire - per effettuare il trasferimento. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_CAINFO</parameter>: Passa il nome di un file - contenente uno o più certificati da validare con la controparte. Questo ha senso solo - quando viene usato con il parametro <parameter> - CURLOPT_SSL_VERIFYPEER</parameter>. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSL_VERIFYPEER</parameter>: Passa un long che se impostato - a zero ferma la verifica dei certificati da parte di curl - (per default curl 7.10 ha questa opzione impostata a &true;). - Si possono specificare certificati alternativi usando l'opzione - <parameter>CURLOPT_CAINFO</parameter> (aggiunta in curl 7.9.8) - oppure si può specificare una directory contenente i certificati usando <parameter> - CURLOPT_CAPATH</parameter>. Dalla versione 7.10 curl installa - un'area di default. Può essere necessario impostare il parametro - <parameter>CURLOPT_SSL_VERIFYHOST</parameter> a 1 oppure 0 se - <parameter>CURLOPT_SSL_VERIFYPEER</parameter> è disabilitato (per default è impostato a 2). - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLVERSION</parameter>: Passa un tipo di dato long come - parametro che contiene la versione SSL (2 o 3) da usare. Di - default PHP cercherà di determinare questo dato sè, ciononostante, - in alcuni casi andrà impostato manualmente. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSL_VERIFYHOST</parameter>: Passa un tipo di dato long se - CURL deve verificare il common name del peer certificate durante - l'handshake SSL. Un valore di 1 denota che si deve cercare - l'esistenza del common name, un valore di 2 denota che dovremo assicurarci - che corrisponda all'hostname fornito. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMECONDITION</parameter>: Passa un tipo di dato long come - parametro che che definisce come trattare <parameter>CURLOPT_TIMEVALUE</parameter>. - Si può impostare questo parametro a TIMECOND_IFMODSINCE o - TIMECOND_ISUNMODSINCE. Questa è una caratteristica del solo HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_TIMEVALUE</parameter>: Passa un tipo di dato long come - parametro che rappresenta il tempo espresso in secondi trascorsi dal 1 Gennaio 1970. - Il tempo verrà usato come specificato dall'opzione <parameter>CURLOPT_TIMECONDITION</parameter> - o di default verrà usato TIMECOND_IFMODSINCE. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RETURNTRANSFER</parameter>: Passa un valore diverso da zero - se si desidera che CURL restituisca direttamente il trasferimento invece - di stamparlo. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Il parametro <parameter>valore</parameter> deve essere una stringa per i - seguenti valori del parametro - <parameter>opzione</parameter>: - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_URL</parameter>: Questo è l'URL che si desidera - far salvare da PHP. Si può anche impostare questa opzione quando si - inizializza una sessione con la funzione - <function>curl_init</function>. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERPWD</parameter>: Passa una stringa - formattata come [username]:[password], che sarà usata da PHP per - la connessione. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passa una stringa - formattata come [username]:[password], per la connessione - al proxy HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_RANGE</parameter>: Passa il range richiesto. - Deve essere nel formato "X-Y", dove X o Y possono - essere omessi. I trasferimenti HTTP supportano anche intervalli multipli, - separati da virgole come in X-Y,N-M. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_POSTFIELDS</parameter>: Passa una stringa - contenente tutti i dati da inviare durante una richiesta HTTP "POST". - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_REFERER</parameter>: Passa una stringa - contenente l'header "referer" che verrà usato in una richiesta HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_USERAGENT</parameter>: Passa una stringa - contenente l'header "user-agent" che sarà usato nella richiesta - HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_FTPPORT</parameter>: Passa una stringa - contenente il valore che verrà usato per ottenere l'indirizzo IP da - usarsi per l'istruzione "POST" dell'ftp. L'istruzione POST dice - al server remoto di collegarsi al nostro indirizzo IP specificato. La - stringa può essere un semplice indirizzo IP, un hostname, il nome di una - interfaccia di rete (sotto Unix) o semplicemente un '-' per indicare di usare - l'indirizzo IP di default del sistema. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIE</parameter>: Passa una stringa - contenente il contenuto del cookie da impostare nell'header - HTTP. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERT</parameter>: Passa una stringa - contenente il filename del certificato formattato secondo PEM. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passa una stringa - contenente la password richiesta per usare il certificato - <parameter>CURLOPT_SSLCERT</parameter> . - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_COOKIEFILE</parameter>: Passa una stringa - contenente il nome del file contenente i dati relativi al cookie. - Il file del cookie può essere in formato Netscape o semplicemente - un dump degli header in stile HTTP. - </simpara> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passa una stringa - da usare al posto di <literal>GET</literal> o - <literal>HEAD</literal> nell'effettuare una richiesta HTTP. Questo è - utile per effettuare un <literal>DELETE</literal> o altre, più oscure - richieste HTTP. Valori validi sono cose del tipo - <literal>GET</literal>, <literal>POST</literal> e così via; - per esempio non inserire qui una richiesta HTTP intera. Per esempio, - inserire 'GET /index.html HTTP/1.0\r\n\r\n' sarebbe sbagliato. - <note> - <simpara> - Non eseguire se non si è sicuri che il proprio server supporti - il comando. - </simpara> - </note> - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_PROXY</parameter>: Indica il nome del server proxy HTTP - attraverso il quale inviare le richieste. - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_INTERFACE</parameter>: Passa il nome dell'interfaccia di - rete da usare in uscita. Questo può essere il nome di un'interfaccia, - un indirizzo IP o un nome di host. + <parameter>valore</parameter> dovrebbe essere di tipo booleano per + i seguenti valori del parametro <parameter>opzione</parameter>): + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_BINARYTRANSFER</constant></entry> + <entry> + &true; restituisce la riga di output quando + <constant>CURLOPT_RETURNTRANSFER</constant> è usata. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CRLF</constant></entry> + <entry> + &true; per convertire la Unix newlines in CRLF newlines + per i trasferimenti. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry> + <entry> + &true; per usare una cache gobale DNS. Questa opzione non è + thread-safe ed è abilitata per default. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FAILONERROR</constant></entry> + <entry> + &true; per terminare in maniera silenziosa se il codice HTTP restituito + è maggiore di 300. Il comportamento di default è di restituire la + pagina normalmente, ignorando il codice. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FILETIME</constant></entry> + <entry> + &true; per cercare di recuperare la data di modifica + del documento remoto. Si può cercare di ripristinare questo valore usando + l'opzione <parameter>CURLINFO_FILETIME</parameter> con + <function>curl_getinfo</function>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FOLLOWLOCATION</constant></entry> + <entry> + &true; per seguire una qualunque + <literal>"Location: "</literal> intestazione inviata dal server come + parte dell' header HTTP (notare che è ricorsiva, PHP seguirà come molte + <literal>"Location: "</literal> intestazioni inviate, + a meno che <constant>CURLOPT_MAXREDIRS</constant> sia impostata). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FORBID_REUSE</constant></entry> + <entry> + &true; forza la chiusura esplicita della connessione + quando ha finito il processo e non può essere riutilizzata. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FRESH_CONNECT</constant></entry> + <entry> + &true; forza l'uso di una nuova connessione + invece di usarne una in cache. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTP_USE_EPRT</constant></entry> + <entry> + &true; per usare EPRT (e LPRT) quando si opera un + download FTP. Usa &false; per disaibilitare EPRT e LPRT e usare PORT + solamente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTP_USE_EPSV</constant></entry> + <entry> + &true; prima cerca un comando EPSV per trasferimento + FTP prima di ritornare alla modalità PASV. Imposta a &false; + per disabilitare EPSV. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPAPPEND</constant></entry> + <entry> + &true; per accodare aò file remoto invece di + sovrascriverlo. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPASCII</constant></entry> + <entry> + Un alias di + <constant>CURLOPT_TRANSFERTEXT</constant>. Usarlo al suo posto. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPLISTONLY</constant></entry> + <entry> + &true; per elencare solamente i nomi di + una directory FTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HEADER</constant></entry> + <entry> + &true; per includere l'intestazione in output. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPGET</constant></entry> + <entry> + &true; per resettare la richiesta HTTP col metodo GET. + Dopo che GET è il default, diventa necessario solo se il metodo + di richiesta è cambiato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry> + <entry> + &true; per passare attraverso un proxy HTTP fornito. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MUTE</constant></entry> + <entry> + &true; per essere totalemtne silenzioso nei riguardi di + una funzione CURL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NETRC</constant></entry> + <entry> + &true; per condurre il file <filename>~/.netrc</filename> + a trovare username e password per il sito remoto col + quale si stabilisce una connessione. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOBODY</constant></entry> + <entry> + &true; esclude il corpo dall'output. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOPROGRESS</constant></entry> + <entry> + &true; per disabilitare il progress meter per trasferimetni CURL. + <note> + <para> + PHP automaticamente imposta questa opzione a &true; dovrebbe essere cambiata + solo per operazioni di debug. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_NOSIGNAL</constant></entry> + <entry> + &true; per ignorare qualunque funzione CURL che causa + l'invio di un segnale a un processo PHP. Ciò è settato come default + con le multi-threaded SAPI in modo che le opzioni di timeout possano essere ancora + usate. + </entry> + <entry> + Aggiunto in CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_POST</constant></entry> + <entry> + &true; per compiere un regolare HTTP POST. Questo POST è il tipo + normale di <literal>application/x-www-form-urlencoded</literal>, + più comunemente usata dai form HTML. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PUT</constant></entry> + <entry> + &true; per HTTP PUT un file. Il file da PUT deve + essere impostato con <constant>CURLOPT_INFILE</constant> e + <constant>CURLOPT_INFILESIZE</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RETURNTRANSFER</constant></entry> + <entry> + &true; per restituire il trasferimento come una stringa del + valore restituito di <function>curl_exec</function> al posto di metterlo in + output direttamente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_VERIFYPEER</constant></entry> + <entry> + &false; per fermare CURL dal verificare i certificati dei peer. + Un certificato alternativo di verificare può essere specificato + con l'opzione <constant>CURLOPT_CAINFO</constant> + o una directory certificata può essere specificata con l'opzione + <constant>CURLOPT_CAPATH</constant> . + <constant>CURLOPT_SSL_VERIFYHOST</constant> può anche dover essere messa + &true; o &false; se + <constant>CURLOPT_SSL_VERIFYPEER</constant> è disabilitata (il + default è 2). + </entry> + <entry> + &true; per default nel CURL 7.10. Default bundle installed as of + CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_TRANSFERTEXT</constant></entry> + <entry> + &true; per usare la modalità ASCII per trasferimenti FTP. + Per LDAP, riporta i dati in testo iano invece che in HTML. Sui + sistemi Windows, non imposterà <literal>STDOUT</literal> alla modalità + binaria. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry> + <entry> + &true; invia username e password + quando le seguenti locazioni (che usano + <constant>CURLOPT_FOLLOWLOCATION</constant>), anche quando + l'hostname è cambiato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_UPLOAD</constant></entry> + <entry> + &true; per preparare un upload. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_VERBOSE</constant></entry> + <entry> + &true; per inviare un'informazione di tipo verbose. Scrive + l'output su <literal>STDERR</literal>, o sul file specificato usando + <constant>CURLOPT_STDERR</constant>. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + + <parameter>value</parameter> dovrebbe essere un intero per i + seguenti valori del parametro <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_BUFFERSIZE</constant></entry> + <entry> + La dimensione del buffer da utilizzare per ogni lettura. Non è garantito + che questa richiesta venga soddisfatta, comunque. + </entry> + <entry> + Aggiunto in CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_CLOSEPOLICY</constant></entry> + <entry> + Anche + <parameter>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</parameter> or + <parameter>CURLCLOSEPOLICY_OLDEST</parameter>. + Ci sono altri tre <literal>CURLCLOSEPOLICY_</literal> + costanti, ma CURL non li supporta ancora. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry> + <entry> + Il numero di secondi da aspettare mentre si cerca di connettersi. Usare 0 per + aspettare indefinitamente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry> + <entry> + Il numero di secondi con cui mantenere le istanze DNS in memoria. + Questa opzio è posta a 120 (2 minuti) per default. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPSSLAUTH</constant></entry> + <entry> + Il metodo di autenticazione FTP (quando attivato): + <literal>CURLFTPAUTH_SSL</literal> (cerca per primo SSL), + <literal>CURLFTPAUTH_TLS</literal> (cerca per primo SSL), o + <literal>CURLFTPAUTH_DEFAULT</literal> (lascia decidere a CURL). + </entry> + <entry> + Aggiunto in CURL 7.12.2 e disponibile da PHP 5.1.0 + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTP_VERSION</constant></entry> + <entry> + <parameter>CURL_HTTP_VERSION_NONE</parameter> (default, lascia decidere CURL + quale versione usare), + <parameter>CURL_HTTP_VERSION_1_0</parameter> (forza HTTP/1.0), + o <parameter>CURL_HTTP_VERSION_1_1</parameter> (forza HTTP/1.1). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPAUTH</constant></entry> + <entry> + <para> + Il metodo(i) di autenticazione HTTP da usare. Le opzioni sono: + <parameter>CURLAUTH_BASIC</parameter>, + <parameter>CURLAUTH_DIGEST</parameter>, + <parameter>CURLAUTH_GSSNEGOTIATE</parameter>, + <parameter>CURLAUTH_NTLM</parameter>, + <parameter>CURLAUTH_ANY</parameter>, e + <parameter>CURLAUTH_ANYSAFE</parameter>. + </para> + <para> + Si può usre l'operatore binario <literal>|</literal> (or) per combinare + più di un metodo. In questo caso, CURL testerà il server per vedere + quali metodi esso supporta e sceglierà il migliore. </para> - </listitem> - <listitem> <para> - <parameter>CURLOPT_KRB4LEVEL</parameter>: Passa il security level - KRB4 (Kerberos 4). Ognuna delle seguenti stringhe (in - ordine dalla meno alla più potente): 'clear', 'safe', - 'confidential', 'private'. Se la stringa inviata non corrisponde a nessuna di - queste, verrà usata 'private'. Se si imposta a <literal>NULL</literal>, - la security KRB4 verrà disabilitata. La security KRB4, al momento, funziona solamente - con le transazioni FTP. + <parameter>CURLAUTH_ANY</parameter> è un alias per + <literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. </para> - </listitem> - <listitem> <para> - <parameter>CURLOPT_HTTPHEADER</parameter>: Passa un array di campi header - HTTP da impostare. - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_QUOTE</parameter>: Passa un array di - comandi FTP da eseguire sul server, prima della richiesta FTP. - </para> - </listitem> - <listitem> - <para> - <parameter>CURLOPT_POSTQUOTE</parameter>: Passa un array di - comandi FTP da eseguire sul server, dopo che la richiesta FTP è stata - eseguita. - </para> - </listitem> - </itemizedlist> - </para> - <para> - Le opzioni seguenti richiedono un descrittore a file che è ottenuto usando - la funzione <function>fopen</function>: - <itemizedlist> - <listitem> - <simpara> - <parameter>CURLOPT_FILE</parameter>: Il file dove mettere l'output - del trasferimento, di default è STDOUT. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_INFILE</parameter>: Il file da cui - proviene l'input del trasferimento. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_WRITEHEADER</parameter>: Il file sul quale scrivere - la parte di output contenente gli header. - </simpara> - </listitem> - <listitem> - <simpara> - <parameter>CURLOPT_STDERR</parameter>: Il file sul quale scrivere gli - errori invece di stderr. - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> - + <parameter>CURLAUTH_ANYSAFE</parameter> è un alias per + <literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>. + </para> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INFILESIZE</constant></entry> + <entry> + La grandezza attesa, in bytes, del file quando si invia (upload) un file a un + sito remoto. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry> + <entry> + La velocità di trasferimento, in bytes al secondo, in cui la trasmissione dovrebbe stare al di sotto + durante <constant>CURLOPT_LOW_SPEED_TIME</constant> secondi + affinchè PHP to consideri la trasmissione troppo lenta e la abortisca. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_LOW_SPEED_TIME</constant></entry> + <entry> + Il numero di secondi in cui il trasferimento dovrebbe stare al di sotto + <constant>CURLOPT_LOW_SPEED_LIMIT</constant> in modo che PHP consideri + la rasmisiosne troppo lenta e la abortisca. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MAXCONNECTS</constant></entry> + <entry> + L'ammontare massimo di connessioni persistenti consentite. + Quando il limite è raggiunto, + <constant>CURLOPT_CLOSEPOLICY</constant> viene usata per determinare + quale connessione chiudere. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_MAXREDIRS</constant></entry> + <entry> + L'ammontare massimo di redirezioni HTTP da seguire. Usare questa opzione + insieme a <constant>CURLOPT_FOLLOWLOCATION</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PORT</constant></entry> + <entry> + Un numero di porta alternativo a cui connettersi. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYAUTH</constant></entry> + <entry> + Il metodo di autenticazione HTTP da usare per la connessione al proxy. + Usare la stessa bitmask come descritto in in + <constant>CURLOPT_HTTPAUTH</constant>. Per l'autenticazione del proxy, + solo <parameter>CURLAUTH_BASIC</parameter> e + <parameter>CURLAUTH_NTLM</parameter> sono attualmente supportate. + </entry> + <entry> + Aggiunto in CURL 7.10.7 e PHP 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYPORT</constant></entry> + <entry> + Il numero di porta del proxy alla quale connettersi. Questo numero può essere + anche impostato in <constant>CURLOPT_PROXY</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYTYPE</constant></entry> + <entry> + Anche <parameter>CURLPROXY_HTTP</parameter> (default) o + <parameter>CURLPROXY_SOCKS5</parameter>. + </entry> + <entry> + Aggiunto in CURL 7.10. + </entry> + </row> + <row> + <entry><constant>CURLOPT_RESUME_FROM</constant></entry> + <entry> + L' offset, in byte, per ripristinare un trasferimento. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_VERIFYHOST</constant></entry> + <entry> + 1 per verificare l'esistenza di un nome comune nel certificato + SSL peer . 2 per verificare l'esistenza di + un nome comune e verificare inoltre che soddisfi l'hostname + fornito. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLVERSION</constant></entry> + <entry> + La versione SSL (2 or 3) da usare. Per default PHP cercherà di determinare + ciò da se stesso, benchè in alcuni casi si possa impostarlo manualmente. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMECONDITION</constant></entry> + <entry> + Come <constant>CURLOPT_TIMEVALUE</constant> è trattato. + Usare <parameter>CURL_TIMECOND_IFMODSINCE</parameter> per restituire la + pagina solo se è stata mpdificata dalla data specificata in + <constant>CURLOPT_TIMEVALUE</constant>. Se non è stata modificata, + un <literal>"304 Not Modified"</literal> header sarà restituito + assumendo che <constant>CURLOPT_HEADER</constant> è &true;. + Usare <parameter>CURL_TIMECOND_ISUNMODSINCE</parameter> per l'effetto + opposto. <parameter>CURL_TIMECOND_IFMODSINCE</parameter> è il + default. + </entry> + <entry> + Aggiunto in PHP 5.1.0. + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMEOUT</constant></entry> + <entry> + Il numero massimo di secondi per permettere alle funzioni CURL di essere eseguite. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_TIMEVALUE</constant></entry> + <entry> + Il tempo in secondi dal 1 Gennaio 1970. Il tempo verrà usato + da <constant>CURLOPT_TIMECONDITION</constant>. Per default, + <parameter>CURL_TIMECOND_IFMODSINCE</parameter> è usato. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere una stringa per i seguenti + valori del parametro <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_CAINFO</constant></entry> + <entry> + Il nome di un file contenente uno o più certificati che verificano la + parità. Ciò ha significato solo quando usato in combinazione con + <constant>CURLOPT_SSL_VERIFYPEER</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CAPATH</constant></entry> + <entry> + Una directory che contiene certificati multipli CA. Usare questa opzione + insieme a <constant>CURLOPT_SSL_VERIFYPEER</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIE</constant></entry> + <entry> + The contents of the <literal>"Set-Cookie: "</literal> header to be + used in the HTTP request. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIEFILE</constant></entry> + <entry> + Il nome del file che contiene i dati del cookie. Il cookie può + essere nel formato Netscape, o solo un semplice header HTTP-style allegato in un + file. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_COOKIEJAR</constant></entry> + <entry> + Il nome di un file in cui salvare tutti i cookie interni finchè la + connessione termina. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_CUSTOMREQUEST</constant></entry> + <entry> + Un metodo custom di richiesta da usare al posto di + <literal>"GET"</literal> o <literal>"HEAD"</literal> quando avviene una + richiesta HTTP. Ciò è utile per un + <literal>"DELETE"</literal> o altro, in più nasconde le richieste HTTP. + Valori validi sono termini quali <literal>"GET"</literal>, + <literal>"POST"</literal>, <literal>"CONNECT"</literal> e così via; + i.e. Non inserire un'intera riga di richieste HTTP qui. Ad esempio, + scrivere <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal> + sarebbe errato. + <note> + <para> + Non fare ciò senza essere sicuri che innanzitutto il vostro server supporti + il metodo di richiesta custom. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_EGBSOCKET</constant></entry> + <entry> + Come <constant>CURLOPT_RANDOM_FILE</constant>, ecetto un filename + per un Entropy Gathering Daemon socket. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_ENCODING</constant></entry> + <entry> + I contenuti di un' <literal>"Accept-Encoding: "</literal> header. + Ciò abilita la decodifica della risposta. Termini supportati sono + <literal>"identity"</literal>, <literal>"deflate"</literal>, e + <literal>"gzip"</literal>. Se viene impostata una stringa vuota, <literal>""</literal>, + viene inviato un header contenente tutti i tipi di termini supportati. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_FTPPORT</constant></entry> + <entry> + Il valore che verrà utilizzato per ottenere un indirizzo IP da usare + per l'istruzione FTP "POST" . L'istruzione "POST" indica + al server remoto il proprio indirizzo IP a cui connettersi. La + stringa può essere un semplice indirizzo IP, un hostname, un nome di un'interfaccia + di rete (sotto Unix), o un semplice '-' per usare l'indirizzo + Ip del sistema di default. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INTERFACE</constant></entry> + <entry> + Il nome di un'interfaccia di rete di uscita da usare. Può essere + il nome di un'interfaccia, un indirizzo IP o un host name. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_KRB4LEVEL</constant></entry> + <entry> + Il livello di sicurezza KRB4 (Kerberos 4). Uno qualunque dei valori seguenti + (in ordine dal meno al più significativo) sono validi: + <literal>"clear"</literal>, + <literal>"safe"</literal>, + <literal>"confidential"</literal>, + <literal>"private".</literal>. + Se la stringa non corrisponde a uno di questi, si usa + <literal>"private"</literal>. Impostando questa opzione a &null; + disabilita la sicurezza KRB4. Attualmente la sicurezza KRB4 lavora solamente con + transazioni FTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_POSTFIELDS</constant></entry> + <entry> + I dati completi da mandare in post in un'operazione HTTP "POST" . + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXY</constant></entry> + <entry> + Il proxy HTTP in cui veicolare le richieste. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PROXYUSERPWD</constant></entry> + <entry> + Username e password formattate come + <literal>"[username]:[password]"</literal> da usare per la + connessione al proxy. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RANDOM_FILE</constant></entry> + <entry> + IL nome del file da passare al generatore di numeri casuali per SSL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_RANGE</constant></entry> + <entry> + Intervallo(i) di dati da ricevere nel formato + <literal>"X-Y"</literal> dove X o Y sono opzionali. I trasferimenti HTTP + supportano inoltre svariati intervalli, separati da virgole nel formato + <literal>"X-Y,N-M"</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_REFERER</constant></entry> + <entry> + Il contenuto dell'header <literal>"Referer: "</literal> da usare in una + richiesta HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry> + <entry> + Elenco di cifre da usare con SSL. Per esempio, + <literal>RC4-SHA</literal> e <literal>TLSv1</literal> sono elenchi + validi di cifre. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERT</constant></entry> + <entry> + Il nome di un file contenente un certificato PEM formattato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERTPASSWD</constant></entry> + <entry> + La password richiesta per usare il + <constant>CURLOPT_SSLCERT</constant> certificato. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLCERTTYPE</constant></entry> + <entry> + Il formato del certificato. Formati ammessi sono + <literal>"PEM"</literal> (default), <literal>"DER"</literal>, + e <literal>"ENG"</literal>. + </entry> + <entry> + Aggiunto in CURL 7.9.3. + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLENGINE</constant></entry> + <entry> + L' identificatore per il cripto-motore della chiave privata SSL + specificata in <constant>CURLOPT_SSLKEY</constant>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry> + <entry> + L' identificatore per il motore crypto usato per cripto-operazioni + asimmetriche. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEY</constant></entry> + <entry> + Il nome di un file contenente una chiave privata SSL. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEYPASSWD</constant></entry> + <entry> + La password segreta necessaria per usare la chiave privata SSL specificata in + <constant>CURLOPT_SSLKEY</constant>. + <note> + <para> + Siccome questa opzione contiene una password di tipo sensitive, bisogna ricordarsi di mantenere + lo script PHP, in cui è contenuto, sicuro. + </para> + </note> + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_SSLKEYTYPE</constant></entry> + <entry> + Il tipo di chiave della chiave privata SSL specificata in + <constant>CURLOPT_SSLKEY</constant>. I tipi di chiavi supportate sono + <literal>"PEM"</literal> (default), <literal>"DER"</literal>, + e <literal>"ENG"</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_URL</constant></entry> + <entry> + L' URL da raggiungere. E' possibnile impostarla quando si inizializza + una sessione con <function>curl_init</function>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_USERAGENT</constant></entry> + <entry> + I contenuti dell'header <literal>"User-Agent: "</literal> da usare in + una richiesta HTTP. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_USERPWD</constant></entry> + <entry> + Username e password formattate come + <literal>"[username]:[password]"</literal> da usare per la + connessione. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere un array per i + seguenti valori del parametro <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_HTTP200ALIASES</constant></entry> + <entry> + Un array di 200 risposte HTTP che saranno trattate come risposte valide + e non come errori. + </entry> + <entry> + Aggiunto in CURL 7.10.3. + </entry> + </row> + <row> + <entry><constant>CURLOPT_HTTPHEADER</constant></entry> + <entry> + Un array di campi di header HTTP da impostare. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_POSTQUOTE</constant></entry> + <entry> + Un array di comandi FTP da eseguire sul server dopo che la richiesta FTP + è stata eseguita. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_QUOTE</constant></entry> + <entry> + Un array di comandi FTP commands da eseguire sul server prima della richiesta + FTP. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere una risorsa di streaming (usando + <function>fopen</function>, per esempio) per i seguenti valori del parametro + <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_FILE</constant></entry> + <entry> + Il file che il trasferimento dovrebbe scrivere. Il default + è <literal>STDOUT</literal> (la finestra del browser). + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_INFILE</constant></entry> + <entry> + Il file ce il trasferimento dovrebbe leggere quando si fa un upload. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_STDERR</constant></entry> + <entry> + Una locazione alternativa per gli errori di output al posto di + <literal>STDERR</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_WRITEHEADER</constant></entry> + <entry> + Il file su cui viene scritto l' header parte del trasferimento. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <parameter>value</parameter> dovrebbe essere una stringa col nome di una funzione + di callback valida per i seguenti valori del parametro + <parameter>option</parameter> : + <informaltable> + <tgroup cols="3"> + <thead> + <row> + <entry>Option</entry> + <entry>Set <parameter>value</parameter> to</entry> + <entry>Notes</entry> + </row> + </thead> + <tbody> + <row> + <entry><constant>CURLOPT_HEADERFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback la quale prende due + parametri. il primo è la risorsa CURL, il secondo è una + stringa con i dati dell'header da scrivere. Usando questa funzione di + callback, diventa propria la responsabilità di scrivere i dati di header. + Restituisce il numero di bytes scritti. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_PASSWDFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback che prende tre + parametri. Il primo è la risorsa CURL, il secondo è una + stringa contenente la richiesta di password e il terzo è la lunghezza + massima della password. Restituisce la stringa che contiene la password. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_READFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback che prende due + parametri. Il primo è la risorsa CURL, e il secondo è una + stringa con i dati da leggere. Usindo questa funzione di callback, + diventa propria la responsabilità di leggere i dati. Restituisce il numero di + bytes letti. Restituisce 0 per un segnale di <literal>EOF</literal>. + </entry> + <entry> + </entry> + </row> + <row> + <entry><constant>CURLOPT_WRITEFUNCTION</constant></entry> + <entry> + Il nome della funzione di callback che prende due + parametri. Il primo è la risorsa CURL, e il secondo è una stringa + con i dati da scrivere. Usindo questa funzione di callback, + diventa propria la responsabilità di scrivere i dati. Deve restituire l'esatto + numero di bytes scritti altrimenti fallisce. + </entry> + <entry> + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + <para> + <example> + <title> + Inizializza una sessione CURL nuova e carica una pagina web + </title> + <programlisting role="php"> + <![CDATA[ + <?php + // crea una nuova risorsa CURL + $ch = curl_init(); + + // imposta l'URL e altre opzioni spedifiche + curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); + curl_setopt($ch, CURLOPT_HEADER, false); + + // carica l' URL e la passa al browser + curl_exec($ch); + + // chiude la risorsa CURL e rilascia le risorse di sistema + curl_close($ch); + ?> + ]]> + </programlisting> + </example> + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/diff.php/phpdoc-it/reference/curl/functions/curl-version.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-it/reference/curl/functions/curl-version.xml diff -u phpdoc-it/reference/curl/functions/curl-version.xml:1.3 phpdoc-it/reference/curl/functions/curl-version.xml:1.4 --- phpdoc-it/reference/curl/functions/curl-version.xml:1.3 Fri Jan 17 07:37:17 2003 +++ phpdoc-it/reference/curl/functions/curl-version.xml Mon Jan 3 08:30:13 2005 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.2 Maintainer: cortesi Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: fernando Status: ready --> +<!-- CREDITS: cortesi --> <!-- splitted from ./it/functions/curl.xml, last change in rev 1.1 --> <refentry id="function.curl-version"> <refnamediv> @@ -10,7 +11,7 @@ <title>Descrizione</title> <methodsynopsis> <type>string</type><methodname>curl_version</methodname> - <void/> + <methodparam choice="opt"><type>int</type><parameter>version</parameter></methodparam> </methodsynopsis> <para> La funzione <function>curl_version</function> restituisce una stringa