LMPX.COM |
Home | Linux | Mysql | PHP | XML | ||
|
|
|||
From: Fernando Correa da Conceição Date: Wed Jul 16 09:56:17 2008 Subject: cvs: phpdoc-pt_BR /reference/curl/functions curl-setopt.xml
fernandoc Wed Jul 16 15:56:17 2008 UTC
Modified files:
/phpdoc-pt_BR/reference/curl/functions curl-setopt.xml
Log:
Update (Really is a new translation)
http://cvs.php.net/viewvc.cgi/phpdoc-pt_BR/reference/curl/functions/curl-setopt.xml?r1=1.3&r2=1.4&diff_format=u
Index: phpdoc-pt_BR/reference/curl/functions/curl-setopt.xml
diff -u phpdoc-pt_BR/reference/curl/functions/curl-setopt.xml:1.3 phpdoc-pt_BR/reference/curl/functions/curl-setopt.xml:1.4
--- phpdoc-pt_BR/reference/curl/functions/curl-setopt.xml:1.3 Sat Jun 23 13:30:16 2007
+++ phpdoc-pt_BR/reference/curl/functions/curl-setopt.xml Wed Jul 16 15:56:17 2008
@@ -1,449 +1,1227 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.9 Maintainer: fernandoc Status: ready -->
-<!-- splitted from ./en/functions/curl.xml, last change in rev 1.1 -->
- <refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
- <refnamediv>
- <refname>curl_setopt</refname>
- <refpurpose>Define uma opção para a transferencia CURL</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Descrição</title>
- <methodsynopsis>
- <type>bool</type><methodname>curl_setopt</methodname>
- <methodparam><type>resource</type><parameter>ch</parameter></methodparam>
- <methodparam><type>string</type><parameter>option</parameter></methodparam>
- <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
- </methodsynopsis>
- <para>
- A função <function>curl_setopt</function> irá definir opções
- para uma sessão CURL identificada pelo parâmetro <parameter>ch</parameter>.
- O parâmetro <parameter>option</parameter> é a opção
- que você quer definir, e o <parameter>value</parameter> é
- o valor da opção dada por
- <parameter>option</parameter>.
- </para>
- <para>
- O <parameter>value</parameter> deve ser um longo para as
- seguintes opções ( especificado no parâmetro (specified in the <parameter>option</parameter>):
- <itemizedlist>
- <listitem>
- <simpara>
- <parameter>CURLOPT_INFILESIZE</parameter>: Quando você esta
- enviando um arquivo para um lugar remoto, esta opção deve ser usada
- para dizer ao PHP o tamanho esperado do arquivo.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_VERBOSE</parameter>: Defina esta opção para um
- valor diferente de zero se você quer que o CURL reporte tudo o que
- esteja acontecendo.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_HEADER</parameter>: Defina esta opção para um valor
- diferente de zero se você quer que o cabeçalho seja
- incluído na saída.
- </simpara>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_NOPROGRESS</parameter>: Defina esta opção para um valor diferente
- de zero se você não que o PHP mostre uma barra de progresso
- para as transferencias CURL.
- <note>
- <simpara>
- O PHP automaticamente define esta opção para um valor diferente de zero,
- isto deve ser mudado apenas para o propósito de debug.
- </simpara>
- </note>
- </para>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_NOBODY</parameter>: Defina esta opção para
- um valor diferente de zero se você não quiser que o corpo seja
- incluído na saída.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_FAILONERROR</parameter>: Defina esta opção para
- um valor diferente de zero se você quiser que o PHP falhe silenciosamente se o código HTTP
- retornado for maior do que 300. O funcionamento normal é
- retornar a página normalmente, ignorando o código.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_UPLOAD</parameter>: Defina esta opção para um valor diferente
- de zero se você quiser que o PHP se prepare para um upload.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_POST</parameter>: Defina esta opção para um valor diferente de
- zero se você quiser faça um HTTP POST regular.
- Este POST é do tipo normal <literal>application/x-www-form-urlencoded</literal>
- kind, normalmente usado por formulários HTML.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_FTPLISTONLY</parameter>: Defina esta opção
- para um valor diferente de zero se você quiser que o PHP liste os nomes
- em um diretório FTP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_FTPAPPEND</parameter>: Defina esta opção para um valor
- diferente de zero e o PHP irá adicionar ao arquivo remoto ao invés
- de sobrescreve-lo.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_NETRC</parameter>: Defina esta opção para um
- valor diferente de zero e o PHP irá procurar no seu arquivo <filename>~./netrc</filename>
- para encontrar o seu nome de usuário e senha para o local remoto
- para o qual você esta estabelecendo uma conexão.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_FOLLOWLOCATION</parameter>: Defina esta opçãp para
- um valor diferente de zero para seguir qualquer cabeçalho "Location: " que o servidor
- envie como parte do cabeçalho HTTP ( note que isto
- é recursivo, o PHP irá seguir tantos cabeçalhos "Location: " quantos
- sejam enviados.)
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_PUT</parameter>: Defina esta opção para um valor
- diferente de zero para HTTP PUT um arquivo. O arquivo para PUT deve ser definido
- com <parameter>CURLOPT_INFILE</parameter> e
- <parameter>CURLOPT_INFILESIZE</parameter>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_MUTE</parameter>: Defina esta opção para um valor
- diferente de zero e o PHP será completamente silencioso rem relação
- as funções CURL.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_TIMEOUT</parameter>: Passe um número long como
- parâmetro que contém o limite de tempo, em segundos, que
- você permite as funções CURL levar.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter>: Passe um número long
- como parâmetro que contem a velocidade de transferencia em bytes por
- segundo a qual a transferencia deva estar abaixo durante
- <parameter>CURLOPT_LOW_SPEED_TIME</parameter> segundos para o
- PHP considerar muito lento e abortar.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_LOW_SPEED_TIME</parameter>: Passe um número long
- como parâmetro que contém o tempo em segundos que a
- transferencia deve estar abaixo de
- <parameter>CURLOPT_LOW_SPEED_LIMIT</parameter> para o PHP
- considerar muito lenta e abortar.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_RESUME_FROM</parameter>: Passe um número longo como
- parâmetro que contém o índice em bytes, a partir do
- qual você quer que a transferencia comece.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_CAINFO</parameter>: Passe um nome de arquivo de um
- arquivo contendo um ou mais certificados para verificar o peer. Isto
- somente faz sentido quando usado em combinação com a opção
- <parameter>CURLOPT_SSL_VERIFYPEER</parameter>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_SSL_VERIFYPEER</parameter>: Passe um número long
- que é zero para parar o CURL de verificar o certificado do peer
- (curl 7.10 começõu a definir esta opção para &true; por padrão).
- Certificados alternativos para serem verificados podem ser especificados com a opção
- <parameter>CURLOPT_CAINFO</parameter> (adicionada no curl 7.9.8)
- ou um diretório com certificado pode ser especificado com a opção <parameter>
- CURLOPT_CAPATH</parameter>. A partir do curl 7.10, curl instala
- um padrão. <parameter>CURLOPT_SSL_VERIFYHOST</parameter> deve
- também ser definido para 1 ou 0 se <parameter>CURLOPT_SSL_VERIFYPEER
- </parameter> estiver desabilitado (o padrão é 2).
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_SSLVERSION</parameter>: Passe um long como
- parâmetro que contém a versão SSL (2 ou 3) a ser usada. Por
- padrão o PHP tentará determinar isto por sí mesmo, entretanto,
- em alguns casos você terá que definir isto manualmente.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_SSL_VERIFYHOST</parameter>: Passe um long se o
- CURL deve verificar o nome comum do certificado do peer ao estabelacer
- a conexão SSL. Um valor 1 indica que deve conferir a existencia do nome
- comum, um valor 2 indica que deve ter certeza
- que é o mesmo no servidor indicado.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_TIMECONDITION</parameter>: Passe um long como
- parâmetro para definir como
- <parameter>CURLOPT_TIMEVALUE</parameter> será tratado.
- Você pode definir este parâmetro para TIMECOND_IFMODSINCE ou
- TIMECOND_ISUNMODSINCE. Isto funciona apenas com HTTP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_TIMEVALUE</parameter>: Passe um long como
- parâmetro que é o tempo desde 1º de Janeiro de 1970.
- O tempo será usado como especificado na opção
- <parameter>CURLOPT_TIMECONDITION</parameter>,
- ou por padrão será usado o TIMECOND_IFMODSINCE.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_RETURNTRANSFER</parameter>: Passe um valor
- diferente de zero se você quer que o CURL retorne diretamente a transferencia
- ao invés de mostra-la diretamente.
- </simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- O parâmetro <parameter>value</parameter> deve ser uma string para os seguintes
- valores do parâmetro
- <parameter>option</parameter>:
- <itemizedlist>
- <listitem>
- <simpara>
- <parameter>CURLOPT_URL</parameter>: Esta é a URL que você quer
- que o PHP obtenha. Você pode definir esta opção também
- quando estiver inicializando a sessão com a função
- <function>curl_init</function>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_USERPWD</parameter>: Passe uma string
- formatada da maneira [usuário]:[senha], Para o PHP
- usar para a conexão.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_PROXYUSERPWD</parameter>: Passe uma string
- formatada da maneira [usuário]:[senha] para a conexão
- com o proxy HTTP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_RANGE</parameter>: Passe o intervalo especificado
- que você quer. Deve estar no formato "X-Y", aonde X ou Y podem
- ser deixados. Transferencia HTTP também suportam vários
- intervalos, separados com vírgulas como em X-Y,N-M.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_POSTFIELDS</parameter>: Passe uma string
- contendo os dados completos para passar em um operação HTTP "POST".
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_REFERER</parameter>: Passe uma string
- contendo um cabeçalho "referer" para ser usado na requisição HTTP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_USERAGENT</parameter>: Passe uma string
- contendo o cabeçalho "user-agent" para ser usado na requisição
- HTTP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_FTPPORT</parameter>: Passe uma string
- contendo o valor que será usado para obter o endereço IP para
- usar para a instrução ftp "POST". A instrução POST diz
- para o servidor remoto conectar com o nosso endereço IP especificado. A
- string pode ser um endereço IP por extenso, um nome de servidor, um nome
- de interface de rede (sob o Unix), ou apenas um "-" para usar o
- endereço IP padrão do sistema.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_COOKIE</parameter>: Passe uma string
- com o conteúdo do cookie para ser enviado no
- cabeçalho HTTP.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_SSLCERT</parameter>: Passe uma string
- contendo o nome do arquivo do PEM formatted certificate.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_SSLCERTPASSWD</parameter>: Passe uma string
- contendo a senha necessária para usar com o certificado
- <parameter>CURLOPT_SSLCERT</parameter>.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_COOKIEFILE</parameter>: Passe uma string
- o nome do arquivo que contém os dados do cookie.
- O arquivo de cookie pode ser no formato do Netscape ou apenas
- cabeçalhos no estilo HTTP escritos em um arquivo.
- </simpara>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_CUSTOMREQUEST</parameter>: Passe um string
- para ser usada ao invés de <literal>GET</literal> ou
- <literal>HEAD</literal> quando estiver fazendo uma requisição HTTP.
- isto é util para fazer <literal>DELETE</literal> ou outra, mais
- obscura, solicitação HTTP. Valores válidos são coisas como
- <literal>GET</literal>, <literal>POST</literal>, e assim por diante;
- ex. não entre com a requisão HTTP completa. Por exemplo,
- entrando com 'GET /index.html HTTP/1.0\r\n\r\n' estará incorreto.
- <note>
- <simpara>
- Não faça isso sem ter certeza que o seu servidor
- suporta o comando primeiro.
- </simpara>
- </note>
- </para>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_PROXY</parameter>: Dê o nome do proxy HTTP
- para usar de tunel para as requisições atravessarem.
- </para>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_INTERFACE</parameter>: Passe o nome da interface
- de rede de saída para usar. Isso pode ser um nome de interface,
- um endereço IP ou um nome de servidor.
- </para>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_KRB4LEVEL</parameter>: Passe o KRB4 (Kerberos
- 4) nível de segurança. Qualquer um dos seguintes valores (em
- ordem do menos para o mais poderoso) são válidos: 'clear', 'safe',
- 'confidential', 'private'. Se a string não for nenhum
- destes, então será usado o 'private'. Definir esta opção como
- <literal>NULL</literal>, irá desabilitar a segurança KRB4. Atualmente
- a segurança KRB4 funciona apenas com transações FTP.
- </para>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_HTTPHEADER</parameter>: Passe uma matriz de cabeçalhos
- HTTP para definir.
- </para>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_QUOTE</parameter>: Passe uma matriz de comandos FTP
- para executar no servidor FTP antes da requisição FTP.
- </para>
- </listitem>
- <listitem>
- <para>
- <parameter>CURLOPT_POSTQUOTE</parameter>: Passe uma matriz de comandos FTP,
- para executar no servidor, após a requisição
- FTP ter sido executada.
- </para>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- As seguintes funções esperam um descritor de arquivo que é obtido
- usando a função <function>fopen</function>:
- <itemizedlist>
- <listitem>
- <simpara>
- <parameter>CURLOPT_FILE</parameter>: O arquivo onde colocar a saída
- da sua transferencia, o padrão é STDOUT.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_INFILE</parameter>: O arquivo da onde
- vem a sua transferencia.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_WRITEHEADER</parameter>: O arquivo para onde
- escrever a parte do cabeçalho da saída.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- <parameter>CURLOPT_STDERR</parameter>: O arquivo para
- onde escrever os erro ao invés de stderr.
- </simpara>
- </listitem>
- </itemizedlist>
- <example>
- <title>
- Começando uma sessão CURL e obtendo uma página
- </title>
- <programlisting role="php">
+<!-- EN-Revision: 1.30 Maintainer: fernandoc Status: ready -->
+<refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>curl_setopt</refname>
+ <refpurpose>Define uma opção para a transferencia cURL</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>curl_setopt</methodname>
+ <methodparam><type>resource</type><parameter>ch</parameter></methodparam>
+ <methodparam><type>int</type><parameter>option</parameter></methodparam>
+ <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Define uma opção para o manipulador de sessão cURL indicado.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ &curl.ch.description;
+ <varlistentry>
+ <term><parameter>option</parameter></term>
+ <listitem>
+ <para>
+ A <literal>CURLOPT_XXX</literal> opção a definir.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>value</parameter></term>
+ <listitem>
+ <para>
+ O valor a ser definido em <parameter>option</parameter>.
+ </para>
+ <para>
+ <parameter>value</parameter> deve ser um booleano para os
+ seguintes valores do parâmetro <parameter>option</parameter>:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Opção</entry>
+ <entry>Definir <parameter>value</parameter> para</entry>
+ <entry>Notas</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>CURLOPT_AUTOREFERER</constant></entry>
+ <entry>
+ &true; para definir automaticamente um campo <literal>Referer:</literal>
+ nas requisições aonde ele segue um redirecionamento <literal>Location:</literal>.
+ </entry>
+ <entry>
+ Disponível desde PHP 5.1.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_BINARYTRANSFER</constant></entry>
+ <entry>
+ &true; para retornar a saída crua quando
+ <constant>CURLOPT_RETURNTRANSFER</constant> é usado.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_COOKIESESSION</constant></entry>
+ <entry>
+ &true; para marcar este como um novo cookie de sessão. Ela irá forçar a libcurl
+ a ignorar todos os cookies que esteja a ponto de carregar que sejam "cookies de sessão"
+ da sessão anterior. Por padrão, libcurl sempre salva e carrega
+ todos os cookies, independente se sejam cookies de sessão ou não.
+ Cookies de sessão são cookies sem data de expiração o que significa que
+ devem estar vivos e existir apenas para essa sesão apenas.
+ </entry>
+ <entry>
+ Disponível desde PHP 5.1.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_CRLF</constant></entry>
+ <entry>
+ &true; para converter finais de linha Unix para finais de linha CRLF
+ nas transferencias.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_DNS_USE_GLOBAL_CACHE</constant></entry>
+ <entry>
+ &true; para usar um cache de DNS global. Esta opção não é
+ thread-safe e esta ativada por padrão.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FAILONERROR</constant></entry>
+ <entry>
+ &true; para falhar silenciosamente se o codigo HTTP retornado for
+ maior ou igual a 400. O funcionamento padrão é retornar a pagina
+ normalmente, ignorando o codigo.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FILETIME</constant></entry>
+ <entry>
+ &true; para tentar obter a data de modificação do documento remoto.
+ Este valor pode ser obtido usando a opção
+ <parameter>CURLINFO_FILETIME</parameter> com
+ <function>curl_getinfo</function>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FOLLOWLOCATION</constant></entry>
+ <entry>
+ &true; para seguir qualquer cabeçalho
+ <literal>"Location: "</literal> que o servidor envie como parte
+ do cabeçalho HTTP (note que isto é recursivo, PHP irá seguir tantos
+ cabeçalhos <literal>"Location: "</literal> quantos sejam enviados,
+ a menos que <constant>CURLOPT_MAXREDIRS</constant> seja definido).
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FORBID_REUSE</constant></entry>
+ <entry>
+ &true; para forçar a conexão ser fechada explicitamente
+ quando o processamento seja terminado, e não ser guardada para reuso.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FRESH_CONNECT</constant></entry>
+ <entry>
+ &true; para forçar o uso de uma nova conexão
+ ao invés de uma guardada em cache.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTP_USE_EPRT</constant></entry>
+ <entry>
+ &true; para usar EPRT (e LPRT) ao fazer downloads
+ FTP ativos. Use &false; para desabilitar EPRT e LPRT e usar apenas
+ PORT.
+ </entry>
+ <entry>
+ Adicionado no PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTP_USE_EPSV</constant></entry>
+ <entry>
+ &true; para tentar primeiro um comando EPSV pára transferencias
+ FTP antes de reverter de volta para PASV. Defina como &false;
+ para desabilitar EPSV.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTPAPPEND</constant></entry>
+ <entry>
+ &true; para adicionar ao arquivo remoto ao invés de
+ sobrescreve-lo.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTPASCII</constant></entry>
+ <entry>
+ um apelido para
+ <constant>CURLOPT_TRANSFERTEXT</constant>. Use aquela ao invés.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTPLISTONLY</constant></entry>
+ <entry>
+ &true; para listar apenas os nomes de um
+ diretório FTP.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_HEADER</constant></entry>
+ <entry>
+ &true; para incluir o cabeçalho na saída.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_HTTPGET</constant></entry>
+ <entry>
+ &true; para redefinir o metodo de solicitação HTTP para GET.
+ já que GET é o padrão, isto apenas é necessário se o metodo de solicitação
+ foi modificado.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_HTTPPROXYTUNNEL</constant></entry>
+ <entry>
+ &true; para fazer tunel através de um servidor HTTP proxy indicado.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_MUTE</constant></entry>
+ <entry>
+ &true; para ser compeltamente silencioso no que diz
+ respeito as funções cURL.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_NETRC</constant></entry>
+ <entry>
+ &true; to scan the <filename>~/.netrc</filename>
+ file to find a username and password for the remote site that
+ a connection is being established with.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_NOBODY</constant></entry>
+ <entry>
+ &true; to exclude the body from the output.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_NOPROGRESS</constant></entry>
+ <entry><para>
+ &true; para desabilitar o medidor de progresso para as transferencias cURL.
+ <note>
+ <para>
+ PHP automaticamente define essa opção como &true;, isto deve ser modificado
+ apenas para fins de debug.
+ </para>
+ </note>
+ </para></entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_NOSIGNAL</constant></entry>
+ <entry>
+ &true; para ignorar qualquer função cURL que faça com que um sinal seja enviado
+ para o processo PHP. Isto é ativado por padrão em
+ servidores multi-tarefa assim opções de limite de tempo ainda podem ser usadas.
+ </entry>
+ <entry>
+ Adicionado no cURL 7.10 e PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_POST</constant></entry>
+ <entry>
+ &true; para fazer um HTTP POST normal. Este POST é do
+ tipo normal <literal>application/x-www-form-urlencoded</literal>,
+ mais comunmente usado pelos formulários HTML.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PUT</constant></entry>
+ <entry>
+ &true; para enviar um arquivo usando HTTP PUT. O arquivo a enviar deve
+ estar definido com <constant>CURLOPT_INFILE</constant> e
+ <constant>CURLOPT_INFILESIZE</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_RETURNTRANSFER</constant></entry>
+ <entry>
+ &true; para retornar a transferencia como uma string de
+ valor de retorno de <function>curl_exec</function> ao invés de
+ enviar diretamente para a saída.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSL_VERIFYPEER</constant></entry>
+ <entry>
+ &false; para fazer o cURL parar de verificar o certificado
+ do cliente. Certificados alternativos para verificar podem ser definidos
+ com a opção <constant>CURLOPT_CAINFO</constant>
+ ou um diretório de certificados pode ser definido com a opção
+ <constant>CURLOPT_CAPATH</constant>.
+ <constant>CURLOPT_SSL_VERIFYHOST</constant> também precisa ser definido como
+ &true; ou &false; se
+ <constant>CURLOPT_SSL_VERIFYPEER</constant> esta desabilitado (o
+ padrão é 2).
+ </entry>
+ <entry>
+ &true; por padrão a partir do cURL 7.10. Instalado por padrão a partir do
+ cURL 7.10.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_TRANSFERTEXT</constant></entry>
+ <entry>
+ &true; para usar o modo ASCII para transferencias FTP.
+ Para LDAP, ele obtem os datos em texto simples ao invés de HTML. Em
+ Sistemas Windows, ele não irá definir <literal>STDOUT</literal>
+ para o modo binário.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_UNRESTRICTED_AUTH</constant></entry>
+ <entry>
+ &true; para continuar enviando o nome de usuário e senha
+ ao seguir localizações (usando
+ <constant>CURLOPT_FOLLOWLOCATION</constant>), mesmo que o nome do
+ servidor tenha mudado.
+ </entry>
+ <entry>
+ Adicionado no PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_UPLOAD</constant></entry>
+ <entry>
+ &true; para preparar para o envio de um arquivo.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_VERBOSE</constant></entry>
+ <entry>
+ &true; para enviar muita informação para a saída. Escreve a saída
+ para <literal>STDERR</literal>, ou para o arquivo especificado usando
+ <constant>CURLOPT_STDERR</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ <parameter>value</parameter> deve ser um inteiro para os seguintes
+ valores do parâmetro <parameter>option</parameter>:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Opção</entry>
+ <entry>Definir <parameter>value</parameter> como</entry>
+ <entry>Notas</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>CURLOPT_BUFFERSIZE</constant></entry>
+ <entry>
+ O tamanho do buffer a usar em cada lida. Não há garantia de que este
+ pedido será cumprido, entretando.
+ </entry>
+ <entry>
+ Adicionado no cURL 7.10 e PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_CLOSEPOLICY</constant></entry>
+ <entry>
+ Ou
+ <parameter>CURLCLOSEPOLICY_LEAST_RECENTLY_USED</parameter> ou
+ <parameter>CURLCLOSEPOLICY_OLDEST</parameter>.
+ Existem ainda três outras constantes <literal>CURLCLOSEPOLICY_</literal>,
+ mas cURL ainda não as suporta.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_CONNECTTIMEOUT</constant></entry>
+ <entry>
+ O número de segundos para esperar ao tentar se conectar. Use 0
+ para esperar infinitamente.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_DNS_CACHE_TIMEOUT</constant></entry>
+ <entry>
+ O número de segundos para manter entradas DNS na memória. Esta
+ opção é definida para 120 (2 minutos) por padrão.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTPSSLAUTH</constant></entry>
+ <entry>
+ O método de autenticação FTP (quando é ativado):
+ <literal>CURLFTPAUTH_SSL</literal> (tentar SSL primeiro),
+ <literal>CURLFTPAUTH_TLS</literal> (tentar TLS primeiro), ou
+ <literal>CURLFTPAUTH_DEFAULT</literal> (deixar cURL decidir).
+ </entry>
+ <entry>
+ Adicionado no cURL 7.12.2 e PHP 5.1.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_HTTP_VERSION</constant></entry>
+ <entry>
+ <parameter>CURL_HTTP_VERSION_NONE</parameter> (padrão, deixa o CURL
+ decidir qual versão usar),
+ <parameter>CURL_HTTP_VERSION_1_0</parameter> (força HTTP/1.0),
+ ou <parameter>CURL_HTTP_VERSION_1_1</parameter> (força HTTP/1.1).
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_HTTPAUTH</constant></entry>
+ <entry>
+ <para>
+ O metodo de autenticação HTTP a usar. As opções são:
+ <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>
+ O operador de bits <literal>|</literal> (ou) pode ser usado para combinar mais de
+ um metodo. Se isso for feito, o cURL irá conversar com o servidor e ver quais métodos
+ ele suporta e escolher o melhor.
+ </para>
+ <para>
+ <parameter>CURLAUTH_ANY</parameter> é um apelido para
+ <literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
+ </para>
+ <para>
+ <parameter>CURLAUTH_ANYSAFE</parameter> é um apelido para
+ <literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
+ </para>
+ </entry>
+ <entry>
+ Adicionado no PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_INFILESIZE</constant></entry>
+ <entry>
+ O tamanho experado, em bytes, do arquivo ao enviar um arquivo
+ para um local remoto.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_LOW_SPEED_LIMIT</constant></entry>
+ <entry>
+ A velocidade de transferencia, em bytes por segundos, a qual a transferência deve estar
+ abaixo durante de <constant>CURLOPT_LOW_SPEED_TIME</constant> segundos
+ para o PHP considerar a transferência muito lenta e abortar.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_LOW_SPEED_TIME</constant></entry>
+ <entry>
+ O número de segundos que a transferência deve estar abaixo de
+ <constant>CURLOPT_LOW_SPEED_LIMIT</constant> para o PHP considerar a
+ transferência lenta de mais e abortar.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_MAXCONNECTS</constant></entry>
+ <entry>
+ O número máximo de conexões persistentes que são permitidas.
+ Quando o limite é atingido,
+ <constant>CURLOPT_CLOSEPOLICY</constant> é usado para determinar qual
+ conexão deve ser fechada.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_MAXREDIRS</constant></entry>
+ <entry>
+ O número máximo de redirecionamentos HTTP a seguir. Use esta opção
+ em conjunto com <constant>CURLOPT_FOLLOWLOCATION</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PORT</constant></entry>
+ <entry>
+ Um número alternativo de porta para conectar.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PROXYAUTH</constant></entry>
+ <entry>
+ Os métodos HTTP de autenticação usados para conectar ao servidor proxy.
+ Use as mesmas mascaras de bits descritas em
+ <constant>CURLOPT_HTTPAUTH</constant>. Para autenticação com o proxy,
+ apenas <parameter>CURLAUTH_BASIC</parameter> e
+ <parameter>CURLAUTH_NTLM</parameter> são suportados atualmente.
+ </entry>
+ <entry>
+ Adicionado em cURL 7.10.7 e PHP 5.1.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PROXYPORT</constant></entry>
+ <entry>
+ O número de porta para conectar ao proxy. Este número de porta
+ também pode ser definido em <constant>CURLOPT_PROXY</constant>.
+ </entry>
+ <entry>
+ Adicionado no PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PROXYTYPE</constant></entry>
+ <entry>
+ Ou <parameter>CURLPROXY_HTTP</parameter> (padrão) ou
+ <parameter>CURLPROXY_SOCKS5</parameter>.
+ </entry>
+ <entry>
+ Adicionado no cURL 7.10 e PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_RESUME_FROM</constant></entry>
+ <entry>
+ O índice, em bytes, a partir do qual continuar a transferencia.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSL_VERIFYHOST</constant></entry>
+ <entry>
+ 1 para conferir a existencia do nome comum no
+ certificado SSL do cliente. 2 para conferir a existencia de um nome comum
+ e também conferir se combina com o nome de servidor
+ dado.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLVERSION</constant></entry>
+ <entry>
+ A versão SSL (2 ou 3) a ser usada. por padrão o PHP tentará determinar isso
+ por sí mesmo, entretando em alguns casos deve ser definido manualmente.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_TIMECONDITION</constant></entry>
+ <entry>
+ Como <constant>CURLOPT_TIMEVALUE</constant> é tratado.
+ Use <parameter>CURL_TIMECOND_IFMODSINCE</parameter> para retornar apagina
+ apenas se foi modificada desde o tempo especificado em
+ <constant>CURLOPT_TIMEVALUE</constant>. Se não foi modificada um
+ cabeçalho <literal>"304 Not Modified"</literal> assumindo que
+ <constant>CURLOPT_HEADER</constant> seja &true;.
+ Use <parameter>CURL_TIMECOND_ISUNMODSINCE</parameter> para o efeito
+ reverso. <parameter>CURL_TIMECOND_IFMODSINCE</parameter> é o
+ padrão.
+ </entry>
+ <entry>
+ Adicionado no PHP 5.1.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_TIMEOUT</constant></entry>
+ <entry>
+ O número máximo de segundos que uma função cURL pode executar.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_TIMEVALUE</constant></entry>
+ <entry>
+ O tempo em segundos desde 1º de Janeiro de 1970. O tempo será
+ usado por <constant>CURLOPT_TIMECONDITION</constant>. Por padrão,
+ <parameter>CURL_TIMECOND_IFMODSINCE</parameter> é usado.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ <parameter>value</parameter> deve ser uma string para os
+ seguintes valores do parâmetro <parameter>option</parameter>:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Opção</entry>
+ <entry>Definir o <parameter>value</parameter> para</entry>
+ <entry>Notas</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>CURLOPT_CAINFO</constant></entry>
+ <entry>
+ O nome do arquivo contendo um ou mais certidicados para verificar o
+ peer. Esta opção apenas tem sentido em conjunto com
+ <constant>CURLOPT_SSL_VERIFYPEER</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_CAPATH</constant></entry>
+ <entry>
+ Um diretório que contem vários certificados CA. Use este opção
+ em conjunto com <constant>CURLOPT_SSL_VERIFYPEER</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_COOKIE</constant></entry>
+ <entry>
+ O conteúdo do cabeçalho <literal>"Set-Cookie: "</literal> a ser utilizado
+ na requisição HTTP.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_COOKIEFILE</constant></entry>
+ <entry>
+ O nome do arquivo contendo os dados de cookie. O arquivo de cookie
+ pode estar no formato Netscape, ou apenas no estilo de cabeçalhos HTTP
+ salvos em um arquivo.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_COOKIEJAR</constant></entry>
+ <entry>
+ O nome do arquivo para salvar todos os cookies internos quando
+ a conexão fechar.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_CUSTOMREQUEST</constant></entry>
+ <entry><para>
+ Um método de solicitação personalizado para usar ao invés de
+ <literal>"GET"</literal> ou <literal>"HEAD"</literal> ao fazer
+ uma solicitação HTTP. Isto é útil para fazer
+ <literal>"DELETE"</literal> ou outras solicitações HTTP mais obscuras.
+ Valores válidos são coisas como <literal>"GET"</literal>,
+ <literal>"POST"</literal>, <literal>"CONNECT"</literal> e assim por diante; i.e. Do not enter a whole HTTP request line here. For instance,
+ entrar <literal>"GET /index.html HTTP/1.0\r\n\r\n"</literal>
+ estaria errado.
+ <note>
+ <para>
+ Não faça isto sem ter certesa que o servidor suporte a requisição
+ personaçlizada primeiro.
+ </para>
+ </note>
+ </para></entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_EGDSOCKET</constant></entry>
+ <entry>
+ Como <constant>CURLOPT_RANDOM_FILE</constant>, exceto um nome de
+ arquivo para um Entropy Gathering Daemon socket.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_ENCODING</constant></entry>
+ <entry>
+ O conteúdo do cabeçalho <literal>"Accept-Encoding: "</literal>.
+ Isto ativa a decodificação da resposta. codificações suportadas são
+ <literal>"identity"</literal>, <literal>"deflate"</literal>, e
+ <literal>"gzip"</literal>. Se for definida uma string vazia, <literal>""</literal>,
+ um cabeçalho contendo todos os tipos de codificações suportados é enviado.
+ </entry>
+ <entry>
+ Adicionado no cURL 7.10.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_FTPPORT</constant></entry>
+ <entry>
+ O valor o qual vai ser usado para ter o endereço IP
+ para usar com a instrução FTP "POST". A instrução "POST" diz ao
+ servidor remoto conectar com o seu endereço IP especificado.
+ A string deve ser um endereço IP simples, um nome de servidor, um
+ nome de interface de rede (sob o Unix), ou apenas um simples "-" para usar
+ o endereço IP padrão do sistema.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_INTERFACE</constant></entry>
+ <entry>
+ O nome da interface de rede de saída a usar. Isto pode ser um nome
+ de interface, um endereço IP ou um nome de servidor.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_KRB4LEVEL</constant></entry>
+ <entry>
+ O nível de segurança KRB4 (Kerberos 4). Qualquer un dos seguintes valores
+ (em ordem do menos ao mais poderoso) são válidos:
+ <literal>"clear"</literal>,
+ <literal>"safe"</literal>,
+ <literal>"confidential"</literal>,
+ <literal>"private".</literal>.
+ Se a string não combinar com um destes,
+ <literal>"private"</literal> é usado. Definir esta opção como &null;
+ irá desabilitar a segurança KRB4. Atualmente a segurança KRB4 funciona apenas
+ com transações FTP.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_POSTFIELDS</constant></entry>
+ <entry>
+ Todos os dados para enviar em uma operação HTTP "POST".
+ Para enviar um arquivo, adicione antes do nome do arquivo um <literal>@</literal>
+ e use o caminho completo.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PROXY</constant></entry>
+ <entry>
+ O servidor HTTP proxy pelo qual passar as requisições.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PROXYUSERPWD</constant></entry>
+ <entry>
+ Um nome de usuário e senha formatados como
+ <literal>"[username]:[password]"</literal> para usar na conexão
+ com o proxy.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_RANDOM_FILE</constant></entry>
+ <entry>
+ Um nome de arquivo para ser usado como semente para o gerador de números aleatórios para SSL.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_RANGE</constant></entry>
+ <entry>
+ Intervalo(s) de data para obter no formato
+ <literal>"X-Y"</literal> aonde X ou Y é opcional. Transferencias HTTP
+ também suportam vários intervalos, separados por vírgulas no formato
+ <literal>"X-Y,N-M"</literal>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_REFERER</constant></entry>
+ <entry>
+ O conteúdo do cabeçalho <literal>"Referer: "</literal> a ser usado em uma
+ solicitação HTTP.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSL_CIPHER_LIST</constant></entry>
+ <entry>
+ Uma lista de ciphers para usar com SSL. Por exemplo,
+ <literal>RC4-SHA</literal> e <literal>TLSv1</literal> são listas
+ cipher validas.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLCERT</constant></entry>
+ <entry>
+ O nome de um arquivo contendo um certificado formatado PEM.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLCERTPASSWD</constant></entry>
+ <entry>
+ A senha necessária para usar o certificado
+ <constant>CURLOPT_SSLCERT</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLCERTTYPE</constant></entry>
+ <entry>
+ O formato do certificado. Formatos suportados são
+ <literal>"PEM"</literal> (default), <literal>"DER"</literal>,
+ e <literal>"ENG"</literal>.
+ </entry>
+ <entry>
+ Adicionado no cURL 7.9.3 e PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLENGINE</constant></entry>
+ <entry>
+ O identificador para o motor de criptografia da chave SSL privada
+ especificada em <constant>CURLOPT_SSLKEY</constant>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLENGINE_DEFAULT</constant></entry>
+ <entry>
+ O identificador para o motor de criptografia usado para
+ para operações assimétricas.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLKEY</constant></entry>
+ <entry>
+ O nome de um arquivo contendo uma chave SSL privada.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLKEYPASSWD</constant></entry>
+ <entry><para>
+ A senha secreta necessária para usar a chave privada SSL especificada em <constant>CURLOPT_SSLKEY</constant>.
+ <note>
+ <para>
+ Já que esta opção contem uma senha sensível, lembre-se de manter
+ o script PHP que a contem em segurança.
+ </para>
+ </note>
+ </para></entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_SSLKEYTYPE</constant></entry>
+ <entry>
+ O tipo de chave para a chave SSL privada especificada em
+ <constant>CURLOPT_SSLKEY</constant>. Tipos de chaves suportados são
+ <literal>"PEM"</literal> (default), <literal>"DER"</literal>,
+ and <literal>"ENG"</literal>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_URL</constant></entry>
+ <entry>
+ A URL para obter. isto também pode ser definido ao inicializar
+ a sessão com <function>curl_init</function>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_USERAGENT</constant></entry>
+ <entry>
+ O conteúdo do cabeçalho <literal>"User-Agent: "</literal> a ser
+ usado na solicitação HTTP.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_USERPWD</constant></entry>
+ <entry>
+ Um nome de usuário e senha formatado como
+ <literal>"[username]:[password]"</literal> para usar
+ para a conexão.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ <parameter>value</parameter> deve ser uma matriz para os
+ seguintes valores do parâmetro <parameter>option</parameter>:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Opção</entry>
+ <entry>Definir <parameter>value</parameter> como</entry>
+ <entry>Notas</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>CURLOPT_HTTP200ALIASES</constant></entry>
+ <entry>
+ Um array de respostas HTTP 200 que serão tratadas como respostas válidas
+ e não como erros.
+ </entry>
+ <entry>
+ Adicionado no cURL 7.10.3 e PHP 5.0.0.
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_HTTPHEADER</constant></entry>
+ <entry>
+ Um array de cabeçalhos HTTP a definir.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_POSTQUOTE</constant></entry>
+ <entry>
+ Um array de comandos FTP a executar no servidor depois de a requisição FTP ter
+ sido realizada.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_QUOTE</constant></entry>
+ <entry>
+ Um array de comandos FTP a serem executados no servidor antes da
+ requesição.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ <parameter>value</parameter> deve ser um recurso stream (usando
+ <function>fopen</function>, por exemplo) para os seguintes valores do
+ parâmetro <parameter>option</parameter>:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Opção</entry>
+ <entry>Define <parameter>value</parameter> como</entry>
+ <entry>Notas</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>CURLOPT_FILE</constant></entry>
+ <entry>
+ O arquivo na qual a transferencia deve ser escrita. O padrão
+ é <literal>STDOUT</literal> (a janela do browser).
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_INFILE</constant></entry>
+ <entry>
+ O arquivo que deve ser lido ao se fazer um upload.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_STDERR</constant></entry>
+ <entry>
+ Um local alternativo para se escrever os erros ao invés de
+ <literal>STDERR</literal>.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_WRITEHEADER</constant></entry>
+ <entry>
+ O arquivo em que a parte do cabeçalho da transferencia é escrita.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ <parameter>value</parameter> dese ser uma string que seja o nome de uma função de callback
+ válida para os seguintes valores do parãmetro
+ <parameter>option</parameter>:
+ <informaltable>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Opção</entry>
+ <entry>Define <parameter>value</parameter> como</entry>
+ <entry>Notas</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><constant>CURLOPT_HEADERFUNCTION</constant></entry>
+ <entry>
+ O nome da função de callback aonde a função de callback tem
+ dois parâmetros. O primeiro é o recurso cURL, o segundo é uma
+ string com os ados a serem escritos. Os dados do cabeçalho devem ser
+ escritos usando esta função de callback. Retorna o número de
+ bytes escritos.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_PASSWDFUNCTION</constant></entry>
+ <entry>
+ O nome da função de callback aonde a função de callback tem
+ três parâmetros. O primeiro é o recurso cURL, o segundo é uma string contendo
+ uma string para o pronpt da senha, e o terceiro é
+ o limite de tamanho da senha. Retorna a string contendo a senha.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_READFUNCTION</constant></entry>
+ <entry>
+ O nome da função de callback aonde a função de callback tem
+ dois parâmetros. O primeiro é o recurso cURL, e so segundo é uma
+ string com os dados a serem lidos. Os dados devem ser lidos atráves dessa
+ função de callback. Retorna o número de bytes lidos. Retorne 0 para indicar
+ <literal>EOF</literal> (final do arquivo).
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ <row>
+ <entry><constant>CURLOPT_WRITEFUNCTION</constant></entry>
+ <entry>
+ O nome da função de callback aonde a função de callback tem
+ dois parâmetros. O primeiro é o recurso resource, e o segundo é a string com os
+ dados a serem escritos. Os dados devem ser escritos
+ usando essa função de callback. Deve retornar o número exato de bytes escritos
+ ou isto irá falhar.
+ </entry>
+ <entry>
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>inicializando uma nova sessão cURL e obtendo uma pagina da internet</title>
+ <programlisting role="php">
<![CDATA[
<?php
-// create a new curl resource
+// create a new cURL resource
$ch = curl_init();
// set URL and other appropriate options
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
-curl_setopt($ch, CURLOPT_HEADER, 0);
+curl_setopt($ch, CURLOPT_HEADER, false);
// grab URL and pass it to the browser
curl_exec($ch);
-// close curl resource, and free up system resources
+// close cURL resource, and free up system resources
curl_close($ch);
?>
]]>
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Enviando um arquivo</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+/* http://localhost/upload.php:
+print_r($_POST);
+print_r($_FILES);
+*/
+
+$ch = curl_init();
+
+$data = array('name' => 'Foo', 'file' => '@/home/user/test.png');
+
+curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');
+curl_setopt($ch, CURLOPT_POST, 1);
+curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
+
+curl_exec($ch);
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+Array
+(
+ [name] => Foo
+)
+Array
+(
+ [file] => Array
+ (
+ [name] => test.png
+ [type] => image/png
+ [tmp_name] => /tmp/phpcpjNeQ
+ [error] => 0
+ [size] => 279
+ )
+
+)
+
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>curl_setopt_array</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
| Navigate in group php.doc.pt-br at sever news.php.net | |
| Previous | Next |
| © No Copyright You are free to use Anything |
Site Maintained by PHP Developer
Powered By PHP Consultants |