curl_setopt
(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)
curl_setopt — Define uma opção para uma transferência cURL
Descrição
Define uma opção no identificador de sessão cURL fornecido.
Parâmetros
handle
Um manipulador cURL retornado por curl_init().
option
-
A opção
CURLOPT_*
a ser definida. value
-
O valor a ser definido na
option
.value
deve ser um bool para os seguintes valores do parâmetrooption
:Opção Definir value
paraNotas CURLOPT_AUTOREFERER
true
para definir automaticamente o campoReferer:
nas solicitações em que segue umLocation:
redirect.CURLOPT_COOKIESESSION
true
para marcar isso como uma nova "sessão" de cookie. Isso forçará o libcurl a ignorar todos os cookies que está prestes a carregar que são "cookies de sessão" da sessão anterior. Por padrão, libcurl sempre armazena e carrega todos os cookies, independente se são cookies de sessão ou não. Os cookies de sessão são cookies sem prazo de validade e devem estar ativos e existentes apenas para esta "sessão".CURLOPT_CERTINFO
true
para enviar informações de certificação SSL paraSTDERR
em transferências seguras.Adicionado no cURL 7.19.1. Requer que CURLOPT_VERBOSE
esteja ativado para ter efeito.CURLOPT_CONNECT_ONLY
true
diz à biblioteca para executar toda a autenticação de proxy necessária e configuração de conexão, mas nenhuma transferência de dados. Esta opção é implementada para HTTP, SMTP e POP3.Adicionado em 7.15.2. CURLOPT_CRLF
true
para converter novas linhas Unix em novas linhas CRLF em transferências.CURLOPT_DISALLOW_USERNAME_IN_URL
true
para não permitir URLs que incluam um nome de usuário. Os nomes de usuário são permitidos por padrão (0).Adicionado no cURL 7.61.0. Disponível desde o PHP 7.3.0. CURLOPT_DNS_SHUFFLE_ADDRESSES
true
para embaralhar a ordem de todos os endereços retornados para que sejam usados em uma ordem aleatória, quando um nome for resolvido e mais de um endereço IP for retornado. Isso pode fazer com que o IPv4 seja usado antes do IPv6 ou vice-versa.Adicionado no cURL 7.60.0. Disponível desde o PHP 7.3.0. CURLOPT_HAPROXYPROTOCOL
true
para enviar um cabeçalho do protocolo HAProxy PROXY v1 no início da conexão. A ação padrão é não enviar este cabeçalho.Adicionado no cURL 7.60.0. Disponível desde o PHP 7.3.0. CURLOPT_SSH_COMPRESSION
true
para ativar a compactação SSH integrada. Este é um pedido, não uma ordem; o servidor pode ou não fazê-lo.Adicionado no cURL 7.56.0. Disponível desde o PHP 7.3.0. CURLOPT_DNS_USE_GLOBAL_CACHE
true
para usar um cache DNS global. Esta opção não é thread-safe. Ele é ativado condicionalmente por padrão se o PHP for construído para uso não encadeado (CLI, FCGI, Apache2-Prefork, etc.).CURLOPT_FAILONERROR
true
para falhar detalhadamente se o código HTTP retornado for maior ou igual a 400. O comportamento padrão é retornar a página normalmente, ignorando o código.CURLOPT_SSL_FALSESTART
true
para habilitar início falso de TLS.Adicionado no cURL 7.42.0. Disponível desde o PHP 7.0.7. CURLOPT_FILETIME
true
para tentar recuperar a data de modificação do documento remoto. Esse valor pode ser recuperado usando a opçãoCURLINFO_FILETIME
com curl_getinfo().CURLOPT_FOLLOWLOCATION
true
para seguir qualquer cabeçalho"Location: "
que o servidor envia como parte do cabeçalho HTTP. Consulte tambémCURLOPT_MAXREDIRS
.CURLOPT_FORBID_REUSE
true
para forçar a conexão a fechar explicitamente quando terminar o processamento e não ser agrupada para reutilização.CURLOPT_FRESH_CONNECT
true
para forçar o uso de uma nova conexão em vez de uma em cache.CURLOPT_FTP_USE_EPRT
true
para usar EPRT (e LPRT) ao fazer downloads FTP ativos. Usefalse
para desabilitar EPRT e LPRT e use apenas PORT.CURLOPT_FTP_USE_EPSV
true
para tentar primeiro um comando EPSV para transferências FTP antes de reverter para PASV. Defina comofalse
para desativar o EPSV.CURLOPT_FTP_CREATE_MISSING_DIRS
true
para criar diretórios ausentes quando uma operação de FTP encontra um caminho que não existe no momento.CURLOPT_FTPAPPEND
true
para acrescentar ao arquivo remoto em vez de substituí-lo.CURLOPT_TCP_NODELAY
true
para desabilitar o algoritmo Nagle do TCP, que tenta minimizar o número de pequenos pacotes na rede.Disponível para versões compiladas com libcurl 7.11.2 ou superior. CURLOPT_FTPASCII
Um alias de CURLOPT_TRANSFERTEXT
. Use isso em vez disso.CURLOPT_FTPLISTONLY
true
para listar apenas os nomes de um diretório FTP.CURLOPT_HEADER
true
para incluir o cabeçalho na saída.CURLINFO_HEADER_OUT
true
para rastrear a string de solicitação do identificador.O prefixo CURLINFO_
é intencional.CURLOPT_HTTP09_ALLOWED
Informa respostas HTTP/0.9 são permitidas. O padrão é false
a partir de libcurl 7.66.0; anteriormente, o padrão eratrue
.Disponível desde o PHP 7.3.15 e 7.4.3, respectivamente, se construído em libcurl >= 7.64.0 CURLOPT_HTTPGET
true
para redefinir o método de solicitação HTTP para GET. Como GET é o padrão, isso só é necessário se o método de solicitação tiver sido alterado.CURLOPT_HTTPPROXYTUNNEL
true
para encapsular por meio de um determinado proxy HTTP.CURLOPT_HTTP_CONTENT_DECODING
false
para obter o corpo da resposta HTTP bruta.Disponível se construído em libcurl >= 7.16.2. CURLOPT_KEEP_SENDING_ON_ERROR
true
para continuar enviando o corpo da solicitação se o código HTTP retornado for igual ou maior que 300. A ação padrão seria interromper o envio e fechar o fluxo ou a conexão. Adequado para autenticação NTLM manual. A maioria dos aplicativos não precisa dessa opção.Disponível a partir do PHP 7.3.0 se construído em libcurl >= 7.51.0. CURLOPT_MUTE
true
para ser completamente silencioso em relação às funções cURL.Removida no cURL 7.15.5 (no lugar dela pode ser usada a constante CURLOPT_RETURNTRANSFER) CURLOPT_NETRC
true
para verificar o arquivo ~/.netrc para localizar um nome de usuário e senha para o site remoto com o qual uma conexão está sendo estabelecida.CURLOPT_NOBODY
true
para excluir o corpo da saída. O método de solicitação é definido como HEAD. Alterar isso parafalse
não o altera para GET.CURLOPT_NOPROGRESS
true
para desabilitar o medidor de progresso para transferências cURL.Note:
O PHP define automaticamente esta opção como
true
, isso só deve ser alterado para fins de depuração.CURLOPT_NOSIGNAL
true
para ignorar qualquer função cURL que faça com que um sinal seja enviado ao processo PHP. Isso é ativado por padrão em SAPIs multi-threaded para que as opções de tempo limite ainda possam ser usadas.Adicionado no cURL 7.10. CURLOPT_PATH_AS_IS
true
para não lidar com sequências de ponto e ponto.Adicionado no cURL 7.42.0. Disponível desde o PHP 7.0.7. CURLOPT_PIPEWAIT
true
para aguardar pipelining/multiplexing.Adicionado no cURL 7.42.0. Disponível desde o PHP 7.0.7. CURLOPT_POST
true
para fazer um POST HTTP regular. Este POST é o tipoapplication/x-www-form-urlencoded
normal, mais comumente usado por formulários HTML.CURLOPT_PUT
true
para HTTP PUT um arquivo. O arquivo para PUT deve ser configurado comCURLOPT_INFILE
eCURLOPT_INFILESIZE
.CURLOPT_RETURNTRANSFER
true
para retornar a transferência como uma string do valor de retorno de curl_exec() em vez de emiti-la diretamente.CURLOPT_SASL_IR
true
para habilitar o envio da resposta inicial no primeiro pacote.Adicionado no curl 7.31.10. Disponível desde o PHP 7.0.7. CURLOPT_SSL_ENABLE_ALPN
false
para desabilitar o ALPN no handshake SSL (se o backend SSL libcurl for construído para usá-lo), que pode ser usado para negociar http2.Adicionado no cURL 7.36.0. Disponível desde o PHP 7.0.7. CURLOPT_SSL_ENABLE_NPN
false
para desabilitar o NPN no handshake SSL (se o backend SSL libcurl for construído para usá-lo), que pode ser usado para negociar http2.Adicionado no cURL 7.36.0. Disponível desde o PHP 7.0.7. CURLOPT_SSL_VERIFYPEER
false
para impedir que o cURL verifique o certificado do par. Certificados alternativos para verificação podem ser especificados com a opçãoCURLOPT_CAINFO
ou um diretório de certificados pode ser especificado com a opçãoCURLOPT_CAPATH
.true
por padrão a partir do cURL 7.10. Pacote padrão instalado a partir do cURL 7.10.CURLOPT_SSL_VERIFYSTATUS
true
para verificar o status do certificado.Adicionado no cURL 7.41.0. Disponível desde o PHP 7.0.7. CURLOPT_PROXY_SSL_VERIFYPEER
false
para impedir que o cURL verifique o certificado do par. Certificados alternativos para verificação podem ser especificados com a opçãoCURLOPT_CAINFO
ou um diretório de certificados pode ser especificado com a opçãoCURLOPT_CAPATH
. Quando definido como falso, a verificação do certificado de mesmo nível é bem-sucedida.true
por padrão. Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0.CURLOPT_SAFE_UPLOAD
Sempre true
, o que desabilita o suporte para o prefixo@
para upload de arquivos emCURLOPT_POSTFIELDS
, o que significa que os valores que começam com@
podem ser passados com segurança como campos. CURLFile pode ser usado para uploads.CURLOPT_SUPPRESS_CONNECT_HEADERS
true
para suprimir os cabeçalhos de resposta CONNECT do proxy das funções de retorno do usuárioCURLOPT_HEADERFUNCTION
eCURLOPT_WRITEFUNCTION
, quandoCURLOPT_HTTPPROXYTUNNEL
é usado e uma solicitação CONNECT é feita.Adicionado no cURL 7.54.0. Disponível desde o PHP 7.3.0. CURLOPT_TCP_FASTOPEN
true
para habilitar TCP Fast Open.Adicionado no curl 7.49.0. Disponível desde o PHP 7.0.7. CURLOPT_TFTP_NO_OPTIONS
true
para não enviar solicitações de opções TFTP.Adicionado no cURL 7.48.0. Disponível desde o PHP 7.0.7. CURLOPT_TRANSFERTEXT
true
para usar o modo ASCII para transferências FTP. Para LDAP, ele recupera dados em texto simples em vez de HTML. Em sistemas Windows, ele não definiráSTDOUT
para o modo binário.CURLOPT_UNRESTRICTED_AUTH
true
para continuar enviando o nome de usuário e a senha ao seguir os locais (usandoCURLOPT_FOLLOWLOCATION
), mesmo quando o nome do host foi alterado.CURLOPT_UPLOAD
true
para se preparar para um upload.CURLOPT_VERBOSE
true
para gerar informações detalhadas. Grava a saída emSTDERR
ou no arquivo especificado usandoCURLOPT_STDERR
.value
deve ser um int para os seguintes valores do parâmetrooption
:Opção Definir value
paraNotas CURLOPT_BUFFERSIZE
O tamanho do buffer a ser usado para cada leitura. No entanto, não há garantia de que essa solicitação será atendida. Added in cURL 7.10. CURLOPT_CONNECTTIMEOUT
O número de segundos a aguardar durante a tentativa de conexão. Use 0 para esperar indefinidamente. CURLOPT_CONNECTTIMEOUT_MS
O número de milissegundos de espera durante a tentativa de conexão. Use 0 para esperar indefinidamente. Se libcurl for construído para usar o resolvedor de nome do sistema padrão, essa parte da conexão ainda usará a resolução de segundo completo para tempos limite com um tempo limite mínimo permitido de um segundo. Adicionado no cURL 7.16.2. CURLOPT_DNS_CACHE_TIMEOUT
O número de segundos para manter as entradas DNS na memória. Esta opção é definida como 120 (2 minutos) por padrão. CURLOPT_EXPECT_100_TIMEOUT_MS
O tempo limite para respostas de Expect: 100-continue
em milissegundos. O padrão é 1000 milissegundos.Adicionado no cURL 7.36.0. Disponível desde o PHP 7.0.7. CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
Avance para o ipv6 para o algoritmo de happy eyeballs. Happy eyeballs tenta se conectar a endereços IPv4 e IPv6 para hosts dual-stack, preferindo IPv6 primeiro para milissegundos de tempo limite. O padrão é CURL_HET_DEFAULT, que atualmente é de 200 milissegundos. Adicionado no curl 7.59.0. Disponível desde o PHP 7.3.0. CURLOPT_FTPSSLAUTH
O método de autenticação FTP (quando ativado): CURLFTPAUTH_SSL
(tenta SSL primeiro),CURLFTPAUTH_TLS
(tenta TLS primeiro) ouCURLFTPAUTH_DEFAULT
(deixa o cURL decidir).Adicionado no cURL 7.12.2. CURLOPT_HEADEROPT
Como lidar com cabeçalhos. Uma das seguintes constantes:
- CURLHEADER_UNIFIED
-
Os cabeçalhos especificados em
CURLOPT_HTTPHEADER
serão utilizados nas requisições tanto para servidores quanto para proxies. Com esta opção habilitada,CURLOPT_PROXYHEADER
não terá nenhum efeito. - CURLHEADER_SEPARATE
-
Faz com que os cabeçalhos
CURLOPT_HTTPHEADER
sejam enviados apenas a um servidor e não a um proxy. Os cabeçalhos de proxy precisam ser definidos comCURLOPT_PROXYHEADER
para serem usados. Observe que, se uma solicitação não-CONNECT for enviada a um proxy, libcurl enviará tanto cabeçalhos de servidor quanto de proxy. Ao fazer CONNECT, libcurl enviará cabeçalhosCURLOPT_PROXYHEADER
apenas para o proxy e, em seguida, cabeçalhosCURLOPT_HTTPHEADER
apenas para o servidor.
CURLHEADER_SEPARATE
a partir do cURL 7.42.1 eCURLHEADER_UNIFIED
antes dessa versão.Adicionado no cURL 7.37.0. Disponível desde o PHP 7.0.7. CURLOPT_HTTP_VERSION
CURL_HTTP_VERSION_NONE
(padrão, permite que CURL decida qual versão usar),CURL_HTTP_VERSION_1_0
(força HTTP/1.0),CURL_HTTP_VERSION_1_1
(força HTTP/1.1),CURL_HTTP_VERSION_2_0
(tenta HTTP 2),CURL_HTTP_VERSION_2
(alias deCURL_HTTP_VERSION_2_0
),CURL_HTTP_VERSION_2TLS
(somente tenta HTTP 2 sobre TLS (HTTPS)) ouCURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE
(emite solicitações HTTP não TLS usando HTTP/2 sem atualização HTTP/1.1).CURLOPT_HTTPAUTH
Os métodos de autenticação HTTP a serem usados. As opções são:
CURLAUTH_BASIC
,CURLAUTH_DIGEST
,CURLAUTH_GSSNEGOTIATE
,CURLAUTH_NTLM
,CURLAUTH_AWS_SIGV4
,CURLAUTH_ANY
eCURLAUTH_ANYSAFE
.O operador
|
(ou) pode ser usado para combinar mais de um método. Se isso for feito, o cURL pesquisará o servidor para ver quais métodos ele suporta e escolher o melhor.CURLAUTH_ANY
define todos os bits. cURL selecionará automaticamente aquele que encontrar mais seguro.CURLAUTH_ANYSAFE
define todos os bits, excetoCURLAUTH_BASIC
. cURL selecionará automaticamente o método que considerar mais seguro.CURLOPT_INFILESIZE
O tamanho esperado, em bytes, do arquivo ao fazer upload de um arquivo para um site remoto. Observe que usar esta opção não impedirá que libcurl envie mais dados, pois exatamente o que é enviado depende de CURLOPT_READFUNCTION
.CURLOPT_LOW_SPEED_LIMIT
A velocidade de transferência, em bytes por segundo, que a transferência deve estar abaixo durante a contagem de CURLOPT_LOW_SPEED_TIME
segundos antes do PHP considerar a transferência muito lenta e abortar.CURLOPT_LOW_SPEED_TIME
O número de segundos que a velocidade de transferência deve estar abaixo de CURLOPT_LOW_SPEED_LIMIT
antes que o PHP considere a transferência muito lenta e aborte.CURLOPT_MAIL_RCPT_ALLLOWFAILS
Permite que o comando RCPT TO falhe para alguns destinatários. Ao enviar dados para vários destinatários, por padrão, o cURL abortará a conversa SMTP se pelo menos um dos destinatários causar um erro ao comando RCPT TO. Esta opção instrui o cURL a ignorar erros e prosseguir com os destinatários válidos restantes. Se todos os destinatários acionarem falhas no RCPT TO e esta sinalização estiver configurada, o cURL abortará a conversa SMTP e retornará o erro recebido do último comando RCPT TO. CURLOPT_MAXAGE_CONN
O tempo máximo de inatividade permitido para que uma conexão existente seja considerada para reutilização. O padrão é definido como 118
segundos.CURLOPT_MAXFILESIZE_LARGE
O tamanho máximo do arquivo em bytes permitido para download. Se o arquivo solicitado for encontrado com um tamanho maior do que esse valor, a transferência não será iniciada e será retornado CURLE_FILESIZE_EXCEEDED
. O tamanho do arquivo nem sempre é conhecido antes do download, e para tais arquivos, esta opção não tem efeito, mesmo que a transferência do arquivo acabe sendo maior do que esse limite fornecido.CURLOPT_MAXLIFETIME_CONN
O tempo máximo em segundos, desde a criação da conexão, permitido para que uma conexão existente seja considerada para reutilização. Se for encontrada uma conexão em cache que seja mais antiga do que esse valor, ela será fechada assim que quaisquer transferências em andamento forem concluídas. O padrão é 0 segundos, o que significa que a opção está desativada e todas as conexões são elegíveis para reutilização. CURLOPT_MAXCONNECTS
A quantidade máxima de conexões persistentes permitidas. Quando o limite é atingido, o mais antigo do cache é fechado para evitar o aumento do número de conexões abertas. CURLOPT_MAXREDIRS
A quantidade máxima de redirecionamentos HTTP a seguir. Use esta opção juntamente com CURLOPT_FOLLOWLOCATION
. O valor padrão de20
é definido para evitar redirecionamentos infinitos. Definir como-1
permite redirecionamentos infinitos e0
recusa todos os redirecionamentos.CURLOPT_PORT
Um número de porta alternativo para se conectar. CURLOPT_POSTREDIR
Uma máscara de bits de 1 (301 movido permanentemente), 2 (302 encontrado) e 4 (303 consulte outro) se o método HTTP POST deve ser mantido quando CURLOPT_FOLLOWLOCATION
é definido e ocorre um tipo específico de redirecionamento.Adicionado no cURL 7.19.1. CURLOPT_PROTOCOLS
Máscara de bits de valores
CURLPROTO_*
. Se usado, esta máscara de bits limita quais protocolos libcurl pode usar na transferência. Isso permite que se tenha um libcurl construído para suportar uma ampla gama de protocolos, mas ainda limitar transferências específicas para poder usar apenas um subconjunto deles. Por padrão, o libcurl aceitará todos os protocolos que ele suporta. Consulte tambémCURLOPT_REDIR_PROTOCOLS
.As opções de protocolo válidas são:
CURLPROTO_HTTP
,CURLPROTO_HTTPS
,CURLPROTO_FTP
,CURLPROTO_FTPS
,CURLPROTO_SCP
,CURLPROTO_SFTP
,CURLPROTO_TELNET
,CURLPROTO_LDAP
,CURLPROTO_LDAPS
,CURLPROTO_DICT
,CURLPROTO_FILE
,CURLPROTO_TFTP
,CURLPROTO_MQTT
,CURLPROTO_ALL
Adicionado no cURL 7.19.4. CURLOPT_PROXYAUTH
Os métodos de autenticação HTTP a serem usados para a conexão proxy. Use as mesmas máscaras de bits descritas em CURLOPT_HTTPAUTH
. Para autenticação de proxy, apenasCURLAUTH_BASIC
eCURLAUTH_NTLM
são suportados atualmente.Adicionado no cURL 7.10.7. CURLOPT_PROXYPORT
O número da porta do proxy ao qual se conectar. Esse número de porta também pode ser definido em CURLOPT_PROXY
.CURLOPT_PROXYTYPE
CURLPROXY_HTTP
(padrão),CURLPROXY_SOCKS4
,CURLPROXY_SOCKS5
,CURLPROXY_SOCKS4A
ouCURLPROXY_SOCKS5_HOSTNAME
.Adicionado no cURL 7.10. CURLOPT_REDIR_PROTOCOLS
Máscara de bits de valores CURLPROTO_*
Se usado, esta máscara de bits limita quais protocolos libcurl pode usar em uma transferência que segue em um redirecionamento quandoCURLOPT_FOLLOWLOCATION
está ativado. Isso permite que transferências específicas sejam limitadas para usar apenas um subconjunto de protocolos em redirecionamentos. Por padrão, libcurl permitirá todos os protocolos, exceto FILE e SCP. Esta é uma diferença em relação às versões pré-7.19.4 que seguiriam incondicionalmente para todos os protocolos suportados. Consulte tambémCURLOPT_PROTOCOLS
para valores constantes de protocolo.Adicionado no cURL 7.19.4. CURLOPT_RESUME_FROM
O deslocamento, em bytes, do qual retomar uma transferência. CURLOPT_SOCKS5_AUTH
Os métodos de autenticação SOCKS5 a serem usados. As opções são:
CURLAUTH_BASIC
,CURLAUTH_GSSAPI
,CURLAUTH_NONE
.O operador
|
(ou) pode ser usado para combinar mais de um método. Se isso for feito, o cURL pesquisará o servidor para ver quais métodos ele suporta e escolher o melhor.CURLAUTH_BASIC
permite autenticação de nome de usuário/senha.CURLAUTH_GSSAPI
permite autenticação GSS-API.CURLAUTH_NONE
não permite autenticação.O padrão é
CURLAUTH_BASIC|CURLAUTH_GSSAPI
. Defina o nome de usuário e a senha reais com a opçãoCURLOPT_PROXYUSERPWD
.Disponível a partir de 7.3.0 e curl >= 7.55.0. CURLOPT_SSL_OPTIONS
Define as opções de comportamento SSL, que é uma máscara de bits de qualquer uma das seguintes constantes:
- CURLSSLOPT_ALLOW_BEAST
- Não tenta usar soluções alternativas para uma falha de segurança nos protocolos SSL3 e TLS1.0.
- CURLSSLOPT_NO_REVOKE
- Desabilita as verificações de revogação de certificado para os back-ends SSL em que tal comportamento está presente.
- CURLSSLOPT_AUTO_CLIENT_CERT
- Localiza e utiliza automaticamente um certificado de cliente para autenticação quando solicitado pelo servidor. Esta opção é suportada apenas para Schannel (a biblioteca SSL nativa do Windows).
- CURLSSLOPT_NATIVE_CA
-
Utiliza o armazenamento de CA nativo do sistema operacional para verificação de certificados.
Funciona apenas no Windows quando construído para usar o OpenSSL.
Note: Esta opção é experimental e seu comportamento está sujeito a modificações.
- CURLSSLOPT_NO_PARTIALCHAIN
- Não aceita cadeias de certificados "parciais", que o cURL, de outra forma, faz por padrão. Esta opção é suportada apenas para o OpenSSL e falhará na verificação do certificado se a cadeia terminar com um certificado intermediário e não com um certificado raiz.
- CURLSSLOPT_REVOKE_BEST_EFFORT
-
Ignora verificações de revogação de certificado no caso de pontos de
distribuição ausentes ou fora da rede para os backends SSL em que esse
comportamento está presente.
Esta opção é suportada apenas para Schannel
(a biblioteca SSL nativa do Windows).
Note: Se combinada com
CURLSSLOPT_NO_REVOKE
, esta última tem precedência.
Adicionado no cURL 7.25.0. Disponível desde o PHP 7.0.7. CURLOPT_SSL_VERIFYHOST
2
para verificar se um campo Nome comum ou um campo Nome alternativo do assunto no certificado de mesmo nível SSL corresponde ao nome de host fornecido.0
para não verificar os nomes.1
não deve ser usado. Em ambientes de produção o valor desta opção deve ser mantido em2
(valor padrão).Suporte para o valor 1
removido no cURL 7.28.1.CURLOPT_SSLVERSION
Uma das contantes
A versão máxima do TLS pode ser definida usando uma das constantesCURL_SSLVERSION_DEFAULT
,CURL_SSLVERSION_TLSv1
,CURL_SSLVERSION_SSLv2
,CURL_SSLVERSION_SSLv3
,CURL_SSLVERSION_TLSv1_0
,CURL_SSLVERSION_TLSv1_1
,CURL_SSLVERSION_TLSv1_2
,CURL_SSLVERSION_TLSv1_3
.CURL_SSLVERSION_MAX_*
.Também é possível fazer operação binária OR de uma das constantes
CURL_SSLVERSION_*
com uma das constantesCURL_SSLVERSION_MAX_*
.CURL_SSLVERSION_MAX_DEFAULT
(a versão máxima suportada pela biblioteca),CURL_SSLVERSION_MAX_TLSv1_0
,CURL_SSLVERSION_MAX_TLSv1_1
,CURL_SSLVERSION_MAX_TLSv1_2
,CURL_SSLVERSION_MAX_TLSv1_3
.WarningÉ melhor não definir esta opção e deixá-la no padrão. Defini-la como
CURL_SSLVERSION_SSLv2
orCURL_SSLVERSION_SSLv3
é muito perigoso devido às vulnerabilidades conhecidas em SSLv2 e SSLv3.CURLOPT_PROXY_SSL_OPTIONS
Define as opções de comportamento SSL do proxy, que é uma máscara de bits das seguintes constantes:
- CURLSSLOPT_ALLOW_BEAST
- Não tenta usar soluções alternativas para uma falha de segurança nos protocolos SSL3 e TLS1.0.
- CURLSSLOPT_NO_REVOKE
- Desabilita as verificações de revogação de certificado para os back-ends SSL onde tal comportamento está presente. (curl >= 7.44.0)
- CURLSSLOPT_NO_PARTIALCHAIN
- Não aceita cadeias de certificados "parciais", que de outra forma o curl faz por padrão. (curl >= 7.68.0)
Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSL_VERIFYHOST
Defina como 2
para verificar os campos de nome do certificado do proxy HTTPS em relação ao nome do proxy. Quando definido como0
, a conexão é bem-sucedida, independentemente dos nomes usados no certificado. Use essa habilidade com cuidado!1
tratado como uma opção de depuração no curl 7.28.0 e anteriores. De curl 7.28.1 a 7.65.3,CURLE_BAD_FUNCTION_ARGUMENT
é retornado. Do curl 7.66.0 em diante,1
e2
são tratados como o mesmo valor. Em ambientes de produção o valor desta opção deve ser mantido em2
(valor padrão).Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSLVERSION
Uma das constantes
CURL_SSLVERSION_DEFAULT
,CURL_SSLVERSION_TLSv1
,CURL_SSLVERSION_TLSv1_0
,CURL_SSLVERSION_TLSv1_1
,CURL_SSLVERSION_TLSv1_2
,CURL_SSLVERSION_TLSv1_3
,CURL_SSLVERSION_MAX_DEFAULT
,CURL_SSLVERSION_MAX_TLSv1_0
,CURL_SSLVERSION_MAX_TLSv1_1
,CURL_SSLVERSION_MAX_TLSv1_2
,CURL_SSLVERSION_MAX_TLSv1_3
,CURL_SSLVERSION_SSLv3
.WarningÉ melhor não definir esta opção e deixá-la no padrão
CURL_SSLVERSION_DEFAULT
que tentará descobrir a versão do protocolo SSL remoto.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_STREAM_WEIGHT
Define o peso numérico do fluxo (um número entre 1 e 256). Adicionado no cURL 7.46.0. Disponível desde o PHP 7.0.7. CURLOPT_TCP_KEEPALIVE
Se definido como 1
, as sondagens de manutenção de atividade do TCP serão enviadas. O atraso e a frequência dessas sondagens podem ser controlados pelas opçõesCURLOPT_TCP_KEEPIDLE
eCURLOPT_TCP_KEEPINTVL
, desde que o sistema operacional as suporte. Se definido como0
(padrão), os testes de manutenção de atividade são desativados.Adicionado no cURL 7.25.0. CURLOPT_TCP_KEEPIDLE
Define o tempo, em segundos, que o sistema operacional aguardará enquanto a conexão estiver ociosa antes de enviar testes de manutenção de atividade, se CURLOPT_TCP_KEEPALIVE
estiver ativado. Nem todos os sistemas operacionais oferecem suporte a essa opção. O padrão é60
.Adicionado no cURL 7.25.0. CURLOPT_TCP_KEEPINTVL
Define o intervalo, em segundos, que o sistema operacional aguardará entre o envio de análises de manutenção de atividade, se CURLOPT_TCP_KEEPALIVE
estiver ativado. Nem todos os sistemas operacionais oferecem suporte a essa opção. O padrão é60
.Adicionado no cURL 7.25.0. CURLOPT_TIMECONDITION
Como CURLOPT_TIMEVALUE
é tratado. UseCURL_TIMECOND_IFMODSINCE
para retornar a página somente se ela tiver sido modificada desde o horário especificado emCURLOPT_TIMEVALUE
. Se não foi modificado, um cabeçalho"304 Not Modified"
será retornado assumindo queCURLOPT_HEADER
étrue
. UseCURL_TIMECOND_IFUNMODSINCE
para o efeito reverso. UseCURL_TIMECOND_NONE
para ignorarCURLOPT_TIMEVALUE
e sempre retornar a página.CURL_TIMECOND_NONE
é o padrão.Antes do cURL 7.46.0, o padrão era CURL_TIMECOND_IFMODSINCE
.CURLOPT_TIMEOUT
O número máximo de segundos para permitir que as funções cURL sejam executadas. CURLOPT_TIMEOUT_MS
O número máximo de milissegundos para permitir que as funções cURL sejam executadas. Se libcurl for construído para usar o resolvedor de nome do sistema padrão, essa parte da conexão ainda usará a resolução de segundo completo para tempos limite com um tempo limite mínimo permitido de um segundo. Adicionado no cURL 7.16.2. CURLOPT_TIMEVALUE
O tempo em segundos desde 1º de janeiro de 1970. O tempo será usado por CURLOPT_TIMECONDITION
.CURLOPT_TIMEVALUE_LARGE
O tempo em segundos desde 1º de janeiro de 1970. O tempo será usado por CURLOPT_TIMECONDITION
. O padrão é zero. A diferença entre esta opção eCURLOPT_TIMEVALUE
é o tipo do argumento. Em sistemas onde 'long' tem apenas 32 bits de largura, esta opção deve ser usada para definir datas além do ano de 2038.Adicionado no curl 7.59.0. Disponível desde o PHP 7.3.0. CURLOPT_UPKEEP_INTERVAL_MS
Alguns protocolos possuem mecanismos de 'manutenção de conexão'. Esses mecanismos geralmente enviam algum tráfego nas conexões existentes para mantê-las ativas. Esta opção define o intervalo de manutenção de conexão. Atualmente, o único protocolo com um mecanismo de manutenção de conexão é o HTTP/2. Quando o intervalo de manutenção de conexão é excedido, um quadro PING do HTTP/2 é enviado na conexão. O valor padrão é de 60
segundos.CURLOPT_UPLOAD_BUFFERSIZE
Tamanho de buffer preferido em bytes para o buffer de envio do cURL. O tamanho padrão do buffer de envio é de 64 kilobytes. O tamanho máximo do buffer permitido a ser definido é de 2 megabytes. O tamanho mínimo do buffer permitido a ser definido é de 16 kilobytes. CURLOPT_MAX_RECV_SPEED_LARGE
Se um recebimento de dados exceder essa velocidade (contada em bytes por segundo) na média cumulativa durante a transferência, a transferência será pausada para manter a taxa média menor ou igual ao valor do parâmetro. O padrão é velocidade ilimitada. Adicionado no cURL 7.15.5. CURLOPT_MAX_SEND_SPEED_LARGE
Se um envio exceder essa velocidade (contada em bytes por segundo) na média cumulativa durante a transferência, a transferência será pausada para manter a taxa média menor ou igual ao valor do parâmetro. O padrão é velocidade ilimitada. Adicionado no cURL 7.15.5. CURLOPT_SSH_AUTH_TYPES
Uma máscara de bits que consiste em um ou mais CURLSSH_AUTH_PUBLICKEY
,CURLSSH_AUTH_PASSWORD
,CURLSSH_AUTH_HOST
,CURLSSH_AUTH_KEYBOARD
. Defina comoCURLSSH_AUTH_ANY
para permitir que libcurl escolha um.Adicionado no cURL 7.16.1. CURLOPT_IPRESOLVE
Permite que um aplicativo selecione que tipo de endereço IP usar ao resolver nomes de host. Isso só é interessante ao usar nomes de host que resolvem endereços usando mais de uma versão de IP, os valores possíveis são CURL_IPRESOLVE_WHATEVER
,CURL_IPRESOLVE_V4
,CURL_IPRESOLVE_V6
, por padrãoCURL_IPRESOLVE_WHATEVER
.Adicionado no cURL 7.10.8. CURLOPT_FTP_FILEMETHOD
Diga ao curl qual método usar para acessar um arquivo em um servidor FTP(S). Os valores possíveis são CURLFTPMETHOD_DEFAULT
,CURLFTPMETHOD_MULTICWD
,CURLFTPMETHOD_NOCWD
eCURLFTPMETHOD_SINGLECWD
.Adicionado no cURL 7.15.1. value
deve ser uma string para os seguintes valores do parâmetrooption
:Opção Definir value
paraNotas CURLOPT_ABSTRACT_UNIX_SOCKET
Permite o uso de um socket de domínio Unix abstrato em vez de estabelecer uma conexão TCP com um host e define o caminho para a string fornecida. Esta opção compartilha a mesma semântica que CURLOPT_UNIX_SOCKET_PATH
. Essas duas opções compartilham o mesmo armazenamento e, portanto, apenas uma delas pode ser definida por identificador.Disponível desde o PHP 7.3.0 e cURL 7.53.0 CURLOPT_ALTSVC
Passe o nome do arquivo para o cURL usar como arquivo de cache Alt-Svc para ler os conteúdos em cache existentes e, possivelmente, gravá-los de volta após uma transferência, a menos que CURLALTSVC_READONLYFILE
seja definido viaCURLOPT_ALTSVC_CTRL
.CURLOPT_ALTSVC_CTRL
Preencha a máscara de bits com o conjunto correto de recursos para instruir o cURL sobre como lidar com Alt-Svc para as transferências. O cURL só aceita cabeçalhos Alt-Svc sobre HTTPS. Ele também só completará uma solicitação para uma origem alternativa se essa origem estiver devidamente hospedada sobre HTTPS. Definir qualquer bit habilitará o mecanismo Alt-Svc. As opções são: CURLALTSVC_H1
,CURLALTSVC_H2
,CURLALTSVC_H3
, eCURLALTSVC_READONLYFILE
.CURLOPT_AWS_SIGV4
Fornecer autenticação de assinatura AWS V4 no cabeçalho HTTP(S).
Esta opção substitui quaisquer outros tipos de autenticação que tenham sido definidos em
CURLOPT_HTTPAUTH
. Este método não pode ser combinado com outros tipos de autenticação.CURLOPT_CAINFO
O nome de um arquivo contendo um ou mais certificados para verificar com o par. Isso só faz sentido quando usado em combinação com CURLOPT_SSL_VERIFYPEER
.Pode exigir um caminho absoluto. CURLOPT_CAINFO_BLOB
O nome de um arquivo PEM que contém um ou mais certificados para verificar o peer. Esta opção substitui CURLOPT_CAINFO
.Disponível a partir do PHP 8.2.0 e cURL 7.77.0. CURLOPT_CAPATH
Um diretório que contém vários certificados de CA. Use esta opção juntamente com CURLOPT_SSL_VERIFYPEER
.CURLOPT_COOKIE
O conteúdo do cabeçalho "Cookie: "
a ser usado na solicitação HTTP. Observe que vários cookies são separados por um ponto e vírgula seguido por um espaço (exemplo: "fruit=apple; colour=red
")CURLOPT_COOKIEFILE
O nome do arquivo que contém os dados do cookie. O arquivo de cookie pode estar no formato Netscape ou apenas cabeçalhos de estilo HTTP simples despejados em um arquivo. Se o nome for uma string vazia, nenhum cookie será carregado, mas a manipulação de cookies ainda estará habilitada. CURLOPT_COOKIEJAR
O nome de um arquivo no qual serão gravados todos os cookies internos quando o destrutor do identificador for chamado. WarningA partir do PHP 8.0.0, curl_close() não tem função e não destrói o identificador. Se for necessário gravar cookies antes do identificador ser automaticamente destruído, deve-se chamar unset() no identificador.
CURLOPT_COOKIELIST
Uma string de cookie (ou seja, uma única linha no formato Netscape/Mozilla ou um cabeçalho Set-Cookie regular estilo HTTP) adiciona esse único cookie ao armazenamento interno de cookies. "ALL"
apaga todos os cookies mantidos na memória."SESS"
apaga todos os cookies de sessão mantidos na memória."FLUSH"
grava todos os cookies conhecidos no arquivo especificado porCURLOPT_COOKIEJAR
."RELOAD"
carrega todos os cookies dos arquivos especificados porCURLOPT_COOKIEFILE
.Disponível desde cURL 7.14.1. CURLOPT_CUSTOMREQUEST
Um método de solicitação personalizado para usar em vez de
"GET"
ou"HEAD"
ao fazer uma solicitação HTTP. Isso é útil para fazer"DELETE"
ou outras solicitações HTTP mais obscuras. Os valores válidos são coisas como"GET"
,"POST"
,"CONNECT"
e assim por diante; ou seja, não insira uma linha de solicitação HTTP inteira aqui. Por exemplo, inserir"GET /index.html HTTP/1.0\r\n\r\n"
seria incorreto.Note:
Não faça isso sem antes certificar-se de que o servidor oferece suporte ao método de solicitação personalizado.
CURLOPT_DEFAULT_PROTOCOL
O protocolo padrão a ser usado se a URL não tiver um nome de esquema.
Adicionado no cURL 7.45.0. Disponível desde o PHP 7.0.7. CURLOPT_DNS_INTERFACE
Define o nome da interface de rede à qual o resolvedor de DNS deve se vincular. Deve ser um nome de interface (não um endereço).
Adicionado no cURL 7.33.0. Disponível desde o PHP 7.0.7. CURLOPT_DNS_LOCAL_IP4
Define o endereço IPv4 local ao qual o resolvedor deve se vincular. O argumento deve conter um único endereço IPv4 numérico como string.
Adicionado no cURL 7.33.0. Disponível desde o PHP 7.0.7. CURLOPT_DNS_LOCAL_IP6
Define o endereço IPv6 local ao qual o resolvedor deve se vincular. O argumento deve conter um único endereço IPv6 numérico como string.
Adicionado no cURL 7.33.0. Disponível desde o PHP 7.0.7. CURLOPT_EGDSOCKET
Como CURLOPT_RANDOM_FILE
, exceto um nome de arquivo para um socket Entropy Gathering Daemon.CURLOPT_ENCODING
O conteúdo do cabeçalho "Accept-Encoding: "
. Isso permite a decodificação da resposta. As codificações suportadas são"identity"
,"deflate"
e"gzip"
. Se uma string vazia,""
, for definida, um cabeçalho contendo todos os tipos de codificação suportados será enviado.Adicionado no cURL 7.10. CURLOPT_FTPPORT
O valor que será usado para obter o endereço IP a ser usado para a instrução FTP "PORT". A instrução "PORT" diz ao servidor remoto para se conectar ao nosso endereço IP especificado. A string pode ser um endereço IP simples, um nome de host, um nome de interface de rede (no Unix) ou apenas um '-' simples para usar o endereço IP padrão do sistema. CURLOPT_HSTS
Nome do arquivo de cache do HSTS (HTTP Strict Transport Security).
CURLOPT_HSTS_CTRL
Controla o comportamento do HSTS (HTTP Strict Transport Security). Preencha a máscara de bits com o conjunto correto de recursos para instruir o cURL sobre como lidar com o HSTS para as transferências.
CURLHSTS_ENABLE
habilita o cache HSTS na memória. Se o arquivo de cache HSTS estiver definido, definaCURLHSTS_READONLYFILE
para tornar o arquivo somente leitura.CURLOPT_INTERFACE
O nome da interface de rede de saída a ser usada. Pode ser um nome de interface, um endereço IP ou um nome de host. CURLOPT_KEYPASSWD
A senha necessária para usar a chave privada CURLOPT_SSLKEY
ouCURLOPT_SSH_PRIVATE_KEYFILE
.Adicionado no cURL 7.16.1 CURLOPT_KRB4LEVEL
O nível de segurança KRB4 (Kerberos 4). Qualquer um dos seguintes valores (do menos para o mais poderoso) são válidos: "clear"
,"safe"
,"confidential"
,"private".
. Se a string não corresponder a um desses,"private"
será usado. Definir esta opção comonull
desativará a segurança KRB4. Atualmente a segurança KRB4 funciona apenas com transações FTP.CURLOPT_LOGIN_OPTIONS
Pode ser usado para definir opções de login específicas do protocolo, como o mecanismo de autenticação preferencial via "AUTH=NTLM" ou "AUTH=*", e deve ser usado em conjunto com a opção CURLOPT_USERNAME
.Adicionado no cURL 7.34.0. Disponível desde o PHP 7.0.7. CURLOPT_PINNEDPUBLICKEY
Definr a chave pública fixada. A string pode ser o nome do arquivo da sua chave pública fixada. O formato de arquivo esperado é "PEM" ou "DER". A string também pode ser qualquer número de hashes sha256 codificados em base64 precedidos por "sha256//" e separados por ";". Adicionado no cURL 7.39.0. Disponível desde o PHP 7.0.7. CURLOPT_POSTFIELDS
Os dados completos a serem postados em uma operação HTTP "POST". Este parâmetro pode ser passado como uma string com código urlen como ' para1=val1¶2=val2&...
' ou como uma matriz com o nome do campo como chave e os dados do campo como valor. Sevalue
for um array, o cabeçalhomultipart/form-data
será definido comoContent-Type
. Os arquivos podem ser enviados usando CURLFile ou CURLStringFile, caso em que ovalue
deve ser uma matriz.CURLOPT_PRIVATE
Quaisquer dados que devem ser associados a este identificador cURL. Esses dados podem ser posteriormente recuperados com a opção CURLINFO_PRIVATE
de curl_getinfo(). cURL não faz nada com esses dados. Ao usar um identificador cURL múltiplo, esses dados privados geralmente são uma chave exclusiva para identificar um identificador cURL padrão.Adicionado no cURL 7.10.3. CURLOPT_PRE_PROXY
Define uma string contendo o nome do host ou o endereço IP numérico pontilhado a ser usado como o pré-proxy ao qual o curl se conecta antes de se conectar ao proxy HTTP(S) especificado na opção CURLOPT_PROXY
para a próxima solicitação. O pré-proxy só pode ser um proxy SOCKS e deve ser prefixado com[scheme]://
para especificar que tipo de meias é usado. Um endereço IPv6 numérico deve ser escrito entre [colchetes]. Definir o pré-proxy como uma string vazia desativa explicitamente o uso de um pré-proxy. Para especificar o número da porta nesta string, anexe ::[port]
ao final do nome do host. O número da porta do proxy pode opcionalmente ser especificado com a opção separadaCURLOPT_PROXYPORT
. O padrão é usar a porta 1080 para proxies se uma porta não for especificada.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY
O proxy HTTP para o túnel de solicitações. CURLOPT_PROXY_SERVICE_NAME
O nome do serviço de autenticação de proxy. Adicionado no cURL 7.43.0 para proxies HTTP e no cURL 7.49.0 para proxies SOCKS5. Disponível desde o PHP 7.0.7. CURLOPT_PROXY_CAINFO
O caminho para o pacote de Autoridade de Certificação (CA) do proxy. Defina o caminho como uma string que nomeia um arquivo contendo um ou mais certificados para verificar o proxy HTTPS. Esta opção é para conectar a um proxy HTTPS, não a um servidor HTTPS. Padrões definidos para o caminho do sistema onde o pacote cacert do libcurl é considerado armazenado. Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_CAINFO_BLOB
O nome de um arquivo PEM que contém um ou mais certificados para verificar o proxy HTTPS. Esta opção é para se conectar a um proxy HTTPS, não a um servidor HTTPS. O valor padrão é definido como o caminho do sistema onde se presume que o pacote cacert do libcurl está armazenado. Disponível a partir do PHP 8.2.0 e libcurl >= cURL 7.77.0. CURLOPT_PROXY_CAPATH
O diretório que contém vários certificados CA para verificar o proxy HTTPS. Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_CRLFILE
Define o nome do arquivo com a concatenação de CRL (Certificate Revocation List) no formato PEM para usar na validação do certificado que ocorre durante a troca SSL. Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_KEYPASSWD
Define a string a ser usada como a senha necessária para usar a chave privada CURLOPT_PROXY_SSLKEY
. Nunca será necessária uma senha para carregar um certificado, mas uma será necessária para carregar a chave privada. Esta opção é para conectar a um proxy HTTPS, não a um servidor HTTPS.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_PINNEDPUBLICKEY
Define a chave pública fixada para o proxy HTTPS. A string pode ser o nome do arquivo da sua chave pública fixada. O formato de arquivo esperado é "PEM" ou "DER". A string também pode ser qualquer número de hashes sha256 codificados em base64 precedidos por "sha256//" e separados por ";" Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSLCERT
O nome do arquivo do certificado de cliente usado para se conectar ao proxy HTTPS. O formato padrão é "P12" no Secure Transport e "PEM" em outros mecanismos e pode ser alterado com CURLOPT_PROXY_SSLCERTTYPE
. Com NSS ou Secure Transport, também pode ser o apelido do certificado com o qual deseja-se autenticar, pois é nomeado no banco de dados de segurança. Se a intenção for usar um arquivo do diretório atual, preceda-o com o prefixo "./", para evitar confusão com um apelido.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSLCERTTYPE
O formato do certificado de cliente usado ao se conectar a um proxy HTTPS. Os formatos suportados são "PEM" e "DER", exceto com Transporte Seguro. OpenSSL (versões 0.9.3 e posteriores) e Secure Transport (no iOS 5 ou posterior, ou OS X 10.7 ou posterior) também suportam "P12" para arquivos codificados com PKCS#12. O padrão é "PEM". Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSL_CIPHER_LIST
A lista de cifras a serem usadas para a conexão com o proxy HTTPS. A lista deve estar sintaticamente correta, consiste em uma ou mais cadeias de cifras separadas por dois pontos. Vírgulas ou espaços também são separadores aceitáveis, mas dois pontos são normalmente usados, !, - e + podem ser usados como operadores. Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_TLS13_CIPHERS
A lista de conjuntos de cifras a serem usados para a conexão TLS 1.3 com um proxy. A lista deve estar sintaticamente correta, ela consiste em uma ou mais sequências de conjuntos de cifras separadas por dois pontos. Esta opção é usada atualmente apenas quando o curl é construído para usar o OpenSSL 1.1.1 ou posterior. Se um back-end SSL diferente estiver sendo usado, tente configurar os conjuntos de cifras TLS 1.3 usando a opção CURLOPT_PROXY_SSL_CIPHER_LIST
.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.61.0. Disponível quando construído com OpenSSL >= 1.1.1. CURLOPT_PROXY_SSLKEY
O nome do arquivo de sua chave privada usada para conectar-se ao proxy HTTPS. O formato padrão é "PEM" e pode ser alterado com CURLOPT_PROXY_SSLKEYTYPE
. (Somente iOS e Mac OS X) Essa opção será ignorada se o curl tiver sido criado no Secure Transport.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. Disponível se construído com TLS ativado. CURLOPT_PROXY_SSLKEYTYPE
O formato da sua chave privada. Os formatos suportados são "PEM", "DER" e "ENG". Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_TLSAUTH_PASSWORD
A senha a ser usada para o método de autenticação TLS especificado com a opção CURLOPT_PROXY_TLSAUTH_TYPE
. Requer que a opçãoCURLOPT_PROXY_TLSAUTH_USERNAME
também seja definida.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_TLSAUTH_TYPE
O método de autenticação TLS usado para a conexão HTTPS. O método suportado é "SRP"
.Note:
A autenticação Secure Remote Password (SRP) para TLS fornece autenticação mútua se ambos os lados tiverem um segredo compartilhado. Para usar TLS-SRP, devem ser definidas também as opções
CURLOPT_PROXY_TLSAUTH_USERNAME
eCURLOPT_PROXY_TLSAUTH_PASSWORD
.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXY_TLSAUTH_USERNAME
O nome de usuário a ser usado para o método de autenticação TLS do proxy HTTPS especificado com a opção CURLOPT_PROXY_TLSAUTH_TYPE
. Requer que a opçãoCURLOPT_PROXY_TLSAUTH_PASSWORD
também seja definida.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.52.0. CURLOPT_PROXYUSERPWD
Um nome de usuário e senha formatados como "[username]:[password]"
para usar na conexão com o proxy.CURLOPT_RANDOM_FILE
Um nome de arquivo a ser usado para propagar o gerador de números aleatórios para SSL. CURLOPT_RANGE
Faixa(s) de dados a serem recuperados no formato "X-Y"
onde X ou Y são opcionais. As transferências HTTP também suportam vários intervalos, separados por vírgulas no formato"X-Y,N-M"
.CURLOPT_REFERER
O conteúdo do cabeçalho "Referer: "
a ser usado em uma solicitação HTTP.CURLOPT_SASL_AUTHZID
A identidade de autorização (authzid) para a transferência. Aplicável apenas ao mecanismo de autenticação SASL PLAIN, onde é opcional. Quando não especificado, apenas a identidade de autenticação (authcid) conforme especificada pelo nome de usuário será enviada para o servidor, junto com a senha. O servidor derivará o authzid do authcid quando não fornecido, que será então usado internamente. CURLOPT_SERVICE_NAME
O nome do serviço de autenticação. Adicionado no cURL 7.43.0. Disponível desde o PHP 7.0.7. CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
Uma string contendo 32 dígitos hexadecimais. A string deve ser a soma de verificação MD5 da chave pública do host remoto e libcurl rejeitará a conexão com o host, a menos que os md5sums correspondam. Esta opção é apenas para transferências SCP e SFTP. Adicionado no cURL 7.17.1. CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256
Hash SHA256 codificado em Base64 da chave pública do host remoto. A transferência falhará se o hash fornecido não corresponder ao hash fornecido pelo host remoto. CURLOPT_SSH_PUBLIC_KEYFILE
O nome do arquivo para sua chave pública. Se não for usado, o padrão de libcurl é $HOME/.ssh/id_dsa.pub se a variável de ambiente HOME estiver definida e apenas "id_dsa.pub" no diretório atual se HOME não estiver definido. Adicionado no cURL 7.16.1. CURLOPT_SSH_PRIVATE_KEYFILE
O nome do arquivo para sua chave privada. Se não for usado, libcurl assume como padrão $HOME/.ssh/id_dsa se a variável de ambiente HOME estiver definida e apenas "id_dsa" no diretório atual se HOME não estiver definido. Se o arquivo estiver protegido por senha, defina a senha com CURLOPT_KEYPASSWD
CURLOPT_KEYPASSWD.Adicionado no cURL 7.16.1. CURLOPT_SSL_CIPHER_LIST
Uma lista de cifras a serem usadas para SSL. Por exemplo, RC4-SHA
eTLSv1
são listas de cifras válidas.CURLOPT_SSL_EC_CURVES
Uma lista delimitada por dois-pontos de algoritmos de curva elíptica. Por exemplo, X25519:P-521
é uma lista válida de duas curvas elípticas. Esta opção define os algoritmos de troca de chaves do cliente no handshake SSL, se o backend SSL que o cURL está construído para usar o suportar.CURLOPT_SSLCERT
O nome de um arquivo que contém um certificado no formato PEM. CURLOPT_SSLCERTPASSWD
A senha necessária para usar o certificado CURLOPT_SSLCERT
.CURLOPT_SSLCERTTYPE
O formato do certificado. Os formatos suportados são "PEM"
(padrão),"DER"
e"ENG"
. A partir do OpenSSL 0.9.3,"P12"
(para arquivos codificados em PKCS#12) também é suportado.Adicionado no cURL 7.9.3. CURLOPT_SSLENGINE
O identificador para o mecanismo de criptografia da chave SSL privada especificada em CURLOPT_SSLKEY
.CURLOPT_SSLENGINE_DEFAULT
O identificador do mecanismo de criptografia usado para operações de criptografia assimétricas. CURLOPT_SSLKEY
O nome de um arquivo que contém uma chave SSL privada. CURLOPT_SSLKEYPASSWD
A senha secreta necessária para usar a chave SSL privada especificada em
CURLOPT_SSLKEY
.Note:
Como esta opção contém uma senha confidencial, lembre-se de manter o script PHP contido nela seguro.
CURLOPT_SSLKEYTYPE
O tipo de chave da chave SSL privada especificada em CURLOPT_SSLKEY
. Os tipos de chave suportados são"PEM"
(padrão),"DER"
e"ENG"
.CURLOPT_TLS13_CIPHERS
A lista de conjuntos de cifras a serem usados para a conexão TLS 1.3. A lista deve estar sintaticamente correta, ela consiste em uma ou mais sequências de conjuntos de cifras separadas por dois pontos. Esta opção é usada atualmente apenas quando o curl é construído para usar o OpenSSL 1.1.1 ou posterior. Se um back-end SSL diferente estiver sendo usado, tente configurar os conjuntos de cifras TLS 1.3 usando a opção CURLOPT_SSL_CIPHER_LIST
.Disponível desde o PHP 7.3.0 e libcurl >= cURL 7.61.0. Disponível quando construído com OpenSSL >= 1.1.1. CURLOPT_UNIX_SOCKET_PATH
Habilita o uso de sockets de domínio Unix como endpoint de conexão e define o caminho para a string fornecida. Adicionado no cURL 7.40.0. Disponível desde o PHP 7.0.7. CURLOPT_URL
A URL a ser buscada. Isso também pode ser definido ao inicializar uma sessão com curl_init(). CURLOPT_USERAGENT
O conteúdo do cabeçalho "User-Agent: "
a ser usado em uma solicitação HTTP.CURLOPT_USERNAME
O nome de usuário a ser usado na autenticação. Adicionado no cURL 7.19.1. CURLOPT_PASSWORD
A senha a ser usada na autenticação. Adicionado no cURL 7.19.1. CURLOPT_USERPWD
Um nome de usuário e senha formatados como "[username]:[password]"
para usar na conexão.CURLOPT_XOAUTH2_BEARER
Especifica o token de acesso OAuth 2.0. Adicionado no cURL 7.33.0. Disponível desde o PHP 7.0.7. value
deve ser um array para os seguintes valores do parâmetrooption
:Opção Definir value
paraNotas CURLOPT_CONNECT_TO
Conecte-se a um host e porta específicos em vez do host e da porta da URL. Aceita uma matriz de strings com o formato HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT
.Adicionado no curl 7.49.0. Disponível desde o PHP 7.0.7. CURLOPT_HTTP200ALIASES
Uma matriz de respostas HTTP 200 que serão tratadas como respostas válidas e não como erros. Adicionado no cURL 7.10.3. CURLOPT_HTTPHEADER
Uma matriz de campos de cabeçalho HTTP para definir, no formato array('Content-type: text/plain', 'Content-length: 100')
CURLOPT_POSTQUOTE
Uma matriz de comandos de FTP a serem executados no servidor após a execução da solicitação de FTP. CURLOPT_PROXYHEADER
Uma matriz de cabeçalhos HTTP personalizados para passar para proxies. Adicionado no cURL 7.37.0. Disponível desde o PHP 7.0.7. CURLOPT_QUOTE
Uma matriz de comandos de FTP a serem executados no servidor antes da solicitação de FTP. CURLOPT_RESOLVE
Forneça um endereço personalizado para um host específico e um par de portas. Uma matriz de strings de nome de host, porta e endereço IP, cada elemento separado por dois pontos. No formato: array("example.com:80:127.0.0.1") array("example.com:80:127.0.0.1")
Adicionado no cURL 7.21.3. value
deve ser um recurso de fluxo (usando fopen(), por exemplo) para os seguintes valores do parâmetrooption
:Opção Definir value
paraCURLOPT_FILE
O arquivo no qual a transferência deve ser gravada. O padrão é STDOUT
(a janela do navegador).CURLOPT_INFILE
O arquivo do qual a transferência deve ser lida durante o upload. CURLOPT_STDERR
Um local alternativo para gerar erros em vez de STDERR
.CURLOPT_WRITEHEADER
O arquivo no qual a parte do cabeçalho da transferência é gravada. value
deve ser o nome de uma função válida ou um Closure para os seguintes valores do parâmetrooption
:Opção Definir value
paraNotas CURLOPT_HEADERFUNCTION
Uma função de retorno que aceita dois parâmetros. O primeiro é o identificador cURL, o segundo é uma string com os dados do cabeçalho a serem gravados. Os dados do cabeçalho devem ser gravados por esta função. Retorna o número de bytes gravados. CURLOPT_PASSWDFUNCTION
Uma função de retorno que aceita três parâmetros. O primeiro é o identificador cURL, o segundo é uma string contendo um prompt de senha e o terceiro é o tamanho máximo da senha. Retorna a string contendo a senha. Removido a partir do PHP 7.3.0. CURLOPT_PROGRESSFUNCTION
Uma função de retorno que aceita cinco parâmetros. O primeiro é o identificador cURL, o segundo é o número total de bytes que se espera que sejam baixados nesta transferência, o terceiro é o número de bytes baixados até agora, o quarto é o número total de bytes que se espera que sejam carregados nesta transferência, e o quinto é o número de bytes enviados até agora.
Note:
A função de retorno só é chamada quando a opção
CURLOPT_NOPROGRESS
é definida comofalse
.Retorne um valor diferente de zero para abortar a transferência. Nesse caso, a transferência definirá um erro
CURLE_ABORTED_BY_CALLBACK
.CURLOPT_READFUNCTION
Uma função de retorno que aceita três parâmetros. O primeiro é o identificador cURL, o segundo é um recurso de fluxo fornecido ao cURL por meio da opção CURLOPT_INFILE
e o terceiro é a quantidade máxima de dados a serem lidos. A função deve retornar uma string com comprimento igual ou menor que a quantidade de dados solicitados, geralmente lendo-a do recurso de fluxo passado. Ele deve retornar uma string vazia para sinalizarEOF
.CURLOPT_WRITEFUNCTION
Uma função de retorno que aceita dois parâmetros. O primeiro é o identificador cURL e o segundo é uma string com os dados a serem gravados. Os dados devem ser salvos por esta função. Deve retornar o número exato de bytes escritos ou a transferência será abortada com erro. CURLOPT_XFERINFOFUNCTION
Uma função de retorno que aceita dois parâmetros. Tem um propósito semelhante ao CURLOPT_PROGRESSFUNCTION
, mas é mais moderno e a opção preferida do cURL.Adicionado em 7.32.0. Disponível a partir do PHP 8.2.0. Other values:
Opção Definir value
paraCURLOPT_SHARE
Um resultado de curl_share_init(). Faz com que o identificador cURL use os dados do identificador compartilhado.
Registro de Alterações
Exemplos
Example #1 Inicializando uma nova sessão cURL e buscando uma página da web
<?php
// criar um novo identificador cURL
$ch = curl_init();
// definir URL e outras opções apropriadas
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, false);
// pegar URL e passá-lo para o navegador
curl_exec($ch);
// feche o identificador cURL e libere recursos do sistema
curl_close($ch);
?>
Notas
Note:
Passar uma matriz para
CURLOPT_POSTFIELDS
codificará os dados como multipart/form-data, enquanto passar uma string codificada em URL codificará os dados como application/x-www-form-urlencoded.
Veja Também
- curl_setopt_array() - Define múltiplas opções para uma transferência cURL
- CURLFile
- CURLStringFile