diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index fa6dcca71..4c926eb9e 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -1,4 +1,4 @@ - + <function>curl-setopt</function> @@ -13,7 +13,7 @@ de CURLOPT_UNIX_SOCKET_PATH. Estas duas opções compartilham o mesmo armazenamento e portanto somente uma delas pode ser definida por identificador. - Disponível a partir do PHP 7.3.0 e cURL 7.53.0 + Disponível a partir do PHP 7.3.0 e cURL 7.53.0. @@ -68,7 +68,7 @@ - Passa o nome do arquivo para o cURL usar como o arquivo de cache Alt-Svc para leitura de conteúdo de cache existente + Passa uma string com o nome do arquivo para o cURL usar como o arquivo de cache Alt-Svc para leitura de conteúdo de cache existente e possivelmente também gravar de volta após uma transferência, a menos que CURLALTSVC_READONLYFILE esteja definido CURLOPT_ALTSVC_CTRL. Disponível a partir do PHP 8.2.0 e cURL 7.64.1. @@ -85,11 +85,10 @@ Popula 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 usando este identificador. cURL somente aceita cabeçalhos Alt-Svc através de HTTPS. Também irá completar uma requisição para uma origem alternativa se essa origem for apropriadamente servida através de HTTPS. - Definir qualquer bit irá habilitar o motor alt-svc. As opções são: - CURLALTSVC_H1, - CURLALTSVC_H2, - CURLALTSVC_H3 e - CURLALTSVC_READONLYFILE. + Definir qualquer bit irá habilitar o motor Alt-svc. + Pode ser uma das + constantes CURLALTSVC_*. + O padrão é o motor Alt-svc desabilitado. Disponível a partir do PHP 8.2.0 e cURL 7.64.1. @@ -117,6 +116,8 @@ &true; para definir automaticamente o campo Referer: nas requisições onde ele segue um redirecionamento Location:. + O padrão é 0. + Disponível a partir do cURL 7.1.0. @@ -127,10 +128,10 @@ - Fornece autenticação de assinatura AWS V4 em cabeçalho HTTP(S). + Fornece autenticação de assinatura AWS V4 em cabeçalho HTTP(S) como uma string. Esta opção substitui qualquer 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. - Disponível a partir do PHP 8.2.0 e cURL 7.75.0 + Disponível a partir do PHP 8.2.0 e cURL 7.75.0. @@ -141,7 +142,8 @@ - + Esta constante não é mais usada desde o PHP 5.5.0. + Descontinuada a partir do PHP 8.4.0. @@ -154,6 +156,8 @@ O tamanho do buffer a ser usado para cada leitura. Entretanto, não há garantia de que esta requisição será cumprida. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + O padrão é CURL_MAX_WRITE_SIZE (atualmente, 16kB). Disponível a partir do cURL 7.10. @@ -165,9 +169,10 @@ - O nome de um arquivo contendo um ou mais certificados com o qual - o peer será verificado. Só faz sentido se usado em combinação com + Uma string com o nome de um arquivo contendo um ou mais certificados com o qual + o par será verificado. Só faz sentido se usado em combinação com CURLOPT_SSL_VERIFYPEER. Pode requerer um caminho absoluto. + Disponível a partir do cURL 7.4.2. @@ -178,9 +183,9 @@ - O nome de um arquivo PEM contendo um ou mais certificados com o qual - o peer será verificado. Esta opção substitui a CURLOPT_CAINFO. - Disponível a partir do PHP 8.2.0 e cURL 7.77.0 + Uma string com o nome de um arquivo PEM contendo um ou mais certificados com o qual + o par será verificado. Esta opção substitui a CURLOPT_CAINFO. + Disponível a partir do PHP 8.2.0 e cURL 7.77.0. @@ -191,8 +196,9 @@ - Um diretótio que mantém múltiplos certificados CA. Use esta opção - junto com CURLOPT_SSL_VERIFYPEER. + Uma string com o diretótio que mantém múltiplos certificados CA. + Use esta opção junto com CURLOPT_SSL_VERIFYPEER. + Disponível a partir do cURL 7.9.8. @@ -203,7 +209,11 @@ - Disponível a partir do PHP 8.3.0 e cURL 7.87.0 + Define o tempo máximo em segundo que qualquer armazenamento de certificado CA em cache na memória + pode ser mantido e reutilizado para novas conexões. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + O padrão é 86400 (24 horas). + Disponível a partir do PHP 8.3.0 e cURL 7.87.0. @@ -215,8 +225,10 @@ &true; para enviar informação de certificação SSL para STDERR - em transferências seguras. Adicionada no cURL 7.19.1. + em transferências seguras. Requer CURLOPT_VERBOSE ligada para ter efeito. + O padrão é &false;. + Disponível a partir do cURL 7.19.1. @@ -229,6 +241,9 @@ O número de segundos a esperar durante tentativa de conexão. Use 0 para esperar indefinidamente. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + O padrão é 300. + Disponível a partir do cURL 7.7.0. @@ -239,12 +254,14 @@ - O número de milissegundos a esperar durante tentativa de conexão. Use 0 para - esperar indefinidamente. - - Se libcurl tiver sido compilada para usar resolução de nome padrão do sistema, esta + O número de milissegundos a esperar durante tentativa de conexão. + Use 0 para esperar indefinidamente. + Se o cURL tiver sido compilado para usar resolução de nome padrão do sistema, esta porção da conexão ainda usará a resolução de segundos inteiros para - limites de tempo com um tempo mínimo permitido de um segundo. Disponível a partir do cURL 7.16.2. + limites de tempo com um tempo mínimo permitido de um segundo. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + O padrão é 300000. + Disponível a partir do cURL 7.16.2. @@ -258,6 +275,7 @@ &true; informa à biblioteca para realizar toda a autenticação de proxy requerida e configuração de conexão, mas sem transferência de dados. Esta opção está implementada para HTTP, SMTP e POP3. + O padrão é &false;. Disponível a partir do cURL 7.15.2. @@ -270,9 +288,9 @@ Conecta a um servidor e porta específicos ao invés do servidor e porta da URL. - Aceita um array de strings com o formato + Aceita um array de strings com o formato HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. - Disponível a partir do PHP 7.0.7 e cURL 7.49.0 + Disponível a partir do PHP 7.0.7 e cURL 7.49.0. @@ -283,10 +301,10 @@ - O conteúdo do cabeçalho "Cookie: " a ser - usado na requisição HTTP. - Observe que cookies múltiplos são separados com um ponto-e-vírgula seguido de - um espaço (ex.: "fruit=apple; colour=red") + Uma string com o conteúdo do cabeçalho Cookie: a ser usado na requisição HTTP. + Observe que cookies múltiplos são separados por ponto-e-vírgula seguido de + um espaço (ex.: fruit=apple; colour=red). + Disponível a partir do cURL 7.1.0. @@ -297,11 +315,11 @@ - O nome do arquivo contendo os dados do cookie. O arquivo de cookie pode ser - no formato Netscape ou apenas cabeçalhos puros no estilo HTTP gravados em - um arquivo. - Se o nome for uma string vazia, nenhum cookie é carregado, porém + Uma string com o nome do arquivo contendo os dados do cookie. + O arquivo de cookie pode ser no formato Netscape ou apenas cabeçalhos puros no estilo HTTP gravados em um arquivo. + Se o nome for uma string vazia, nenhum cookie é carregado, porém o gerenciamento de cookies ainda estará habilitado. + Disponível a partir do cURL 7.1.0. @@ -312,8 +330,9 @@ - O nome do arquivo para gravar todos os cookies internos para quando o + Uma string com o nome do arquivo para gravar todos os cookies internos para quando o destrutor do identificador for chamado. + Disponível a partir do cURL 7.9.0. A partir do PHP 8.0.0, curl_close não tem função @@ -332,12 +351,26 @@ - Uma string de cookie (isto é, uma linha única no formato Netscape/Mozilla ou um + Uma string de cookie (isto é, uma linha única no formato Netscape/Mozilla ou um cabeçalho Set-Cookie no estilo HTTP) adiciona esse cookie único ao armazenamento interno de cookies. - "ALL" apaga todos os cookies da memória. - "SESS" apaga todos os cookies de sessão mantidos na memória. - "FLUSH" grava todos os cookies conhecidos no arquivo especificado por CURLOPT_COOKIEJAR. - "RELOAD" carrega todos os cookies dos arquivos especificados por CURLOPT_COOKIEFILE. + + + ALL + apaga todos os cookies da memória + + + SESS + apaga todos os cookies de sessão mantidos na memória + + + FLUSH + grava todos os cookies conhecidos no arquivo especificado por CURLOPT_COOKIEJAR + + + RELOAD + carrega todos os cookies dos arquivos especificados por CURLOPT_COOKIEFILE + + . Disponível a partir do cURL 7.14.1. @@ -349,12 +382,13 @@ - &true; para marcar esta como uma nova "sessão" de cookie. Irá forçar a libcurl + &true; para marcar esta como uma nova "sessão" de cookie. Irá forçar o cURL a ignorar todos os cookies que estiverem para ser carregados que sejam "cookies de sessão" - da sessão anterior. Por padrão, a libcurl sempre guarda e + da sessão anterior. Por padrão, o cURL sempre guarda e carrega todos os cookies, independente se houver cookies de sessão ou não. Cookies de sessão são cookies sem data de expiração que devem existir apenas durante esta "sessão". + Disponível a partir do cURL 7.9.7. @@ -367,6 +401,7 @@ &true; para converter novas linhas Unix para novas linhas CRLF nas transferências. + Disponível a partir do cURL 7.1.0. @@ -391,7 +426,7 @@ Observe também que CURLOPT_CRLFILE implica em CURLSSLOPT_NO_PARTIALCHAIN a partir do cURL 7.71.0 devido a um problema do OpenSSL. - Disponível a partir do cURL 7.19.0 + Disponível a partir do cURL 7.19.0. @@ -403,14 +438,16 @@ Um método de requisição customizado a ser usado no lugar de - "GET" ou "HEAD" ao fazer + GET ou HEAD ao fazer uma requisição HTTP. Isto é útil para fazer - "DELETE" ou outras requisições HTTP mais obscuras. - Valores válidos são por exemplo "GET", - "POST", "CONNECT" entre outros; + DELETE ou outras requisições HTTP mais obscuras. + Valores válidos são por exemplo GET, + POST, CONNECT entre outros; Não insira aqui uma requisição HTTP inteira. Por exemplo, - escrever "GET /index.html HTTP/1.0\r\n\r\n" + escrever GET /index.html HTTP/1.0\r\n\r\n estaria incorreto. + Esta opção aceita uma string ou &null;. + Disponível a partir do cURL 7.1.0. Isto não deve ser feito sem primeiro garantir que o servidor suporta o método @@ -427,8 +464,8 @@ - O protocolo padrão a usar se a URL não tem um nome de esquema. - Disponível a partir do PHP 7.0.7 e cURL 7.45.0 + Uma string com o protocolo padrão a ser usado se a URL não tiver um nome de esquema. + Disponível a partir do PHP 7.0.7 e cURL 7.45.0. @@ -459,8 +496,9 @@ - &true; para não permitir URLs que incluem um nome de usuário. Nomes de usuário são permitidos por padrão (0). - Disponível a partir do PHP 7.3.0 e cURL 7.61.0 + &true; para não permitir URLs que incluem um nome de usuário. + Nomes de usuário são permitidos por padrão. + Disponível a partir do PHP 7.3.0 e cURL 7.61.0. @@ -472,7 +510,9 @@ O número de segundos para manter as entradas DNS na memória. Esta - opção é definida para 120 (2 minutos) por padrão. + opção é definida para 120 (2 minutos) por padrão. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.9.3. @@ -485,7 +525,8 @@ Define o nome da interface de rede à qual a resolução de DNS deve vincular. Precisa ser um nome de interface (não um endereço). - Disponível a partir do PHP 7.0.7 e cURL 7.33.0 + Esta opção aceita uma string ou &null;. + Disponível a partir do PHP 7.0.7 e cURL 7.33.0. @@ -496,9 +537,10 @@ - Define o endereço IPv4 local ao qual a resolução DNS deve vincular. O argumento - deve conter um único endereço numérico IPv4 no formato string. - Disponível a partir do PHP 7.0.7 e cURL 7.33.0 + Define o endereço IPv4 local ao qual a resolução DNS deve vincular. + O argumento deve conter um único endereço numérico IPv4. + Esta opção aceita uma string ou &null;. + Disponível a partir do PHP 7.0.7 e cURL 7.33.0. @@ -509,9 +551,10 @@ - Define o endereço IPv6 local ao qual a resolução DNS deve vincular. O argumento - deve conter um único endereço numérico IPv6 no formato string. - Disponível a partir do PHP 7.0.7 e cURL 7.33.0 + Define o endereço IPv6 local ao qual a resolução DNS deve vincular. + O argumento deve conter um único endereço numérico IPv6. + Esta opção aceita uma string ou &null;. + Disponível a partir do PHP 7.0.7 e cURL 7.33.0. @@ -525,7 +568,7 @@ Passa uma string com uma lista separada por vírgulas de servidores DNS a serem usados ​​em vez do padrão do sistema (ex.: 192.168.1.100,192.168.1.101:8080). - Disponível a partir do cURL 7.24.0 + Disponível a partir do cURL 7.24.0. @@ -539,7 +582,7 @@ &true; para embaralhar a ordem de todos os endereços de retorno de forma que sejam usados em ordem aleatória, quando um nome é resolvido e mais de um endereço IP é retornado. Isso pode fazer com que IPv4 seja usado antes de IPv6 ou vice-versa. - Disponível a partir do PHP 7.3.0 e cURL 7.60.0 + Disponível a partir do PHP 7.3.0 e cURL 7.60.0. @@ -553,6 +596,7 @@ &true; para usar cache de DNS global. Esta opção não é segura para threads. É condicionalmente habilitada por padrão se o PHP for compilado sem uso de threads (CLI, FCGI, Apache2-Prefork, etc.). + Disponível a partir do cURL 7.9.3 e descontinuada a partir do cURL 7.11.1. @@ -563,7 +607,7 @@ - Verifica os campos de nome de certificado SSL do servidor de DNS-sobre-HTTPS, comparando com o nome do host. + Definida como 2 verifica os campos de nome de certificado SSL do servidor de DNS-sobre-HTTPS, comparando com o nome do host. Disponível a partir do PHP 8.2.0 e cURL 7.76.0. @@ -575,7 +619,8 @@ - Verifica a autenticidade o certificado SSL do servidor de DNS-sobre-HTTPS. + Definida como 1 habilita e como 0 desabilita + a verificação da autenticidade do certificado SSL do servidor de DNS-sobre-HTTPS. Disponível a partir do PHP 8.2.0 e cURL 7.76.0. @@ -587,7 +632,8 @@ - Solicita ao cURL que verifique o status do certificado do servidor de DNS-sobre-HTTPS + Definida como 1 habilita e como 0 desabilita + a verificação do status do certificado do servidor de DNS-sobre-HTTPS usando a extensão TLS "Certificate Status Request" (grampeamento OCSP). Disponível a partir do PHP 8.2.0 e cURL 7.76.0. @@ -601,6 +647,7 @@ Fornece a URL do DNS-sobre-HTTPS. + Esta opção aceita uma string ou &null;. Disponível a partir do PHP 8.1.0 e cURL 7.62.0. @@ -614,6 +661,7 @@ Similar a CURLOPT_RANDOM_FILE, exceto por um nome de arquivo para um soquete "Entropy Gathering Daemon". + Disponível a partir do cURL 7.7.0 e descontinuada a partir do cURL 7.84.0. @@ -624,12 +672,16 @@ - O conteúdo do cabeçalho "Accept-Encoding: ". - Isto habilita a decodificação da responsta. Codificações suportadas são - "identity", "deflate" e - "gzip". Se uma string vazia, "", - for informada, é enviado um cabeçalho contendo todas os tipos de codificação. - Disponível a partir do cURL 7.10. + O conteúdo do cabeçalho Accept-Encoding: com uma string. + Isto habilita a decodificação da responsta. Codificações suportadas são: + + identity + deflate + gzip + . + Se uma string vazia for informada, + é enviado um cabeçalho contendo todas os tipos de codificação. + Disponível a partir do cURL 7.10 e descontinuada a partir do cURL 7.21.6. @@ -641,8 +693,9 @@ O limite de tempo para respostas Expect: 100-continue em milissegundos. - O padrão é 1000 milissegundos. - Disponível a partir do PHP 7.0.7 e cURL 7.36.0 + O padrão é 1000 milissegundos. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do PHP 7.0.7 e cURL 7.36.0. @@ -654,8 +707,9 @@ &true; para falhar prolixamente se o código HTTP retornado - for maior ou igual a 400. O comportamento padrão é retornar + for maior ou igual a 400. O comportamento padrão é retornar a página normalmente, ignorando o código. + Disponível a partir do cURL 7.1.0. @@ -666,8 +720,10 @@ - O arquivo no qual a transferência deve ser gravada. O padrão - é STDOUT (a janela do navegador). + Aceita um resource identificador de arquivo + no qual a transferência deve ser gravada. + O padrão é STDOUT (a janela do navegador). + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.9.7. @@ -678,10 +734,11 @@ - &true; para tentar buscar a data de modificação + Defina como &true; para tentar buscar a data de modificação do documento remoto. Este valor pode ser buscado usando-se a opção CURLINFO_FILETIME com curl_getinfo. + Disponível a partir do cURL 7.5.0. @@ -741,12 +798,12 @@ - &true; para seguir qualquer cabeçalho - "Location: " que o servidor envia como + Defina como &true; para seguir qualquer cabeçalho Location: que o servidor envia como parte do cabeçalho HTTP. Consulte também CURLOPT_MAXREDIRS. Esta constante não está disponível quando open_basedir está habilitada. + Disponível a partir do cURL 7.1.0. @@ -757,8 +814,9 @@ - &true; para força a conexão a ser fechada + Defina como &true; para forçar a conexão a ser fechada explicitamente ao terminar o processamento, e não ser enfileirada para reúso. + Disponível a partir do cURL 7.7.0. @@ -769,8 +827,9 @@ - &true; para forçar o uso de uma nova conexão + Defina como &true; para forçar o uso de uma nova conexão ao invés de uma em cache. + Disponível a partir do cURL 7.7.0. @@ -781,8 +840,9 @@ - &true; para anexar ao arquivo remoto ao invés de + Defina como &true; para anexar ao arquivo remoto ao invés de sobrescrevê-lo. + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.16.4. @@ -795,6 +855,9 @@ Um apelido para CURLOPT_TRANSFERTEXT. Use este último. + Disponível a partir do cURL 7.1, descontinuada a partir do cURL 7.11.1 + e pela última vez disponível no cURL 7.15.5. + Removida a partir do PHP 7.3.0. @@ -805,8 +868,8 @@ - &true; para apenas listar os nomes de um diretório - FTP. + Defina como &true; para apenas listar os nomes de um diretório FTP. + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.16.4. @@ -817,12 +880,13 @@ - O valor que será usado para obter o endereço IP a ser usado - para a instrução FTP "PORT". A instrução "PORT" solicita + Uma string que será usada para obter o endereço IP para a instrução FTP PORT. A instrução PORT solicita ao servidor remoto que se conecte ao endereço IP especificado. A - string pode ser um endereço IP puro, um nome de servidor, um nome - de interface de rede (no Unix), ou apenas um hífen '-' para usar o - endereço IP padrão do sistema. + string pode ser um endereço IP puro, um nome de servidor, + um nome de interface de rede (no Unix), + ou apenas um hífen - para usar o endereço IP padrão do sistema. + Esta opção aceita uma string ou &null;. + Disponível a partir do cURL 7.1.0. @@ -833,10 +897,9 @@ - O método de autenticação FTP (quando ativado): - CURLFTPAUTH_SSL (tentar SSL primeiro), - CURLFTPAUTH_TLS (tentar TLS primeiro) ou - CURLFTPAUTH_DEFAULT (deixar o cURL decidir). + Define o método de autenticação FTP sobre SSL (se ativado) para qualquer das + constantes CURLFTPAUTH_*. + O padrão é CURLFTPAUTH_DEFAULT. Disponível a partir do cURL 7.12.2. @@ -877,8 +940,9 @@ - &true; para criar diretórios ausentes quando uma operação FTP + Defina como &true; para criar diretórios ausentes quando uma operação FTP encontrar um caminho que não existe atualmente. + Disponível a partir do cURL 7.10.7. @@ -889,11 +953,9 @@ - Informa ao curl que método deve ser usado para alcançar um arquivo em um servidor FTP(S). Valores possíveis são - CURLFTPMETHOD_DEFAULT, - CURLFTPMETHOD_MULTICWD, - CURLFTPMETHOD_NOCWD e - CURLFTPMETHOD_SINGLECWD. + Informa ao cURL que método deve ser usado para alcançar um arquivo em um servidor FTP(S). Valores possíveis são + quaisquer das constantes CURLFTPMETHOD_*. + O padrão é CURLFTPMETHOD_MULTICWD. Disponível a partir do cURL 7.15.1. @@ -924,7 +986,7 @@ em sua resposta 227 ao comando PASV do cURL, mas usará o endereço IP usado para o conexão. O número da porta recebido da resposta 227 não será ignorado pelo cURL. - O padrão é 1 a partir do cURL 7.74.0 + O padrão é 1 a partir do cURL 7.74.0. e 0 antes disso. Disponível a partir do cURL 7.15.0. @@ -937,7 +999,7 @@ - + Disponível a partir do cURL 7.11.0 e descontinuada a partir do cURL 7.16.4. @@ -964,9 +1026,9 @@ - &true; para usar EPRT (e LPRT) ao realizar downloads - FTP ativos. Use &false; para desabilitar EPRT e LPRT e usar PORT - somente. + Defina como &true; para usar EPRT (e LPRT) ao realizar downloads + FTP ativos. Use &false; para desabilitar EPRT e LPRT e usar PORT somente. + Disponível a partir do cURL 7.10.5. @@ -977,9 +1039,9 @@ - &true; para primeiro tentar um comando EPSV para transferências - FTP antes de reverter para PASV. Defina para &false; - para desabilitar EPSV. + Defina como &true; para primeiro tentar um comando EPSV para transferências FTP antes de reverter para PASV. + Defina como &false; para desabilitar EPSV. + Disponível a partir do cURL 7.9.2. @@ -1025,8 +1087,9 @@ Tempo para o IPv6 começar à frente no algoritmo "happy eyeballs". Este algoritmo tenta a conexão simutânea a endereços IPv4 e IPv6 para servidores de pilha dupla, preferindo IPv6 primeiro pelo tempo especificado em milissegundos. - O padrão é CURL_HET_DEFAULT, que atualmente é de 200 milissegundos. - Disponível a partir do PHP 7.3.0 e cURL 7.59.0 + O padrão é CURL_HET_DEFAULT, que atualmente é de 200 milissegundos. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do PHP 7.3.0 e cURL 7.59.0. @@ -1037,9 +1100,9 @@ - &true; para enviar um cabeçalho de protocolo HAProxy v1 no início da conexão. + Defina como &true; para enviar um cabeçalho de protocolo PROXY HAProxy v1 no início da conexão. A ação padrão é não enviar este cabeçalho. - Disponível a partir do PHP 7.3.0 e cURL 7.60.0 + Disponível a partir do PHP 7.3.0 e cURL 7.60.0. @@ -1050,7 +1113,9 @@ - &true; para incluir o cabeçalho na saída. + Defina como &true; para incluir o cabeçalho na saída enviada à função de retorno + definida por CURLOPT_WRITEFUNCTION. + Disponível a partir do cURL 7.1.0. @@ -1061,11 +1126,32 @@ - Uma função de retorno que aceita dois parâmetros. - O primeiro é o recurso cURL, o segundo é uma - string com os dados de cabeçalho a serem escritos. Os dados de cabeçalho precisam - ser escritos por esta função. Retorna o número de - bytes escritos. + Uma função de retorno do tipo callable com a seguinte assinatura: + + intcallback + resourcecurlHandle + stringheaderData + + + + curlHandle + + + O identificador cURL. + + + + + headerData + + + Os dados de cabeçalho que precisam ser escritos pela função. + + + + + A função deve retornar o número de bytes escritos. + Disponível a partir do cURL 7.7.2. @@ -1076,10 +1162,12 @@ - Valores possíveis são CURLHEADER_UNIFIED ou CURLHEADER_SEPARATE. + Evia cabeçalhos HTTP tanto para prooxy quanto para host, ou separadamente. + Valores possíveis são quaisquer + das constantes CURLHEADER_*. O padrão é CURLHEADER_SEPARATE a partir do cURL 7.42.1, e CURLHEADER_UNIFIED antes dessa versão. - Disponível a partir do PHP 7.0.7 e cURL 7.37.0 + Disponível a partir do PHP 7.0.7 e cURL 7.37.0. @@ -1090,8 +1178,10 @@ - Nome do arquivo de cache HSTS (HTTP Strict Transport Security). - Disponível a partir do PHP 8.2.0 e cURL 7.74.0 + Uma string com o nome do arquivo de cache HSTS (HTTP Strict Transport Security). + ou &null; para permitir HSTS sem ler ou escrever em qualuqer arquivo + e limpar a lista de arquivos dos quais os dados HSTS são lidos. + Disponível a partir do PHP 8.2.0 e cURL 7.74.0. @@ -1102,11 +1192,9 @@ - Controla o comportamento HSTS (HTTP Strict Transport Security). Popula a máscara de bits com o conjunto correto de - recursos para instruir o cURL sobre como lidar com HSTS para as transferências usando este identificador. - CURLHSTS_ENABLE habilita o cache HSTS em memória. Se o arquivo de cache HSTS estiver definido, - defina CURLHSTS_READONLYFILE para torná-lo somente-leitura. - Disponível a partir do PHP 8.2.0 e cURL 7.74.0 + Aceita uma máscara de bits de recursos HSTS (HTTP Strict Transport Security) + definidos pelas constantes CURLHSTS_*. + Disponível a partir do PHP 8.2.0 e cURL 7.74.0. @@ -1117,9 +1205,9 @@ - Informa se respostas HTTP/0.9 são permitidas. O padrão é &false; a partir da libcurl 7.66.0; + Informa se respostas HTTP/0.9 são permitidas. O padrão é &false; a partir do cURL 7.66.0; anteriormente o padrão era &true;. - Disponível a partir do PHP 7.3.15 e 7.4.3, respectivamente, e cURL 7.64.0 + Disponível a partir do PHP 7.3.15 e 7.4.3, respectivamente, e cURL 7.64.0. @@ -1130,8 +1218,7 @@ - Um array de respostas HTTP 200 que serão tratadas como respostas - válidas e não como erros. + Um array de respostas HTTP 200 que serão tratadas como respostas válidas e não como erros. Disponível a partir do cURL 7.10.3. @@ -1143,21 +1230,23 @@ - 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 e - CURLAUTH_ANYSAFE. - O operador binário | (OU) pode ser usado para combinar - mais de um método. Se isto for feito, o cURL irá consultar o servidor para ver + Uma máscara de bits dos 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 + CURLAUTH_ANYSAFE + . + Se mais de um método for usado, o cURL irá consultar o servidor para ver que métodos ele suporta e escolherá o melhor. CURLAUTH_ANY liga todos os bits. O cURL selecionará automaticamente o que ele considerar o mais seguro. CURLAUTH_ANYSAFE liga todos os bits exceto o CURLAUTH_BASIC. O cURL selecionará automaticametne o que ele considerar o mais seguro. + Disponível a partir do cURL 7.10.6. @@ -1168,9 +1257,9 @@ - &true; para redefinir o método de requisição HTTP para GET. - Como GET é o padrão, isto somente é necessário se o método - de requisião tiver sido alterado. + Defina como &true; para redefinir o método de requisição HTTP para GET. Como GET é o padrão, isto somente é necessário se o método + de requisição tiver sido alterado. + Disponível a partir do cURL 7.8.1. @@ -1181,10 +1270,11 @@ - Um array de campos de cabeçalho HTTP a definir, no formato + Um array de campos de cabeçalho HTTP a definir, no formato array('Content-type: text/plain', 'Content-length: 100') + Disponível a partir do cURL 7.1.0. @@ -1195,7 +1285,8 @@ - &true; para encapsular através de um determinado proxy HTTP. + Defina como &true; para encapsular através de um determinado proxy HTTP. + Disponível a partir do cURL 7.3.0. @@ -1234,14 +1325,10 @@ - CURL_HTTP_VERSION_NONE (padrão, deixa o CURL - decidir que 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 (apelido para CURL_HTTP_VERSION_2_0), - CURL_HTTP_VERSION_2TLS (tenta HTTP 2 sobre TLS (HTTPS) somente) ou - CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (emite requisições HTTP não-TLS usando HTTP/2 sem HTTP/1.1 Upgrade). + Defina para uma das contantes + CURL_HTTP_VERSION_* + para que o CURL use a versão especificada. + Disponível a partir do cURL 7.9.1. @@ -1267,7 +1354,10 @@ - O arquivo a ser lido pela transferência durante o envio. + Aceita um resource identificador do arquivo + a ser lido pela transferência durante o envio. + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.9.7. + Use CURLOPT_READDATA em seu lugar. @@ -1279,9 +1369,11 @@ O tamanho esperado do arquivo, em bytes, ao enviá-lo a - um servidor remoto. Observe que usar esta opção não impedirá que a libcurl + um servidor remoto. Observe que usar esta opção não impedirá que o cURL envie mais dados, já que o que exatamente será enviado depende de CURLOPT_READFUNCTION. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.1.0. @@ -1292,8 +1384,9 @@ - O nome da interface de rede de saída a ser usada. Isto pode ser um - nome de interface, um endereço IP ou um nome de servidor. + Aceita uma string com 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 servidor. + Disponível a partir do cURL 7.1.0. @@ -1306,11 +1399,10 @@ Permite que uma aplicação selecione que tipo de endereço IP deve ser usado ao resolver nomes de servidor. Isto é interessante somente ao usar nomes de servidor - resolvam endereços usando mais que uma versão de IP, valores possíveis são - CURL_IPRESOLVE_WHATEVER, - CURL_IPRESOLVE_V4, - CURL_IPRESOLVE_V6, por padrão - CURL_IPRESOLVE_WHATEVER. + resolvam endereços usando mais que uma versão de IP. + Defina para uma das constantes + CURL_IPRESOLVE_*. + O padrão é CURL_IPRESOLVE_WHATEVER. Disponível a partir do cURL 7.10.8. @@ -1340,7 +1432,9 @@ - Certificado SSL do emissor a partir do blob de memória. + Passe uma string com dados binários de um certificado de CA SSL no formato PEM. + Se definida, uma verificação adicional do certtificado do par é realizada + para verificar se o emissor é o associado com o certificado fornecido pela opção. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -1352,11 +1446,11 @@ - &true; para continuar enviando o corpo da requisição se o código HTTP retornado for - igual ou maior que 300. A ação padrão seria parar o envio - e fechar o fluxo ou conexão. Adequado para autenticação NTLM manual. + Defina como &true; para continuar enviando o corpo da requisição se o código HTTP retornado for igual ou maior que 300. + A ação padrão seria parar o envio + e fechar o fluxo ou a conexão. Adequado para autenticação NTLM manual. A maior parte das aplicações não precisa desta opção. - Disponível a partir do PHP 7.3.0 e cURL 7.51.0 + Disponível a partir do PHP 7.3.0 e cURL 7.51.0. @@ -1367,9 +1461,10 @@ - A senha requerida para usar a chave privada CURLOPT_SSLKEY + Aceita uma string com a senha requerida para usar a chave privada CURLOPT_SSLKEY ou CURLOPT_SSH_PRIVATE_KEYFILE. - Disponível a partir do cURL 7.16.1. + Definir esta opção para &null; desabilita o uso de uma senha para estas opções. + Disponível a partir do cURL 7.17.0. @@ -1380,16 +1475,19 @@ - O nível de segurança KRB4 (Kerberos 4). Qualquer dos valores a seguir é válido + O nível de segurança KRB4 (Kerberos 4). Qualquer dos valores string a seguir é válido (na ordem do menos para o mais potente): - "clear", - "safe", - "confidential", - "private".. - Se a string não corresponder a uma dessas opções, - "private" é usada. Definir esta opção para &null; + + clear + safe + confidential + private + . + Se a string não corresponder a uma dessas opções, + private é usada. Definir esta opção como &null; irá desabilitar a segurança KRB4. Atualmente, a segurança KRB4 funciona somente com transações FTP. + Disponível a partir do cURL 7.3.0 e descontinuada a partir do cURL 7.17.0. @@ -1407,8 +1505,7 @@ safe confidential private - - . + . Se a string estiver definida, mas não corresponder a nenhuma delas, private será usada. Definir esta opção como &null; desativará o suporte Kerberos para FTP. @@ -1454,10 +1551,9 @@ Pode ser usada para definir opções de login específicas do protocolo, tal como o - mecanismos preferível de autenticação via "AUTH=NTLM" ou "AUTH=*", - e deve ser usada em conjunto com a opção - CURLOPT_USERNAME option. - Disponível a partir do PHP 7.0.7 e cURL 7.34.0 + mecanismos preferível de autenticação via AUTH=NTLM ou AUTH=*, e deve ser usada em conjunto com a + opção CURLOPT_USERNAME. + Disponível a partir do PHP 7.0.7 e cURL 7.34.0. @@ -1471,6 +1567,8 @@ A velocidade de transferência, em bytes por segundo, em que a transferência deve ficar abaixo durante a contagem de CURLOPT_LOW_SPEED_TIME segundos antes que o PHP considere que a transferência está muito lenta e aborte. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.1.0. @@ -1484,6 +1582,8 @@ 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. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.1.0. @@ -1546,7 +1646,15 @@ - Disponível a partir do PHP 8.2.0 e cURL 7.69.0 + Defina como 1 para permitir que o comando RCPT TO + falhe para alguns destinatários, o que faz com que o cURL ignore erros + para destinatários individuais e proceda com os destinatários aceitos remanescentes. + Se todos os destinatários aivarem falhas e esta opção estiver especificada, + o cURL aborta a conversação SMTP + e retorna o erro recebido do último comando RCPT TO. + Substituído pela CURLOPT_MAIL_RCPT_ALLOWFAILS a partir do cURL 8.2.0. + Disponível a partir do PHP 8.2.0 e cURL 7.69.0. + Descontinuada a partir do cURL 8.2.0. @@ -1558,8 +1666,9 @@ O tempo máximo ocioso permitido para que uma conexão existente possa ser considerada para reúso. - O tempo máximo padrão é de 118 segundos - Disponível a partir do PHP 8.2.0 e cURL 7.65.0 + O tempo máximo padrão é de 118 segundos. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do PHP 8.2.0 e cURL 7.65.0. @@ -1573,6 +1682,8 @@ A quantidade máxima permitida de conexões persistentes. Quando o limite é atingido, a mais antiga no cache é fechada para evitar o aumento do número de conexões abertas. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.7.0. @@ -1613,7 +1724,8 @@ a transferência não iniciará e CURLE_FILESIZE_EXCEEDED será retornada. O tamanho do arquivo nem sempre é conhecido antes da transferência, para esses casos esta opção não tem efeito mesmo que a transferência termine sendo maior que este limite informado. - Disponível a partir do PHP 8.2.0 e cURL 7.11.0 + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do PHP 8.2.0 e cURL 7.11.0. @@ -1627,8 +1739,9 @@ O tempo máximo em segundos, desde a criação da conexão, permitido para que uma conexão existente possa ser considerada para reúso. Se uma conexão no cache for mais antiga que este valor, ela será fechada assim que as transferências em progresso terminem. - O padrão é 0 segundo, o que significa que a opção está desabilitada e todas as conexões são elegíveis para reúso. - Disponível a partir do PHP 8.2.0 e cURL 7.80.0 + O padrão é 0 segundo, o que significa que a opção está desabilitada e todas as conexões são elegíveis para reúso. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do PHP 8.2.0 e cURL 7.80.0. @@ -1639,11 +1752,10 @@ - A quantidade máxima de redirecionamentos HTTP a seguir. Esta opção deve ser usada - junto com CURLOPT_FOLLOWLOCATION. + A quantidade máxima de redirecionamentos HTTP a seguir. Esta opção deve ser usada junto com CURLOPT_FOLLOWLOCATION. O valor padrão de 20 está definido para evitar redirecionamentos infinitos. - Definir para -1 permite redirecionamentos infinitos e 0 - recusa todos os redirecionamentos. + Definir para -1 permite redirecionamentos infinitos e 0 recusa todos os redirecionamentos. + Disponível a partir do cURL 7.5.0. @@ -1658,7 +1770,8 @@ média cumulativa durante a transferência, ela será pausada para manter a média abaixo ou igual ao valor do parâmetro. O padrão é velocidade ilimitada. - Disponível a partir do cURL 7.15.5 + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.15.5. @@ -1673,7 +1786,8 @@ média cumulativa durante a transferência, ela será pausada para manter a média abaixo ou igual ao valor do parâmetro. O padrão é velocidade ilimitada. - Disponível a partir do cURL 7.15.5 + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.15.5. @@ -1684,7 +1798,10 @@ - Disponível a partir do PHP 8.3.0 e cURL 7.81.0 + Defina como uma máscara de bits das constantes CURLMIMEOPT_*. + Atualmente, há apenas uma opção disponível: + CURLMIMEOPT_FORMESCAPE. + Disponível a partir do PHP 8.3.0 e cURL 7.81.0. @@ -1695,9 +1812,12 @@ - &true; para manter silêncio completo no que se refere + Defina como &true; para manter silêncio completo no que se refere às funções cURL. - Removido a partir do cURL 7.15.5; use CURLOPT_RETURNTRANSFER em seu lugar. + Use CURLOPT_RETURNTRANSFER em seu lugar. + Disponível a partir do cURL 7.1.0, descontinuada a partir do cURL 7.8.0 + e pela última vez disponível no cURL 7.15.5. + Removida a partir do PHP 7.3.0. @@ -1708,9 +1828,10 @@ - &true; para ler o arquivo ~/.netrc + Defina como &true; para ler o arquivo ~/.netrc buscando usuário e senha para o servidor remoto com o qual a conexão está sendo estabelecida. + Disponível a partir do cURL 7.1.0. @@ -1768,9 +1889,11 @@ - &true; para excluir o corpo da saída. - O método de requisição é definido para HEAD. Mudar para &false; não - muda para GET. + Defina como &true; para excluir o corpo da saída. + Para HTTP(S), o cURL faz uma requisição HEAD. Para quase todos os outros protocolos, + o cURL não solicita os dados do corpo de nenhuma forma. + Alterar esta opção para &false; resultará na inclusão dos dados do corpo na saída. + Disponível a partir do cURL 7.1.0. @@ -1781,13 +1904,14 @@ - &true; para desabilitar a medição de progresso para transferências cURL. + Defina como &true; para desabilitar a medição de progresso para transferências cURL. O PHP define automaticamente esta opção para &true;, ela só deve ser alterada para depuração. + Disponível a partir do cURL 7.1.0. @@ -1833,10 +1957,42 @@ - Uma função de retorno que aceita três parâmetros. - O primeiro é o recurso cURL, o segundo é uma - string contendo um texto solicitando senha e o terceiro é o comprimento - máximo da senha. Retorna a string contendo a senha. + Uma função de retorno do tipo callable com a seguinte assinatura: + + stringcallback + resourcecurlHandle + stringpasswordPrompt + intmaximumPasswordLength + + + + curlHandle + + + O identificador cURL. + + + + + passwordPrompt + + + Uma string contendo um texto solicitando senha. + + + + + maximumPasswordLength + + + Comprimento máximo da senha. + + + + + A função deve retornar uma string contendo a senha. + Disponível a partir do cURL 7.4.2, descontinuada a partir do cURL 7.11.1 + e pela última vez disponível no cURL 7.15.5. Removida a partir do PHP 7.3.0. @@ -1848,7 +2004,7 @@ - A senha a ser usada na autenticação. + Aceita uma string com a senha a ser usada na autenticação. Disponível a partir do cURL 7.19.1. @@ -1860,8 +2016,11 @@ - &true; para não lidar com sequências de ponto-ponto (..). - Disponível a partir do PHP 7.0.7 e cURL 7.42.0 + Defina como &true; para que o cURL não altere caminhos URL antes de encaminhá-los ao servidor. + O padrão é &false;, que resolve as expressões /../ + ou /./ que possam existir na parte do caminho da URL + que deveriam ser removidas de acordo com a RFC 3986 seção 5.2.4. + Disponível a partir do PHP 7.0.7 e cURL 7.42.0. @@ -1872,12 +2031,12 @@ - Define a chave pública fixada. - A string pode ser o nome do arquivo da chave pública fixada. O formato - esperado do arquivo é "PEM" ou "DER". A string também pode ser qualquer - número de hashes sha256 codificadas em base 64 precedidas por "sha256//" e - separadas por ";". - Disponível a partir do PHP 7.0.7 e cURL 7.39.0 + Define uma string com a chave pública fixada. + A string pode ser o nome do arquivo da chave pública fixada + no formato PEM ou DER. A string também pode ser qualquer + número de hashes sha256 codificadas em base 64 precedidas por sha256// e + separadas por ;. + Disponível a partir do PHP 7.0.7 e cURL 7.39.0. @@ -1888,7 +2047,9 @@ - &true; para esperar por sequenciamento/multiplexação. + Defina como &true; para esperar que uma conexão existente confirme + que pode fazer multiplexação e fazer uso dela, + antes de criar e utilizar uma nova conexão. Disponível a partir do PHP 7.0.7 e cURL 7.43.0 @@ -1900,7 +2061,9 @@ - Um número alternativo de porta para conexão. + Um int com um número alternativo de porta para conexão + ao invés da porta especificada na URL ou da porta padrão para o protocolo usado. + Disponível a partir do cURL 7.1.0. @@ -1911,9 +2074,10 @@ - &true; para fazer um POST HTTP comum. Este POST é do - tipo application/x-www-form-urlencoded normal, - mais comumente usado por formulários HTML. + Defina como &true; para fazer uma requisição POST HTTP. + Esta requisição usa o cabeçalho application/x-www-form-urlencoded. + O padrão é &false;. + Disponível a partir do cURL 7.1.0. @@ -1924,15 +2088,16 @@ - Os dados completos para enviar em uma operação "POST" HTTP. + Os dados completos para enviar em uma operação POST HTTP. Este parâmetro pode ser - passado como uma string codificada em URL como 'para1=val1&para2=val2&...' - ou como um array com o nome do campo como chave e o dado do campo como valor. - Se value for um array, o + passado como uma string codificada em URL como 'para1=val1&para2=val2&...' + ou como um array com o nome do campo como chave e o dado do campo como valor. + Se value for um array, o cabeçalho Content-Type será definido para multipart/form-data. Arquivos podem ser enviados usando CURLFile ou CURLStringFile, - onde value precisa ser um array. + onde value precisa ser um array. + Disponível a partir do cURL 7.1.0. @@ -1943,8 +2108,9 @@ - Um array de comandos FTP a executar no servidor depois que a requisição - FTP tenha sido realizada. + Um array de strings de comandos FTP + a executar no servidor depois que a requisição FTP tenha sido realizada. + Disponível a partir do cURL 7.1.0. @@ -1955,8 +2121,9 @@ - Uma máscara de bits de 1 (301 Movido Permanentemente), 2 (302 Encontrado) - e 4 (303 Veja Outro) se o método POST HTTP deve ser mantido + Uma máscara de bits de CURL_REDIR_POST_301, + CURL_REDIR_POST_302 e CURL_REDIR_POST_303 + se o método POST HTTP deve ser mantido quando CURLOPT_FOLLOWLOCATION estiver definida e um tipo específico de redirecionamento ocorrer. Disponível a partir do cURL 7.19.1. @@ -1971,18 +2138,18 @@ Define uma string contendo o nome do servidor ou endereço IP - numérico com pontos a ser usado como o pré-proxy ao qual o curl se conecta antes + numérico com pontos 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 requisição. O pré-proxy somente pode ser um proxy SOCKS e deve ser prefixado com [esquema]:// para especificar que tipo de socks é utilizado. Um endereço numérico IPv6 precisa ser escrito entre [colchetes]. - Definir o pré-proxy para uma string vazia desabilita explicitamente o uso de um pré-proxy. - Para especificar o número da porta nesta string, adicione :[porta] + Definir o pré-proxy para uma string vazia desabilita explicitamente o uso de um pré-proxy. + Para especificar o número da porta nesta string, adicione :[porta] ao final do nome do servidor. O número da porta do proxy opcionalmente pode ser especificado coma opção separada CURLOPT_PROXYPORT. O padrão é usar a porta 1080 para proxies se não for especificada. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2025,21 +2192,67 @@ - Uma função de retorno que aceita cinco parâmetros. - O primeiro é um recurso cURL, o segundo é o número total de - bytes esperados no recebimento desta transferência, o terceiro é - o número de bytes já recebidos, o quarto é o número - total de bytes esperados no envio desta transferência e o - quinto é o número de bytes já enviados. + Uma função de retorno do tipo callable com a seguinte assinatura: + + intcallback + resourcecurlHandle + intbytesToDownload + intbytesDownloaded + intbytesToUpload + intbytesUploaded + + + + curlHandle + + + O identificador cURL. + + + + + bytesToDownload + + + O número total de bytes esperados no recebimento desta transferência. + + + + + bytesDownloaded + + + O número de bytes já recebidos. + + + + + bytesToUpload + + + O número total de bytes esperados no envio desta transferência. + + + + + bytesUploaded + + + O número de bytes já enviados. + + + + + A função deve retornar um int com um valor diferente de zero para abortar a transferência + e definir um erro CURLE_ABORTED_BY_CALLBACK. A função de retorno é chamada somente quando a opção CURLOPT_NOPROGRESS estiver definida para &false;. - Retorne um valor não-zero para abortar a transferência. Neste caso, a - transferência definirá um erro - CURLE_ABORTED_BY_CALLBACK. + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.32.0. + Use CURLOPT_XFERINFOFUNCTION em seu lugar. @@ -2050,28 +2263,11 @@ - Uma máscara de bits de valores CURLPROTO_*. Se usada, esta máscara - limita que protocolos a libcurl pode usar na transferência. Isto permite que se tenha - uma libcurl construída para suportar uma ampla gama de protocolos mas ainda limitar transferências - específicas para que possam usar somente um subconjunto deles. Por padrão, a libcurl irá - aceitar todos os protocolos que ela suporta. + Uma máscara de bits de valores CURLPROTO_*. + Se usada, esta máscara limita que protocolos a libcurl pode usar na transferência. + O padrão é CURLPROTO_ALL, ou seja, o cURL aceitará todos os protocolos suportados. Consulte também CURLOPT_REDIR_PROTOCOLS. - Opções válidas de protocolo 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 e - CURLPROTO_ALL. - Disponível a partir do cURL 7.19.4. + Disponível a partir do cURL 7.19.4 e descontinuada a partir do cURL 7.85.0. @@ -2082,7 +2278,46 @@ - Disponível a partir do PHP 8.3.0 e cURL 7.85.0 + Defina para uma string com uma lista de nomes de protocolos + (esquemas de URL) a serem permitidos na transferência, separados por vírgula, insensíveis a maiúsculas/minúsculas. + Defina como ALL para habilitar todos os protocolos. + Por padrão, o cURL aceita todos os protocolos com os quais foi compilado para suportar. + Os protocolos disponíveis são: + + DICT + FILE + FTP + FTPS + GOPHER + GOPHERS + HTTP + HTTPS + IMAP + IMAPS + LDAP + LDAPS + MQTT + POP3 + POP3S + RTMP + RTMPE + RTMPS + RTMPT + RTMPTE + RTMPTS + RTSP + SCP + SFTP + SMB + SMBS + SMTP + SMTPS + TELNET + TFTP + WS + WSS + . + Disponível a partir do PHP 8.3.0 e do cURL 7.85.0. @@ -2093,7 +2328,10 @@ - O proxy HTTP através do qual as requisições serão enviadas. + Uma string com o proxy HTTP através do qual as requisições serão enviadas. + Deve ser o nome do host, o endereço IP numérico com pontos + ou um endereço IPv6 numérico escrito entre [colchetes]. + Disponível a partir do cURL 7.1.0. @@ -2104,11 +2342,12 @@ - O(s) método(s) de autenticação para usar na conexão ao proxy. - Use as mesmas máscaras de bits descritas em - CURLOPT_HTTPAUTH. Para autenticação no proxy, - somente CURLAUTH_BASIC e + Uma máscara de bits dos método(s) de autenticação + (constantes CURLAUTH_*) + para usar na conexão ao proxy. + Para autenticação no proxy, somente CURLAUTH_BASIC e CURLAUTH_NTLM são suportadas atualmente. + O padrão é CURLAUTH_BASIC. Disponível a partir do cURL 7.10.7. @@ -2120,8 +2359,8 @@ - Um array de cabeçalhos HTTP customizados para passar aos proxies. - Disponível a partir do PHP 7.0.7 e cURL 7.37.0 + Um array de strings de cabeçalhos HTTP customizados para passar aos proxies. + Disponível a partir do PHP 7.0.7 e cURL 7.37.0. @@ -2144,8 +2383,11 @@ - O número da porta do proxy para conexão. Este número de porta também - pode ser definido em CURLOPT_PROXY. + Um int com o número da porta do proxy para conexão. + Este número de porta também pode ser definido em CURLOPT_PROXY. + Definir como zero faz com que o cURL use o número de porta do proxy padrão + ou o número de porta especificado na string do URL do proxy. + Disponível a partir do cURL 7.1.0. @@ -2156,11 +2398,9 @@ - Pode ser CURLPROXY_HTTP (padrão), - CURLPROXY_SOCKS4, - CURLPROXY_SOCKS5, - CURLPROXY_SOCKS4A ou - CURLPROXY_SOCKS5_HOSTNAME. + Define o tipo do proxy, que pode ser uma das constantes + CURLPROXY_*. + O padrão é CURLPROXY_HTTP. Disponível a partir do cURL 7.10. @@ -2184,9 +2424,10 @@ - Um nome de usuário e senha formatados como - "[usuário]:[senha]" para usar na + Uma string com usuário e senha formatados como + [usuário]:[senha] para usar na conexão ao proxy. + Disponível a partir do cURL 7.1.0. @@ -2201,9 +2442,9 @@ string com o nome do arquivo que contém um ou mais certificados com os quais o prohy HTTPS será verificado. Esta opção é para conexão a um proxy HTTPS, não a um servidor HTTPS. - O padrão é o caminho do sistema onde espera-se que o pacote de certificados da libcurl esteja - armazanado. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + O padrão é o caminho do sistema onde espera-se que o pacote de certificados CA do cURL esteja + armazenado. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2214,11 +2455,11 @@ - O nome de um arquivo PEM contendo um ou mais certificados com os quais o proxy HTTPS será verificado. + Uma string com o nome de um arquivo PEM contendo um ou mais certificados com os quais o proxy HTTPS será verificado. Esta opção é para conexão a um proxy HTTPS, não a um servidor HTTPS. - O padrão é o caminho do sistema onde espera-se que o pacote de certificados da libcurl esteja - armazanado. - Disponível a partir do PHP 8.2.0 e cURL 7.77.0 + O padrão é o caminho do sistema onde espera-se que o pacote de certificados CA do cURL esteja + armazenado. + Disponível a partir do PHP 8.2.0 e cURL 7.77.0. @@ -2229,8 +2470,9 @@ - O diretório que contém múltiplos certificados CA com os quais o proxy HTTPS será verificado. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Uma string com o diretório que contém múltiplos certificados CA + com os quais o proxy HTTPS será verificado. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2241,10 +2483,11 @@ - Define o nome do arquivo com a concatenação de CRL (Lista de Revogação de Certificado) + Defina como uma string com o nome do arquivo + com a concatenação de CRL (Lista de Revogação de Certificado) no formato PEM a ser usado na validação de certificado que ocorre durante a troca de informações SSL. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2255,7 +2498,7 @@ - Nome do arquivo do certificado SSL do emissor do proxy. + Uma string com o nome do arquivo do certificado SSL do emissor do proxy. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -2267,7 +2510,7 @@ - Certificado SSL do emissor do proxy do blob de memória. + Uma string com o certificado SSL do emissor do proxy. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -2279,11 +2522,12 @@ - Define a string a ser usada como a senha necessária para usar a - chave privada CURLOPT_PROXY_SSLKEY. Nunca é necessária uma - senha para carregar um certificado, mas será necessária uma para carregar a chave privada. + Define a string a ser usada como a senha necessária para usar a + chave privada CURLOPT_PROXY_SSLKEY. + Nunca é necessária uma senha para carregar um certificado, + mas será necessária uma para carregar a chave privada. Esta opção é para conexão a um proxy HTTPS, não a um servidor HTTPS. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2294,11 +2538,13 @@ - Define a chave pública fixada para o proxy HTTPS. A string pode ser o nome do arquivo - da 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 a partir do PHP 7.3.0 e cURL 7.52.0 + Define a chave pública fixada para o proxy HTTPS. + A string pode ser o nome do arquivo da chave pública fixada + com formato esperado de PEM + ou DER. + A string também pode ser qualquer número de hashes sha256 codificados em base64 + precedidas por sha256// e separadas por ;. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2309,7 +2555,7 @@ - O nome do serviço de autenticação de proxy. + Uma string com o nome do serviço de autenticação de proxy. Disponível a partir do PHP 7.0.7, cURL 7.43.0 (para proxies HTTP) e cURL 7.49.0 (para proxies SOCKS5). @@ -2321,14 +2567,15 @@ - O nome do arquivo do certificado de cliente usado para conectar-se ao proxy HTTPS. - O formato padrão é "P12" no Transporte Seguro e "PEM" em outros mecanismos, + Uma string com o nome do arquivo do certificado de cliente usado para conectar-se ao proxy HTTPS. + O formato padrão é P12 no Transporte Seguro e PEM em outros mecanismos, e pode ser alterado com CURLOPT_PROXY_SSLCERTTYPE. Com NSS ou Transporte Seguro, este também pode ser o apelido do certificado - com o qual se deseja autenticar, conforme nomeado no banco de dados de segurança. - Se for pretendido usar um arquivo do diretório atual, deve ser precedido por - "./", para evitar confusão com um apelido. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + usado para autenticação, conforme nomeado no banco de dados de segurança. + Se for pretendido usar um arquivo do diretório atual, + deve ser precedido por ./ + para evitar confusão com um apelido. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2339,12 +2586,12 @@ - O formato do certificado de cliente usado ao conectar-se a um proxy HTTPS. - Os formatos suportados são "PEM" e "DER", exceto com Transporte Seguro. + Uma string com o formato do certificado de cliente usado ao conectar-se 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 Transporte Seguro - (no iOS 5 ou posterior, ou OS X 10.7 ou posterior) também suportam "P12" para - arquivos codificados em PKCS#12. O padrão é "PEM". - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + (no iOS 5 ou posterior, ou OS X 10.7 ou posterior) também suportam P12 para + arquivos codificados em PKCS#12. O padrão é PEM. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2355,7 +2602,7 @@ - Certificado de cliente proxy SSL do blob de memória. + Uma string com o certificado de cliente do proxy SSL. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -2367,11 +2614,13 @@ - O nome do arquivo da sua chave privada usada para conexão com o proxy HTTPS. - O formato padrão é "PEM" e pode ser alterado com + Uma string com o nome do arquivo da chave privada + usada para conexão com o proxy HTTPS. + O formato padrão é PEM e pode ser alterado com CURLOPT_PROXY_SSLKEYTYPE. - (somente iOS e Mac OS X) Esta opção será ignorada se o curl tiver sido compilado com Transporte Seguro. Disponível se compilado com TLS habilitado. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + (somente iOS e Mac OS X) Esta opção será ignorada se o cURL tiver sido compilado com + Transporte Seguro. Disponível se compilado com TLS habilitado. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2382,8 +2631,14 @@ - O formato da chave privada. Os formatos suportados são "PEM", "DER" e "ENG". - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Uma string com o formato da chave privada. + Os formatos suportados são: + + PEM + DER + ENG + . + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2394,7 +2649,7 @@ - Chave privada para certificado de proxy do blob de memória. + Uma string com a chave privada para conexão ao proxy HTTPS. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -2406,22 +2661,10 @@ - Uma destas 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 - - . + Define a versão do TLS do proxy HTTPS para uma das constantes + CURL_SSLVERSION_*. + O padrão é + CURL_SSLVERSION_DEFAULT. É melhor não definir esta opção e deixar o padrão @@ -2429,7 +2672,7 @@ que tentará descobrir a versão do protocolo SSL remoto. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2440,11 +2683,12 @@ - A lista de cifras a serem usadas para a conexão com o proxy HTTPS. - A lista deve estar sintaticamente correta e consiste em uma ou mais strings - de cifras separadas por dois pontos. Vírgulas ou espaços também são separadores aceitáveis, - mas normalmente são usados ​​dois pontos. "!", "-" e "+" podem ser usados ​​como operadores. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Uma string com a lista de cifras, separadas por dois-pontos (:), + a serem usadas para a conexão com o proxy HTTPS. + Quando usada com OpenSSL, vírgulas ou espaços também são separadores aceitáveis + e !, - e + + podem ser usados ​​como operadores. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2455,13 +2699,9 @@ - Define as opções de comportamento do proxy SSL, que é uma máscara de bits das seguintes constantes: - - CURLSSLOPT_ALLOW_BEAST - CURLSSLOPT_NO_REVOKE - CURLSSLOPT_NO_PARTIALCHAIN - - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Define as opções de comportamento do proxy SSL, que é uma máscara de bits das constantes + CURLSSLOPT_*. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2475,11 +2715,12 @@ Defina como 2 para verificar os campos de nome do certificado do proxy HTTPS em relação ao nome do proxy. Quando definido como 0 a conexão é bem-sucedida independentemente dos nomes usados ​​no certificado. Use essa capacidade com cuidado! - 1 tratado como uma opção de depuração no curl 7.28.0 e versões anteriores. - Do curl 7.28.1 a 7.65.3, CURLE_BAD_FUNCTION_ARGUMENT é retornado. - Do curl 7.66.0 em diante, 1 e 2 são tratados como o mesmo valor. - Em ambientes de produção o valor desta opção deve ser mantido em 2 (valor padrão). - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Se definida como 1 no cURL 7.28.0 e versões anteriores, serve como uma opção de depuração. + Se definida como 1 no cURL 7.28.1 ao 7.65.3, a constante CURLE_BAD_FUNCTION_ARGUMENT é retornada. + A partir do cURL 7.66.0, 1 e 2 são tratados como o mesmo valor. + O padrão é 2. + Em ambientes de produção, o valor desta opção deve ser mantido em 2. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2490,13 +2731,14 @@ - &false; para impedir que o cURL verifique o certificado do par. + Defina como &false; para impedir que o cURL verifique o certificado do par. Certificados alternativos para verificação podem ser especificados com a opção CURLOPT_CAINFO ou um diretório de certificado pode ser especificado com a opção CURLOPT_CAPATH. - Quando definido para false, a verificação do certificado será sempre bem-sucedida. &true; é o padrão. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Quando definida como &false;, a verificação do certificado será sempre bem-sucedida. + &true; é o padrão. + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2507,13 +2749,11 @@ - A lista de conjuntos de criptografia a serem usados ​​para a conexão TLS 1.3 com um proxy. - A lista deve estar sintaticamente correta e consiste em uma ou mais - sequências de conjuntos de cifras separadas por dois pontos. Esta opção é usada atualmente - apenas quando curl é compilado para usar OpenSSL 1.1.1 ou posterior. - Se um SSL diferente estiver sendo usado, pode-se tentar configurar - conjuntos de criptografia TLS 1.3 usando a opção CURLOPT_PROXY_SSL_CIPHER_LIST. Disponível quando compilado com OpenSSL >= 1.1.1. - Disponível a partir do PHP 7.3.0 e cURL 7.61.0 + Uma string com a lista de conjuntos de criptografia a serem usados ​​para a conexão TLS 1.3 com um proxy. + Esta opção é usada atualmente apenas quando o cURL é compilado para usar OpenSSL 1.1.1 ou posterior. + Se um SSL diferente estiver sendo usado, os conjuntos de criptografia TLS 1.3 podel ser configurados + com a opção CURLOPT_PROXY_SSL_CIPHER_LIST. + Disponível a partir do PHP 7.3.0 e cURL 7.61.0. @@ -2524,10 +2764,10 @@ - A senha a ser usada para o método de autenticação TLS especificado com a + Uma string com 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ção CURLOPT_PROXY_TLSAUTH_USERNAME também esteja definida. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2539,16 +2779,16 @@ O método de autenticação TLS usado para a conexão HTTPS. - O método suportado é "SRP". + O método suportado é SRP. 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, deve-se também definir as - opções CURLOPT_PROXY_TLSAUTH_USERNAME e - CURLOPT_PROXY_TLSAUTH_PASSWORD. + se ambos os lados tiverem um segredo compartilhado. Para usar TLS-SRP, as opções + CURLOPT_PROXY_TLSAUTH_USERNAME e + CURLOPT_PROXY_TLSAUTH_PASSWORD também precisam ser definidas. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2562,7 +2802,7 @@ O usuário a ser usado para o método de autenticação TLS especificado com a opção CURLOPT_PROXY_TLSAUTH_TYPE. Requer que a opção CURLOPT_PROXY_TLSAUTH_PASSWORD também esteja definida. - Disponível a partir do PHP 7.3.0 e cURL 7.52.0 + Disponível a partir do PHP 7.3.0 e cURL 7.52.0. @@ -2592,8 +2832,9 @@ &true; para usar o método PUT HTTP para um arquivo. O arquivo precisa ser - definido com CURLOPT_INFILE e + definido com CURLOPT_READDATA e CURLOPT_INFILESIZE. + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.12.1. @@ -2604,7 +2845,11 @@ - Disponível a partir do PHP 8.3.0 e cURL 7.87.0 + Defina como &true; para o cURL ignorar a etapa de limpeza de recursos + ao recuperar de um limite de tempo excedido. + Isto permite um encerramento rápido do processo cURL às + custas de um possível vazamento de recursos associados. + Disponível a partir do PHP 8.3.0 e cURL 7.87.0. @@ -2615,8 +2860,8 @@ - Um array de comandos FTP a executar no servidor antes da requisição - FTP. + Um array de strings de comandos FTP a executar no servidor antes da requisição FTP. + Disponível a partir do cURL 7.1.0. @@ -2627,7 +2872,8 @@ - Um nome de arquivo a ser usado para semear o gerador de números aleatórios para o SSL. + Uma string com o nome do arquivo a ser usado para semear o gerador de números aleatórios para o SSL. + Disponível a partir do cURL 7.7.0 e descontinuada a partir do cURL 7.84.0. @@ -2638,10 +2884,11 @@ - Faixa(s) de dados a buscar no formato - "X-Y" onde X ou Y são opcionais. Transferências HTTP + Uma string com o(s) intervalo(s) de dados a serem recuperados no formato X-Y onde X ou Y são opcionais. Transferências HTTP também suportam vários intervalos, separados por vírgulas no formato - "X-Y,N-M". + X-Y,N-M. + Defina como &null; para desabilitar a requisição de um intervalo de bytes. + Disponível a partir do cURL 7.1.0. @@ -2665,14 +2912,45 @@ - Uma função de retorno que aceita três parâmetros. - O primeiro é o recurso cURL, o segundo é um - recurso de fluxo fornecido ao cURL através da opção - CURLOPT_INFILE e o terceiro é a quantidade - máxima de dados a serem lidos. A função deve retornar uma string + Uma função de retorno do tipo callable com a seguinte assinatura: + + stringcallback + resourcecurlHandle + resourcestreamResource + intmaxAmountOfDataToRead + + + + curlHandle + + + O identificador cURL. + + + + + streamResource + + + resource de fluxo fornecido ao cURL através da opção + CURLOPT_READDATA. + + + + + maxAmountOfDataToRead + + + 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, - normalmente lendo-a do recurso de fluxo passado. Deve retornar - uma string vazia para sinalizar EOF. + normalmente lendo-a do resource de fluxo passado. Deve retornar + uma string vazia para sinalizar EOF. + Disponível a partir do cURL 7.1.0. @@ -2683,15 +2961,16 @@ - Máscara de bits de valores CURLPROTO_*. Se usada, esta máscara de bits - limita quais protocolos a libcurl pode usar em uma transferência que segue em + Máscara de bits de valores CURLPROTO_* + que limita quais protocolos o cURL pode usar em uma transferência que segue um redirecionamento quando CURLOPT_FOLLOWLOCATION está habilitado. - Isso permite que se limite transferências específicas para usar apenas um subconjunto - de protocolos em redirecionamentos. Por padrão, a libcurl permitirá todos os protocolos, - exceto FILE e SCP. Esta é uma diferença em comparação com as versões anteriores à 7.19.4 - que seguiriam incondicionalmente todos os protocolos suportados. + Isso permite limitar transferências específicas para usar apenas um subconjunto + de protocolos em redirecionamentos. + A partir do cURL 7.19.4, por padrão o cURL permitirá todos os protocolos, + exceto FILE e SCP. + Antes do cURL 7.19.4, o cURL seguiria incondicionalmente todos os protocolos suportados. Veja também CURLOPT_PROTOCOLS para valores constantes de protocolo. - Disponível a partir do cURL 7.19.4. + Disponível a partir do cURL 7.19.4 e descontinuada a partir do cURL 7.85.0. @@ -2702,6 +2981,53 @@ + Defina como uma string com uma lista de nomes de protocolos (esquemas URL), + insensíveis a maiúsculas/minúsculas, separados por vírgulas, + para permitir o seguimento de um redirecionamento quando + CURLOPT_FOLLOWLOCATION estiver habilitada. + Defina como ALL para habilitar todos os protocolos. + A partir do cURL 7.65.2, o padrão é FTP, + FTPS, HTTP e HTTPS. + Do cURL 7.40.0 até o 7.65.1, o padrão são todos os protocolos exceto + FILE, SCP, SMB e + SMBS. + Antes do cURL 7.40.0, o padrão são todos os protocolos exceto + FILE e SCP. + Os protocolos disponíveis são: + + DICT + FILE + FTP + FTPS + GOPHER + GOPHERS + HTTP + HTTPS + IMAP + IMAPS + LDAP + LDAPS + MQTT + POP3 + POP3S + RTMP + RTMPE + RTMPS + RTMPT + RTMPTE + RTMPTS + RTSP + SCP + SFTP + SMB + SMBS + SMTP + SMTPS + TELNET + TFTP + WS + WSS + . Disponível a partir do PHP 8.3.0 e cURL 7.85.0. @@ -2713,8 +3039,9 @@ - O conteúdo do cabeçalho "Referer: " a ser usado - em uma requisição HTTP. + Uma string com o conteúdo do cabeçalho Referer: + a ser usado em uma requisição HTTP. + Disponível a partir do cURL 7.1.0. @@ -2725,6 +3052,8 @@ + Uma string a ser usada na próxima requisição + em vez do caminho extraído do URL. Disponível a partir do PHP 7.3.0 e cURL 7.55.0. @@ -2736,11 +3065,13 @@ - Fornece um endereço personalizado para um par específico de servidor e porta. Um array - de strings de nome de servidor, porta e endereço IP, cada elemento separado por - dois pontos. No formato: + Forneça um array de strings com endereços + personalizados separados por dois-pontos para um par específico de servidor e porta no formato: - array("example.com:80:127.0.0.1") + array( + "example.com:80:127.0.0.1", + "example2.com:443:127.0.0.2", + ) Disponível a partir do cURL 7.21.3. @@ -2754,6 +3085,8 @@ O deslocamento, em bytes, a partir do qual uma transferência deve ser retomada. + Esta opção aceita qualquer valor que possa ser convertido para um int válido. + Disponível a partir do cURL 7.1.0. @@ -2764,7 +3097,7 @@ - &true; para retornar a transferência como uma string do + &true; para retornar a transferência como uma string do valor de retorno de curl_exec em vez de enviá-la diretamente. @@ -2884,11 +3217,11 @@ - A identidade de autorização (autzid) para a transferência. Aplicável apenas ao mecanismo de autenticação + A string de identidade de autorização (autzid) para a transferência. Aplicável apenas ao mecanismo de autenticação PLAIN SASL onde é opcional. Quando não especificada, apenas a identidade de autenticação (authcid) especificada pelo nome de usuário será enviada ao servidor, juntamente com a senha. O servidor derivará o authzid do authcid quando não for fornecido, que será usado internamente. - Disponível a partir do PHP 8.2.0 e cURL 7.66.0 + Disponível a partir do PHP 8.2.0 e cURL 7.66.0. @@ -2900,7 +3233,7 @@ &true; para habilitar o envio da resposta inicial no primeiro pacote. - Disponível a partir do PHP 7.0.7 e cURL 7.31.0 + Disponível a partir do PHP 7.0.7 e cURL 7.31.0. @@ -2911,8 +3244,8 @@ - O nome do serviço de autenticação. - Disponível a partir do PHP 7.0.7 e cURL 7.43.0 + Uma string com o nome do serviço de autenticação. + Disponível a partir do PHP 7.0.7 e cURL 7.43.0. @@ -2925,6 +3258,7 @@ Um resultado de curl_share_init. Faz com que o identificador cURL use os dados do identificador compartilhado. + Disponível a partir do cURL 7.10. @@ -2936,18 +3270,16 @@ Os métodos de autenticação SOCKS5 a serem utilizados. As opções são: - CURLAUTH_BASIC, - CURLAUTH_GSSAPI, - CURLAUTH_NONE. - Um operador binário | (OU) pode ser usado para combinar - mais de um método. Se isto for feito, o cURL irá interrogar o servidor para ver + + CURLAUTH_BASIC + CURLAUTH_GSSAPI + CURLAUTH_NONE + . + Quando mais de um método estiver definido, o cURL irá interrogar o servidor para ver que métodos ele suporta, e escolherá o melhor. - CURLAUTH_BASIC permite autenticação com usuário/senha. - CURLAUTH_GSSAPI permite autenticação GSS-API. - CURLAUTH_NONE permite que não haja autenticação. O padrão é CURLAUTH_BASIC|CURLAUTH_GSSAPI. Defina o usuário e senha reais com a opção CURLOPT_PROXYUSERPWD. - Disponível a partir do PHP 7.3.0 e cURL 7.55.0 + Disponível a partir do PHP 7.3.0 e cURL 7.55.0. @@ -2986,12 +3318,16 @@ - Uma máscara de bits que consiste de uma ou mais das opções - CURLSSH_AUTH_PUBLICKEY, - CURLSSH_AUTH_PASSWORD, - CURLSSH_AUTH_HOST e - CURLSSH_AUTH_KEYBOARD. Defina para - CURLSSH_AUTH_ANY para deixar a libcurl escolher um. + Uma máscara de bits que consiste de uma ou mais das seguintes constantes: + + CURLSSH_AUTH_PUBLICKEY + CURLSSH_AUTH_PASSWORD + CURLSSH_AUTH_HOST + CURLSSH_AUTH_KEYBOARD + CURLSSH_AUTH_AGENT + CURLSSH_AUTH_ANY + . + O padrão é CURLSSH_AUTH_ANY. Disponível a partir do cURL 7.16.1. @@ -3003,9 +3339,10 @@ - &true; para habilitar a compressão SSH interna. Isto é uma requisição, não uma ordem; - o servidor poderá ou não fazê-lo. - Disponível a partir do PHP 7.3.0 e cURL 7.56.0 + &true; para habilitar, &false; para desabilitar a compactação SSH interna. + Observe que o servidor pode desconsiderar esta requisição. + O padrão é &false; + Disponível a partir do PHP 7.3.0 e cURL 7.56.0. @@ -3016,7 +3353,51 @@ - Disponível a partir do PHP 8.3.0 e cURL 7.84.0 + Uma função do tipo callable que será chamada quando a verificação de chave do host SSH for necessária. + A função precisa ter a seguinte assinatura: + + intcallback + resourcecurlHandle + intkeyType + stringkey + intkeyLength + + + + curlHandle + + + O identificador cURL. + + + + + keyType + + + Um dos tipos de chave CURLKHTYPE_*. + + + + + key + + + A chave a ser verificada. + + + + + keyLength + + + O comprimento da chave em bytes. + + + + + Esta função substitui CURLOPT_SSH_KNOWNHOSTS. + Disponível a partir do PHP 8.3.0 e cURL 7.84.0. @@ -3027,8 +3408,8 @@ - Uma string contendo 32 dígitos hexadecimais. A string deve ser a - soma de verificação MD5 da chave pública do servidor remoto, e a libcurl rejeitará + Uma string contendo 32 dígitos hexadecimais que deve conter a + soma de verificação MD5 da chave pública do servidor remoto, e o cURL rejeitará a conexão com o servidor, a menos que as somas correspondam. Esta opção é apenas para transferências SCP e SFTP. Disponível a partir do cURL 7.17.1. @@ -3042,9 +3423,10 @@ - Hash SHA256 codificado em Base64 da chave pública do servidor remoto. + Uma string com o hash SHA256 codificado em base64 + da chave pública do servidor remoto. A transferência falhará se o hash fornecido não corresponder ao hash fornecido pelo servidor remoto. - Disponível a partir do PHP 8.2.0 e cURL 7.80.0 + Disponível a partir do PHP 8.2.0 e cURL 7.80.0. @@ -3068,9 +3450,9 @@ - O nome do arquivo da chave privada. Se não for usado, o padrão da libcurl é - $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 definida. + O nome do arquivo com a chave privada. Se não for usado, o padrão do cURL é + $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 definida. Se o arquivo estiver protegido por senha, defina a senha com CURLOPT_KEYPASSWD. Disponível a partir do cURL 7.16.1. @@ -3084,9 +3466,9 @@ - O nome do arquivo da chave pública. Se não for usado, o padrão da 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 definida. + O nome do arquivo com a chave pública. Se não for usado, o padrão do cURL é + $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 definida. Disponível a partir do cURL 7.16.1. @@ -3099,6 +3481,7 @@ O nome de um arquivo que contém um certificado no formato PEM. + Disponível a partir do cURL 7.1.0. @@ -3111,6 +3494,7 @@ A senha requerida para usar o certificado CURLOPT_SSLCERT. + Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.17.0. @@ -3121,11 +3505,15 @@ - O formato do certificado. Formatos suportados são - "PEM" (default), "DER" - e "ENG". - A partir do OpenSSL 0.9.3, "P12" (para arquivos codificados em PKCS#12) - também é suportado. + Uma string com o formato do certificado. Os formatos suportados são: + + PEM + DER + ENG + P12 + . + A partir do OpenSSL 0.9.3, o formato P12 (para arquivos codificados em PKCS#12) está disponível. + O padrão é PEM. Disponível a partir do cURL 7.9.3. @@ -3137,7 +3525,7 @@ - Certificado de cliente SSL do blob de memória. + Uma string com o certificado de cliente SSL do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -3149,8 +3537,9 @@ - O identificador do mecanismo de criptografia da chave SSL privada + Uma string com o identificador do mecanismo de criptografia da chave SSL privada especificada em CURLOPT_SSLKEY. + Disponível a partir do cURL 7.9.3. @@ -3161,8 +3550,9 @@ - O identificador do mecanismo de criptografia usado para operações de criptografia + Uma string com o identificador do mecanismo de criptografia usado para operações de criptografia assimétricas. + Disponível a partir do cURL 7.9.3. @@ -3174,6 +3564,7 @@ O nome de um arquivo que contém uma chave SSL privada. + Disponível a partir do cURL 7.9.3. @@ -3192,6 +3583,7 @@ seguro o script PHP que a contém. + Disponível a partir do cURL 7.9.3 e descontinuada a partir do cURL 7.17.0. @@ -3203,9 +3595,14 @@ O tipo de chave da chave SSL privada especificada em - CURLOPT_SSLKEY. Tipos de chave suportados são - "PEM" (default), "DER" - e "ENG". + CURLOPT_SSLKEY. Tipos de chave suportados são: + + PEM + DER + ENG + . + O padrão é PEM. + Disponível a partir do cURL 7.9.3. @@ -3216,7 +3613,7 @@ - Chave privada para certificado de cliente do blob de memória. + Uma string com a chave privada para certificado de cliente do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0. @@ -3228,34 +3625,8 @@ - Uma das constantes: - - CURL_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 - - . - A versão máxima do TLS pode ser definida usando uma das - constantes - CURL_SSLVERSION_MAX_*. - Também é possível operação binária OR de uma das constantes - CURL_SSLVERSION_* - com uma das constantes - CURL_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 - - . + Uma das + constantes CURL_SSLVERSION_*. É melhor não definir esta opção e deixar no padrão, @@ -3267,6 +3638,8 @@ conhecidas no SSLv2 e no SSLv3. + O padrão é CURL_SSLVERSION_DEFAULT. + Disponível a partir do cURL 7.1.0. @@ -3277,9 +3650,9 @@ - Uma lista de cifras a serem usadas para SSL. Por exemplo, - RC4-SHA e TLSv1 são listas - de cifras válidas. + Uma string com uma lista de cifras separadas por dois-pontos, + a serem usadas para a conexão TLS 1.2 (1.1, 1.0). + Disponível a partir do cURL 7.9. @@ -3294,7 +3667,7 @@ X25519:P-521 é uma lista válida de duas curvas elípticas. Esta opção define os algoritmos de troca de chaves do cliente na comunicação inicial do SSL, se o SSL com o qual o cURL foi compilado suportá-los. - Disponível a partir do PHP 8.2.0 e cURL 7.73.0 + Disponível a partir do PHP 8.2.0 e cURL 7.73.0. @@ -3306,9 +3679,9 @@ &false; para desabilitar o ALPN na comunicação inicial do SSL (se o SSL com o qual - a libcurl foi compilada suportá-lo), que pode ser usado para + o cURL foi compilado suportá-lo), que pode ser usado para negociar HTTP2. - Disponível a partir do PHP 7.0.7 e cURL 7.36.0 + Disponível a partir do PHP 7.0.7 e do cURL 7.36.0 e descontinuada a partir do cURL 7.86.0. @@ -3322,7 +3695,7 @@ &false; para desabilitar o NPN na comunicação inicial do SSL (se o SSL com o qual a libcurl foi compilada suportá-lo), que pode ser usado para negociar HTTP2. - Disponível a partir do PHP 7.0.7 e cURL 7.36.0 + Disponível a partir do PHP 7.0.7 e cURL 7.36.0. @@ -3333,8 +3706,10 @@ - &true; para habilitar início falso do TLS. - Disponível a partir do PHP 7.0.7 e cURL 7.42.0 + &true; para habilitar e &false; para desabilitar o início falso do TLS + que é um modo onde um cliente TLS inicia o envio de dados da aplicação + antes de verificar a mensagem Finished do servidor. + Disponível a partir do PHP 7.0.7 e cURL 7.42.0. @@ -3345,16 +3720,10 @@ - Define as opções de comportamento do SSL, que é uma máscara de bits das seguintes constantes: - - CURLSSLOPT_ALLOW_BEAST - CURLSSLOPT_NO_REVOKE - CURLSSLOPT_AUTO_CLIENT_CERT - CURLSSLOPT_NATIVE_CA - CURLSSLOPT_NO_PARTIALCHAIN - CURLSSLOPT_REVOKE_BEST_EFFORT - - Disponível a partir do PHP 7.0.7. e cURL 7.25.0 + Define as opções de comportamento do SSL, que é uma máscara de bits das + constantes CURLSSLOPT_*. + O padrão é nenhum bit definido. + Disponível a partir do PHP 7.0.7. e cURL 7.25.0. @@ -3385,6 +3754,7 @@ 1 não deve ser usado. Em ambientes de produção o valor para esta opção deve ser mantido em 2 (valor padrão). Suporte para o valor 1 foi removido no cURL 7.28.1. + Disponível a partir do cURL 7.8.1. @@ -3399,8 +3769,10 @@ do servidor. Certificados alternativos para verificar podem ser especificados com a opção CURLOPT_CAINFO ou um diretório de certificados pode ser especificado com a opção - CURLOPT_CAPATH. &true; é o padrão a partir do cURL 7.10. Pacote padrão instalado a partir do - cURL 7.10. + CURLOPT_CAPATH. + &true; é o padrão a partir do cURL 7.10. + Pacote padrão de certificados CA instalado a partir do cURL 7.10. + Disponível a partir do cURL 7.4.2. @@ -3411,8 +3783,8 @@ - &true; para verificar o status do certificado. - Disponível a partir do PHP 7.0.7 e cURL 7.41.0 + &true; para habilitar e &false; para desabilitar a verificação do status do certificado. + Disponível a partir do PHP 7.0.7 e cURL 7.41.0. @@ -3423,8 +3795,10 @@ - Uma localização alternativa para enviar os erros no lugar de + Aceita um identificador de arquivo do tipo resource apontando para + uma localização alternativa para enviar os erros no lugar de STDERR. + Disponível a partir do cURL 7.1.0. @@ -3435,8 +3809,8 @@ - Define o peso numérico do fluxo (um número entre 1 e 256). - Disponível a partir do PHP 7.0.7 e cURL 7.46.0 + Define o peso numérico do fluxo (um número entre 1 e 256). + Disponível a partir do PHP 7.0.7 e cURL 7.46.0. @@ -3450,7 +3824,8 @@ &true; para suprimir cabeçalhos de resposta CONNECT do proxy a partir das funções de retorno de usuário CURLOPT_HEADERFUNCTION e CURLOPT_WRITEFUNCTION, quando CURLOPT_HTTPPROXYTUNNEL é usada e uma requisição CONNECT é realizada. - Disponível a partir do PHP 7.3.0 e cURL 7.54.0 + O padrão é &false;. + Disponível a partir do PHP 7.3.0 e cURL 7.54.0. @@ -3461,8 +3836,8 @@ - &true; para habilitar a extensão "Fast Open" (abertura rápida) do TCP. - Disponível a partir do PHP 7.0.7 e cURL 7.49.0 + &true; para habilitar e &false; para desabilitar a extensão "Fast Open" (abertura rápida) do TCP. + Disponível a partir do PHP 7.0.7 e cURL 7.49.0. @@ -3477,7 +3852,7 @@ frequência destas sondas podem ser controlados pelas opções CURLOPT_TCP_KEEPIDLE e CURLOPT_TCP_KEEPINTVL, desde que o sistema operacional as suporte. Se definida para 0 (padrão), as sondas são desabilitadas. - Disponível a partir do cURL 7.25.0 + Disponível a partir do cURL 7.25.0. @@ -3492,7 +3867,7 @@ ociosa antes de enviar sondas de manutenção de atividade, se CURLOPT_TCP_KEEPALIVE estiver habilitada. Nem todos os sistemas operacionais suportam esta opção. O padrão é 60. - Disponível a partir do cURL 7.25.0 + Disponível a partir do cURL 7.25.0. @@ -3507,7 +3882,7 @@ de sondas de manutenção de atividade, se CURLOPT_TCP_KEEPALIVE estiver habilitada. Nem todos os sistemas operacionais suportam esta opção. O padrão é 60. - Disponível a partir do cURL 7.25.0 + Disponível a partir do cURL 7.25.0. @@ -3520,6 +3895,7 @@ &true; para desabilitar o algoritmo Nagle do TCP, que tenta minimizar o número de pacotes pequenos na rede. + O padrão é &true;. Disponível a partir do cURL 7.11.2. @@ -3535,7 +3911,7 @@ As variáveis ​​devem estar no formato >opção=valor<. O cURL suporta as opções TTYPE, XDISPLOC e NEW_ENV. - Disponível a partir do cURL 7.7. + Disponível a partir do cURL 7.7.0. @@ -3565,7 +3941,8 @@ &true; para não enviar requisições de opções TFTP. - Disponível a partir do PHP 7.0.7 e cURL 7.48.0 + O padrão é &false;. + Disponível a partir do PHP 7.0.7 e do cURL 7.48.0. @@ -3580,13 +3957,15 @@ Use CURL_TIMECOND_IFMODSINCE para retornar a página somente se ela tenha sido modificada desde o momento especificado em CURLOPT_TIMEVALUE. Se ela não foi modificada, - um cabeçalho "304 Not Modified" será retornado + um cabeçalho 304 Not Modified será retornado assumindo que CURLOPT_HEADER seja &true;. Use CURL_TIMECOND_IFUNMODSINCE para o efeito reverso. Use CURL_TIMECOND_NONE para ignorar CURLOPT_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_NONE é o padrão. + Antes do cURL 7.46.0, o padrão era CURL_TIMECOND_IFMODSINCE. + Disponível a partir do cURL 7.1.0. @@ -3598,6 +3977,8 @@ O número máximo de segundos para permitir a execução de funções cURL. + O padrão é 0, que significa que as funções nunca expiram durante a transferência. + Disponível a partir do cURL 7.1.0. @@ -3610,10 +3991,10 @@ O número máximo de milissegundos para permitir a execução de funções cURL. - - Se a libcurl for compilada para usar o resolvedor de nome padrão do sistema, essa + Se o cURL for compilado para usar o resolvedor de nome padrão do sistema, essa parte da conexão ainda usará resolução de segundos completos para tempos limite com um mínimo permitido de um segundo. + O padrão é 0, que significa que as funções nunca expiram durante a transferência. Disponível a partir do cURL 7.16.2. @@ -3627,6 +4008,8 @@ O tempo em segundos desde 1º de janeiro de 1970. O tempo será usado por CURLOPT_TIMECONDITION. + O padrão é 0. + Disponível a partir do cURL 7.1.0. @@ -3642,7 +4025,7 @@ A diferença entre esta opção e CURLOPT_TIMEVALUE é o tipo do argumento. Em sistemas onde o inteiro longo é de somente 32 bits de comprimento, esta opção tem que ser usada para definir datas além do ano 2038. - Disponível a partir do PHP 7.3.0 e cURL 7.59.0 + Disponível a partir do PHP 7.3.0 e cURL 7.59.0. @@ -3653,12 +4036,12 @@ - A lista de conjuntos de criptografia a serem usados ​​para a conexão TLS 1.3. A lista deve estar - sintaticamente correta e consiste em uma ou mais sequências de conjuntos de cifras separadas por dois pontos. + Uma string com a lista de conjuntos de criptografia + a serem usados ​​para a conexão TLS 1.3, separados por dois-pontos. Esta opção é usada atualmente apenas quando o cURL é compilado para usar OpenSSL 1.1.1 ou posterior. - Se um SSL diferente estiver sendo usado, pode-se tentar configurar - conjuntos de criptografia TLS 1.3 usando a opção CURLOPT_SSL_CIPHER_LIST. Disponível quando compilado com OpenSSL >= 1.1.1. - Disponível a partir do PHP 7.3.0 e cURL 7.61.0 + Se um SSL diferente estiver sendo usado, os conjuntos de criptografia TLS 1.3 podem ser configurados + com a opção CURLOPT_SSL_CIPHER_LIST. + Disponível a partir do PHP 7.3.0 e cURL 7.61.0. @@ -3735,6 +4118,8 @@ Para LDAP, os dados são recuperados em texto puro ao invés de HTML. Em sistemas Windows, STDOUT não será definido para modo binário. + O padrão é &false;. + Disponível a partir do cURL 7.1.1. @@ -3747,7 +4132,9 @@ Permite o uso de soquetes de domínio Unix como terminal de conexão e define o caminho para a string fornecida. - Disponível a partir do PHP 7.0.7 e cURL 7.40.0 + Defina como &null; para desabilitar. + O padrão é &null;. + Disponível a partir do PHP 7.0.7 e cURL 7.40.0. @@ -3762,6 +4149,8 @@ ao seguir localizações (usando CURLOPT_FOLLOWLOCATION), mesmo quando o nome do servidor tiver mudado. + O padrão é &false;. + Disponível a partir do cURL 7.10.4. @@ -3776,8 +4165,9 @@ nas conexões existentes para mantê-las ativas. Esta opção define o intervalo de manutenção da conexão. Atualmente, o único protocolo com mecanismo de manutenção de conexão é o HTTP/2. Quando o intervalo de manutenção da conexão é excedido, um quadro PING HTTP/2 é enviado na conexão. - O padrão é 60 segundos. - Disponível a partir do PHP 8.2.0 e cURL 7.62.0 + O padrão é CURL_UPKEEP_INTERVAL_DEFAULT + que atualmente é 60 segundos. + Disponível a partir do PHP 8.2.0 e cURL 7.62.0. @@ -3788,7 +4178,9 @@ - &true; para se preparar para um envio. + &true; para se preparar e realizar um envio. + O padrão é &false;. + Disponível a partir do cURL 7.1.0. @@ -3802,7 +4194,7 @@ Tamanho de buffer preferido em bytes para o buffer de upload cURL. O tamanho do buffer de upload por padrão é de 64 kilobytes. O tamanho máximo do buffer que pode ser definido é de 2 megabytes. O tamanho mínimo do buffer que pode ser definido é de 16 kilobytes. - Disponível a partir do PHP 8.2.0 e cURL 7.62.0 + Disponível a partir do PHP 8.2.0 e cURL 7.62.0. @@ -3815,6 +4207,7 @@ O URL a ser buscado. Isto também pode ser definido ao inicializar uma sessão com curl_init. + Disponível a partir do cURL 7.1.0. @@ -3829,11 +4222,8 @@ ao usar FTP, SMTP, POP3, IMAP etc. Todos esses são protocolos que iniciam em texto simples e são "atualizados" para SSL usando o comando STARTTLS. - Deve ser definida como uma das seguintes constantes: - CURLUSESSL_NONE, - CURLUSESSL_TRY, - CURLUSESSL_CONTROL ou - CURLUSESSL_ALL. + Deve ser definida como uma das + constantes CURLUSESSL_*. Disponível a partir do cURL 7.17.0. @@ -3845,8 +4235,9 @@ - O conteúdo do cabeçalho "User-Agent: " a ser + O conteúdo do cabeçalho User-Agent: a ser usado em uma requisição HTTP. + Disponível a partir do cURL 7.1.0. @@ -3858,7 +4249,7 @@ O nome de usuário a ser utilizado na autenticação. - Disponível a partir do cURL 7.19.1 + Disponível a partir do cURL 7.19.1. @@ -3870,8 +4261,9 @@ Um nome de usuário e senha formatados como - "[usuário]:[senha]" a serem usados para a + [usuário]:[senha] a serem usados para a conexão. + Available as cURL 7.1.0. @@ -3885,6 +4277,8 @@ &true; para gerar informações detalhadas. Grava a saída em STDERR ou no arquivo especificado usando CURLOPT_STDERR. + O padrão é &false;. + Disponível a partir do cURL 7.1.0. @@ -3912,11 +4306,34 @@ - Uma função de retorno que aceita dois parâmetros. - O primeiro é o recurso cURL e o segundo é uma - string com os dados a serem gravados. Os dados devem ser salvos por - esta função de retorno. Deve retornar o número exato de bytes gravados + Uma função de retorno do tipo callable com a seguinte assinatura: + + intcallback + resourcecurlHandle + stringdata + + + + curlHandle + + + O identificador cURL. + + + + + data + + + Os dados a serem escritos. + + + + + Os dados devem ser gravados por esta função de retorno e ela + deve retornar o número exato de bytes escritos ou a transferência será abortada com erro. + Disponível a partir do cURL 7.1.0. @@ -3927,7 +4344,8 @@ - O arquivo no qual a parte do cabeçalho da transferência é gravada. + Aceita um identificador de arquivo do tipo resource no qual a parte do cabeçalho da transferência é gravada. + Disponível a partir do cURL 7.1.0. @@ -3938,7 +4356,10 @@ - Disponível a partir do PHP 8.3.0 e cURL 7.86.0 + Aceita uma máscara de bits configurando as opções de comportamento do WebSocket. + A única opção disponível é CURLWS_RAW_MODE. + O padrão é 0. + Disponível a partir do PHP 8.3.0 e cURL 7.86.0. @@ -3949,9 +4370,59 @@ - Uma função de retorno que aceita dois parâmetros. - Tem uma finalidade semelhante a CURLOPT_PROGRESSFUNCTION mas é mais moderna - e é a opção preferida do cURL. + Uma função de retorno do tipo callable com a seguinte assinatura: + + intcallback + resourcecurlHandle + intbytesToDownload + intbytesDownloaded + intbytesToUpload + intbytesUploaded + + + + curlHandle + + + O identificador cURL. + + + + + bytesToDownload + + + O número total de bytes esperados para recebimento nesta transferência. + + + + + bytesDownloaded + + + O número de bytes recebidos até o momento. + + + + + bytesToUpload + + + O número total de bytes esperados para envio nesta transferência. + + + + + bytesUploaded + + + O número de bytes enviados até o momento. + + + + + Retorne 1 para abortar a transferência + e definir um erro CURLE_ABORTED_BY_CALLBACK. Disponível a partir do PHP 8.2.0 e cURL 7.32.0. @@ -3964,7 +4435,9 @@ Especifica o token de acesso do OAuth 2.0. - Disponível a partir do PHP 7.0.7 e cURL 7.33.0 + Defina como &null; para desabilitar. + O padrão é &null;. + Disponível a partir do PHP 7.0.7 e cURL 7.33.0.