Constantes pré-definidas

Habilita o uso de um soquete de domínio Unix abstrato ao invés de estabelecer uma conexão TCP a um servidor e define o caminho para a string informada. Esta opção compatilha da mesma semântica 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

Define uma string com o conteúdo do cabeçalho Accept-Encoding: enviado em uma requisição HTTP. Se definida para null, desabilita o envio do cabeçalho Accept-Encoding:. O padrão é null. Disponível a partir do cURL 7.21.6.

O número máximo de milissegundos de espera para que um servidor se conecte novamente ao cURL quando uma conexão FTP ativa é usada. Esta opção aceita qualquer valor que possa ser convertido em um int válido. O padrão é 60000 milissegundos. Disponível a partir do cURL 7.24.0.

O valor do ID do escopo a ser usado ao conectar-se a endereços IPv6. Esta opção aceita qualquer valor que possa ser convertido em um int válido. O padrão é 0. Disponível a partir do cURL 7.19.0.

Passa 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.

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. Disponível a partir do PHP 8.2.0 e cURL 7.64.1.

Definir esta opção como 1 fará com que os uploads de FTP sejam anexados ao arquivo remoto em vez de sobrescrevê-lo. O padrão é 0. Disponível a partir do cURL 7.17.0.

true para definir automaticamente o campo Referer: nas requisições onde ele segue um redirecionamento Location:.

Fornece autenticação de assinatura AWS V4 em cabeçalho HTTP(S). 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

O tamanho do buffer a ser usado para cada leitura. Entretanto, não há garantia de que esta requisição será cumprida. Disponível a partir do cURL 7.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 CURLOPT_SSL_VERIFYPEER. Pode requerer um caminho absoluto.

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

Um diretótio que mantém múltiplos certificados CA. Use esta opção junto com CURLOPT_SSL_VERIFYPEER.

Disponível a partir do PHP 8.3.0 e cURL 7.87.0

true para enviar informação de certificação SSL para STDERR em transferências seguras. Adicionada no cURL 7.19.1. Requer CURLOPT_VERBOSE ligada para ter efeito.

O número de segundos a esperar durante tentativa de conexão. Use 0 para esperar indefinidamente.

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 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.

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. Disponível a partir do cURL 7.15.2.

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 HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. Disponível a partir do PHP 7.0.7 e cURL 7.49.0

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")

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.

O nome do arquivo para gravar todos os cookies internos para quando o destrutor do identificador for chamado.

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. Disponível a partir do cURL 7.14.1.

true para marcar esta como uma nova "sessão" de cookie. Irá forçar a libcurl 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 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".

true para converter novas linhas Unix para novas linhas CRLF nas transferências.

Passa uma string nomeando um arquivo com a concatenação da CRL (Certificate Revocation List) (em formato PEM) para utilização na validação do certificado que ocorre durante a troca SSL. Quando cURL é construído para usar GnuTLS, não há como influenciar o uso da CRL passada para ajudar no processo de verificação. Quando cURL é construído com suporte OpenSSL, ambas X509_V_FLAG_CRL_CHECK e X509_V_FLAG_CRL_CHECK_ALL estarão definidas, exigindo verificação de CRL em todos os elementos da cadeia de certificados se um arquivo CRL for passado. 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

Um método de requisição customizado a ser usado no lugar de "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; Não insira aqui uma requisição HTTP inteira. Por exemplo, escrever "GET /index.html HTTP/1.0\r\n\r\n" estaria incorreto.

Nota:

Isto não deve ser feito sem primeiro garantir que o servidor suporta o método de requisição.

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

Definir esta opção como 1 terá efeitos diferentes com base no protocolo com o qual é usada. URLs baseados em FTP e SFTP listarão apenas os nomes dos arquivos em um diretório. POP3 listará a mensagem ou mensagens de e-mail no servidor POP3. Para FILE, esta opção não tem efeito, pois os diretórios são sempre listados neste modo. Usar esta opção com CURLOPT_WILDCARDMATCH impedirá que este último tenha qualquer efeito. O padrão é 0. Disponível a partir do cURL 7.17.0.

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

O número de segundos para manter as entradas DNS na memória. Esta opção é definida para 120 (2 minutos) por padrão.

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

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 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

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

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

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.).

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.

Verifica a autenticidade o certificado SSL do servidor de DNS-sobre-HTTPS. Disponível a partir do PHP 8.2.0 e cURL 7.76.0.

Solicita ao cURL que verifique o 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.

Fornece a URL do DNS-sobre-HTTPS. Disponível a partir do PHP 8.1.0 e cURL 7.62.0.

Similar a CURLOPT_RANDOM_FILE, exceto por um nome de arquivo para um soquete "Entropy Gathering Daemon".

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 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

true para falhar prolixamente 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.

O arquivo no qual a transferência deve ser gravada. O padrão é STDOUT (a janela do navegador).

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().

Passa um tipo callable que será usado para correspondência com caracteres coringas. A assinatura desta função deve ser:

curlHandle

O identificador cURL.

pattern

A expressão com coringas.

string

A string na qual a correspodência com coringas será executada.

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.

true para força a conexão a ser fechada explicitamente ao terminar o processamento, e não ser enfileirada para reúso.

true para forçar o uso de uma nova conexão ao invés de uma em cache.

true para anexar ao arquivo remoto ao invés de sobrescrevê-lo.

Um apelido para CURLOPT_TRANSFERTEXT. Use este último.

true para apenas listar os nomes de um diretório FTP.

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 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.

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). Disponível a partir do cURL 7.12.2.

Passe uma string que será enviada como informação da conta via FTP (usando o comando ACCT) depois que o nome de usuário e a senha forem fornecidos ao servidor. Se definida como null, desativa o envio das informações da conta. O padrão é null. Disponível a partir do cURL 7.13.0.

Passa uma string que será usada para tentativa de autenticação por FTP se a negociação USER/PASS falhar. Disponível a partir do cURL 7.15.5.

true para criar diretórios ausentes quando uma operação FTP encontrar um caminho que não existe atualmente.

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. Disponível a partir do cURL 7.15.1.

Um tempo limite em segundos em que o cURL aguardará uma resposta de um servidor FTP. Esta opção substitui CURLOPT_TIMEOUT. Esta opção aceita qualquer valor que possa ser convertido em um int válido. Disponível a partir do cURL 7.10.8 e defasado a partir do cURL 7.85.0.

Se esta opção for definida como 1, o cURL não usará o endereço IP que o servidor sugere 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 e 0 antes disso. Disponível a partir do cURL 7.15.0.

Esta opção faz com que o cURL use CCC (Clear Command Channel), que desliga a camada SSL/TLS após a autenticação, tornando o restante da comunicação do canal de controle descriptografado. Use uma das constantes CURLFTPSSL_CCC_*. O padrão é CURLFTPSSL_CCC_NONE. Disponível a partir do cURL 7.16.1.

true para usar EPRT (e LPRT) ao realizar downloads FTP ativos. Use false para desabilitar EPRT e LPRT e usar PORT somente.

true para primeiro tentar um comando EPSV para transferências FTP antes de reverter para PASV. Defina para false para desabilitar EPSV.

Definida para 1, envia um comando PRET antes de PASV (e EPSV). Não tem efeito ao usar o modo ativo de transferências FTP. O padrão é 0. Disponível a partir do cURL 7.20.0.

Definida como CURLGSSAPI_DELEGATION_FLAG, permite a delegação incondicional de credenciais GSSAPI. Definida como CURLGSSAPI_DELEGATION_POLICY_FLAG, delega somente se a opção OK-AS-DELEGATE estiver definida no ticket de serviço. O padrão é CURLGSSAPI_DELEGATION_NONE. Disponível a partir do cURL 7.22.0.

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

true para enviar um cabeçalho de protocolo 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

true para incluir o cabeçalho na saída.

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.

Valores possíveis são CURLHEADER_UNIFIED ou CURLHEADER_SEPARATE. 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

Nome do arquivo de cache HSTS (HTTP Strict Transport Security). Disponível a partir do PHP 8.2.0 e cURL 7.74.0

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

Informa se respostas HTTP/0.9 são permitidas. O padrão é false a partir da libcurl 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

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.

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 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.

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.

Um array de campos de cabeçalho HTTP a definir, no formato array('Content-type: text/plain', 'Content-length: 100')

true para encapsular através de um determinado proxy HTTP.

false para obter o corpo de resposta HTTP bruto. Disponível a partir do cURL 7.16.2.

Se definida para 0, a decodificação de transferência é desabilitada. Se definida como 1, a decodificação de transferência é habilitada. O cURL faz decodificação de transferência em partes por padrão, a menos que esta opção esteja definida como 0. O padrão é 1. Disponível a partir do cURL 7.16.2.

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).

Se definida como 1, ignora o cabeçalho Content-Length na resposta HTTP e ignore a solicitação ou dependência dele para transferências FTP. O padrão é 0. Disponível a partir do cURL 7.14.1.

O arquivo a ser lido pela transferência durante o envio.

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 envie mais dados, já que o que exatamente será enviado depende de CURLOPT_READFUNCTION.

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.

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. Disponível a partir do cURL 7.10.8.

Se definida como uma string nomeando um arquivo que contém um certificado CA no formato PEM, uma verificação adicional no certificado de mesmo nível é executada para verificar se o emissor é de fato aquele associado ao certificado fornecido pela opção. Para que o resultado da verificação seja considerado uma falha, esta opção deve ser utilizada em combinação com a opção CURLOPT_SSL_VERIFYPEER. Disponível a partir do cURL 7.19.0.

Certificado SSL do emissor a partir do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

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. 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

A senha requerida para usar a chave privada CURLOPT_SSLKEY ou CURLOPT_SSH_PRIVATE_KEYFILE. Disponível a partir do cURL 7.16.1.

O nível de segurança KRB4 (Kerberos 4). Qualquer dos valores 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 irá desabilitar a segurança KRB4. Atualmente, a segurança KRB4 funciona somente com transações FTP.

Define o nível de segurança Kerberos para FTP e também habilita o reconhecimento de Kerberos. Isso deve ser definido como uma das seguintes strings: clear, 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. O padrão é null. Disponível a partir do cURL 7.16.4.

Define o número da porta local do soquete usado para a conexão. Esta opção aceita qualquer valor que possa ser convertido em um int válido. O padrão é 0. Disponível a partir do cURL 7.15.2.

O número de tentativas que o cURL faz para encontrar um número de porta local funcional, começando com aquele definido com CURLOPT_LOCALPORT. Esta opção aceita qualquer valor que possa ser convertido em um int válido. O padrão é 1. Disponível a partir do cURL 7.15.2.

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

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.

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.

Define uma string com o endereço de autenticação (identidade) de uma mensagem enviada que está sendo retransmitida para outro servidor. O endereço não deve ser especificado entre parênteses angulares (><). Se uma string vazia for usada, um par de parênteses angulares será enviado pelo cURL conforme exigido pela RFC 2554. Disponível a partir do cURL 7.25.0.

Define uma string com o endereço de e-mail do remetente ao enviar mensagens SMTP. O endereço de e-mail deve ser especificado entre parênteses angulares (><) ao redor dele, que se não forem especificados serão adicionados automaticamente. Se este parâmetro não for especificado, um endereço vazio será enviado ao servidor SMTP, o que poderá fazer com que o e-mail seja rejeitado. Disponível a partir do cURL 7.20.0.

Deve ser definida como um array de strings com os destinatários a serem passados ao servidor em uma solicitação de email SMTP. Cada destinatário deve ser especificado entre parênteses angulares (><). Se um parêntese angular não for usado como primeiro caractere, o cURL assumirá que um único endereço de e-mail foi fornecido e colocará esse endereço entre parênteses angulares. Disponível a partir do cURL 7.20.0.

Disponível a partir do PHP 8.2.0 e cURL 7.69.0

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

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.

Define o tamanho máximo aceito (em bytes) de um arquivo para recebimento. Se o arquivo solicitado for maior que esse valor, a transferência será abortada e CURLE_FILESIZE_EXCEEDED será retornado. Passar 0 desabilita esta opção, e passar um tamanho negativo retorna uma CURLE_BAD_FUNCTION_ARGUMENT. Se o tamanho do arquivo não for conhecido antes do início do recebimento, esta opção não terá efeito. Para definir um limite de tamanho acima de 2GB, CURLOPT_MAXFILESIZE_LARGE deve ser usada. A partir do cURL 8.4.0, esta opção também interrompe as transferências em andamento se atingirem esse limite. Esta opção aceita qualquer valor que possa ser convertido em um int válido. O padrão é 0. Disponível a partir do cURL 7.10.8.

O tamanho máximo permitido para arquivo recebido. Se o arquivo requisitado for maior que este valor, 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

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

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.

Se um recebimento exceder esta velocidade (medida em bytes por segundo) na 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

Se um envio exceder esta velocidade (medida em bytes por segundo) na 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

Disponível a partir do PHP 8.3.0 e cURL 7.81.0

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.

true para ler o arquivo ~/.netrc buscando usuário e senha para o servidor remoto com o qual a conexão está sendo estabelecida.

Define uma string contendo o nome completo do caminho para um arquivo .netrc. Se esta opção for omitida e CURLOPT_NETRC estiver definida, o cURL verificará se há um arquivo .netrc no diretório inicial do usuário atual. Disponível a partir do cURL 7.11.0.

Configura o valor das permissões (int) definidas nos diretórios recém-criados no servidor remoto. O valor padrão é 0755. Os únicos protocolos que podem usar isso são sftp://, scp:// e file://. Disponível a partir do cURL 7.16.4.

Configura o valor das permissões (como um int) que são definidas em arquivos recém-criados no servidor remoto. O valor padrão é 0644. Os únicos protocolos que podem usar isso são sftp://, scp:// e file://. Disponível a partir do cURL 7.16.4.

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.

true para desabilitar a medição de progresso para transferências cURL.

Nota:

O PHP define automaticamente esta opção para true, ela só deve ser alterada para depuração.

Define uma string que consiste em uma lista separada por vírgulas de nomes de servidor que não requerem um proxy para serem acessados. Cada nome nesta lista é correspondido como um domínio que contém o nome do servidor ou como o próprio nome do servidor. O único coringa disponível na string é um único caractere * que corresponde a todos os servidores, desativando efetivamente o proxy. Definir esta opção como uma string vazia habilita o proxy para todos os nomes de servidor. Desde o cURL 7.86.0, os endereços IP definidos com esta opção podem ser fornecidos usando a notação CIDR. Disponível a partir do cURL 7.19.4.

true para ignorar qualquer função cURL que faça com que um sinal seja enviado ao processo PHP. Ligado por padrão em SAPIs multi-thread para que opções de limite de tempo ainda possam ser usadas. Disponível a partir do cURL 7.10.

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. Removida a partir do PHP 7.3.0.

A senha a ser usada na autenticação. Disponível a partir do cURL 7.19.1.

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

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

true para esperar por sequenciamento/multiplexação. Disponível a partir do PHP 7.0.7 e cURL 7.43.0

Um número alternativo de porta para conexão.

true para fazer um POST HTTP comum. Este POST é do tipo application/x-www-form-urlencoded normal, mais comumente usado por formulários HTML.

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 cabeçalho Content-Type será definido para multipart/form-data. Arquivos podem ser enviados usando CURLFile ou CURLStringFile, onde value precisa ser um array.

Um array de comandos FTP a executar no servidor depois que a requisição FTP tenha sido realizada.

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 quando CURLOPT_FOLLOWLOCATION estiver definida e um tipo específico de redirecionamento ocorrer. Disponível a partir do cURL 7.19.1.

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 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] 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

Define um array de strings de comandos FTP a serem passados ao servidor depois que o tipo de transferência for definido. Esses comandos não são executados quando uma listagem de diretórios é realizada, apenas para transferências de arquivos. Disponível a partir do cURL 7.9.5.

Quaisquer dados que devem ser associados com este identificador cURL. Estes dados podem ser recuperados subsequentemente com a opção CURLINFO_PRIVATE de curl_getinfo(). cURL não faz nada com estes dados. Ao usar um multi-identificador cURL, estes dados privados são tipicamente uma chave única para identificar um identificador cURL padrão. Disponível a partir do cURL 7.10.3.

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.

Nota:

A função de retorno é chamada somente quando a opção CURLOPT_NOPROGRESS estiver definida para false.

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. 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 PHP 8.3.0 e cURL 7.85.0

O proxy HTTP através do qual as requisições serão enviadas.

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 CURLAUTH_NTLM são suportadas atualmente. Disponível a partir do cURL 7.10.7.

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

Define uma string com a senha a ser usada para autenticação com o proxy. Disponível a partir do cURL 7.19.1.

O número da porta do proxy para conexão. Este número de porta também pode ser definido em CURLOPT_PROXY.

Pode ser CURLPROXY_HTTP (padrão), CURLPROXY_SOCKS4, CURLPROXY_SOCKS5, CURLPROXY_SOCKS4A ou CURLPROXY_SOCKS5_HOSTNAME. Disponível a partir do cURL 7.10.

Define uma string com o nome de usuário a ser usado para autenticação com o proxy. Disponível a partir do cURL 7.19.1.

Um nome de usuário e senha formatados como "[usuário]:[senha]" para usar na conexão ao proxy.

O caminho para o pacote de Certificados de Autoridade (CA) do proxy. Defina o caminho como uma 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 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 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

Define 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

Nome do arquivo do certificado SSL do emissor do proxy. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

Certificado SSL do emissor do proxy do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

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

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

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).

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

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

Certificado de cliente proxy SSL do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

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 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

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

Chave privada para certificado de proxy do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

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 .

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

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

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

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

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

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

O método de autenticação TLS usado para a conexão HTTPS. O método suportado é "SRP".

Nota:

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.

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

Quando igual a 1, define o modo de transferência (binário ou ASCII) para transferências FTP feitas através de um proxy HTTP, anexando type=a ou type=i ao URL. Sem esta configuração ou definida como 0, CURLOPT_TRANSFERTEXT não tem efeito ao fazer FTP através de um proxy. O padrão é 0. Disponível a partir do cURL 7.18.0.

true para usar o método PUT HTTP para um arquivo. O arquivo precisa ser definido com CURLOPT_INFILE e CURLOPT_INFILESIZE.

Disponível a partir do PHP 8.3.0 e cURL 7.87.0

Um array de comandos FTP a executar no servidor antes da requisição FTP.

Um nome de arquivo a ser usado para semear o gerador de números aleatórios para o SSL.

Faixa(s) de dados a buscar 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".

Define um ponteiro de arquivo do tipo resource que será usado pela função de leitura de arquivo definida com CURLOPT_READFUNCTION. Disponível a partir do cURL 7.9.7.

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 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.

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 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. Veja também CURLOPT_PROTOCOLS para valores constantes de protocolo. Disponível a partir do cURL 7.19.4.

Disponível a partir do PHP 8.3.0 e cURL 7.85.0.

O conteúdo do cabeçalho "Referer: " a ser usado em uma requisição HTTP.

Disponível a partir do PHP 7.3.0 e cURL 7.55.0.

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: array("example.com:80:127.0.0.1") Disponível a partir do cURL 7.21.3.

O deslocamento, em bytes, a partir do qual uma transferência deve ser retomada.

true para retornar a transferência como uma string do valor de retorno de curl_exec() em vez de enviá-la diretamente.

Define um int com o número CSEQ a ser emitido para a próxima solicitação RTSP. Útil se o aplicativo estiver retomando uma conexão interrompida anteriormente. O CSEQ é inrementado a partir deste novo número. O padrão é 0. Disponível a partir do cURL 7.20.0.

Define o tipo de solicitação RTSP a ser feita. Deve ser uma das constantes CURL_RTSPREQ_*. Disponível a partir do cURL 7.20.0.

Define um int com o número CSEQ esperado para a próxima solicitação do servidor RTSP para o cliente. Este recurso (escutar solicitações do servidor) não está implementado. O padrão é 0. Disponível a partir do cURL 7.20.0.

Defina uma string com o valor do ID da sessão RTSP atual para o identificador. Depois que esse valor for definido como qualquer valor não null, o cURL retornará CURLE_RTSP_SESSION_ERROR se o ID recebido do servidor não corresponder. Se definido como null, o cURL define automaticamente o ID na primeira vez que o servidor o define em uma resposta. O padrão é null. Disponível a partir do cURL 7.20.0.

Define uma string com o URI do stream para operar. Se não for definido, o padrão do cURL é operar em opções genéricas do servidor, passando * no lugar do URI do fluxo RTSP. Ao trabalhar com RTSP, CURLOPT_RTSP_STREAM_URI indica qual URL enviar ao servidor no cabeçalho da solicitação enquanto CURLOPT_URL indica onde a conexão deve ser feita. Disponível a partir do cURL 7.20.0.

Define o cabeçalho Transport: para esta sessão RTSP. Disponível a partir do cURL 7.20.0.

Sempre true, o que desativa o suporte ao prefixo @ para envio de arquivos em CURLOPT_POSTFIELDS, o que significa que valores começando com @ podem ser passados ​ ​com segurança como campos. CURLFile pode ser usada para envios.

A 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

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

O nome do serviço de autenticação. Disponível a partir do PHP 7.0.7 e cURL 7.43.0

Um resultado de curl_share_init(). Faz com que o identificador cURL use os dados do identificador compartilhado.

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 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

Definida como 1 habilita, e como 0 desabilita, a troca desprotegida da negociação do modo de proteção como parte da negociação GSSAPI. Disponível a partir do cURL 7.19.4.

Define uma string contendo o nome do serviço SOCKS5. O padrão é rcmd Disponível a partir do cURL 7.19.4 e defasada a partir do cURL 7.49.0. Use CURLOPT_PROXY_SERVICE_NAME em seu lugar.

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. Disponível a partir do cURL 7.16.1.

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

Disponível a partir do PHP 8.3.0 e cURL 7.84.0

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á 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.

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

Deve ser definida como o nome do arquivo known_host a ser usado, que deve usar o formato de arquivo OpenSSH conforme suportado pela libssh2. Disponível a partir do cURL 7.19.6.

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. Se o arquivo estiver protegido por senha, defina a senha com CURLOPT_KEYPASSWD. Disponível a partir do cURL 7.16.1.

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. Disponível a partir do cURL 7.16.1.

O nome de um arquivo que contém um certificado no formato PEM.

A senha requerida para usar o certificado CURLOPT_SSLCERT.

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. Disponível a partir do cURL 7.9.3.

Certificado de cliente SSL do blob de memória. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

O identificador do mecanismo de criptografia da chave SSL privada especificada em CURLOPT_SSLKEY.

O identificador do mecanismo de criptografia usado para operações de criptografia assimétricas.

O nome de um arquivo que contém uma chave SSL privada.

A senha secreta necessária para usar a chave SSL privada especificada em CURLOPT_SSLKEY.

Nota:

Como esta opção contém uma senha confidencial, lembre-se de manter seguro o script PHP que a contém.

O tipo de chave da chave SSL privada especificada em CURLOPT_SSLKEY. Tipos de chave suportados são "PEM" (default), "DER" e "ENG".

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.

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 lista de cifras a serem usadas para SSL. Por exemplo, RC4-SHA e TLSv1 são listas de cifras válidas.

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 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

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 negociar HTTP2. Disponível a partir do PHP 7.0.7 e cURL 7.36.0

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

true para habilitar início falso do TLS. Disponível a partir do PHP 7.0.7 e cURL 7.42.0

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

Definida como 0 desativa, e como 1 ativa o cache de ID de sessão SSL. Por padrão todas as transferências são feitas usando o cache habilitado. Disponível a partir do cURL 7.16.0.

2 para verificar que um campo "Common Name" ou um campo "Subject Alternate Name" no certificado SSL corresponde ao nome de servidor informado. 0 para não verificar os nomes. 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.

false para impedir o cURL de verificar o certificado 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.

true para verificar o status do certificado. Disponível a partir do PHP 7.0.7 e cURL 7.41.0

Uma localização alternativa para enviar os erros no lugar de STDERR.

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

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

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

Se definida para 1, sondas de manutenção de atividade serão enviadas. O atraso e a 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

Define o atraso, em segundos, que o sistema operacional aguardará enquanto a conexão estiver 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

Define o intervalo, em segundos, que o sistema operacional aguardará entre o envio 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

true para desabilitar o algoritmo Nagle do TCP, que tenta minimizar o número de pacotes pequenos na rede. Disponível a partir do cURL 7.11.2.

Define um array de strings a ser passado às negociações telnet. 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.

Define o tamanho do bloco a ser usado para transmissão de dados TFTP. O intervalo válido é 8-65464 bytes. O padrão de 512 bytes será usado se esta opção não for especificada. O tamanho de bloco especificado só será usado se for suportado pelo servidor remoto. Se o servidor não retornar uma confirmação de opção ou retornar uma confirmação de opção sem tamanho de bloco, o padrão de 512 bytes será usado. Disponível a partir do cURL 7.19.4.

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

Define como CURLOPT_TIMEVALUE é tratada. 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 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_IFMODSINCE.

O número máximo de segundos para permitir a execução de funções cURL.

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 parte da conexão ainda usará resolução de segundos completos para tempos limite com um mínimo permitido de um segundo. Disponível a partir do cURL 7.16.2.

O tempo em segundos desde 1º de janeiro de 1970. O tempo será usado por CURLOPT_TIMECONDITION.

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 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

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. Esta opção é usada atualmente apenas quando o cURL é compilado para usar OpenSSL 1.1.1 ou posterior. Se você estiver usando um SSL diferente, 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

Define uma senha a ser usada para o método de autenticação TLS especificado com a opção CURLOPT_TLSAUTH_TYPE. Requer que a opção CURLOPT_TLSAUTH_USERNAME também seja definida. Este recurso depende do TLS SRP, que não funciona com o TLS 1.3. Disponível a partir do cURL 7.21.4.

Define uma string com o método de autenticação TLS. O método suportado é SRP (autenticação TLS "Secure Remote Password"). Disponível a partir do cURL 7.21.4.

Define uma string com o nome de usuário a ser usado para o método de autenticação TLS especificado com a opção CURLOPT_TLSAUTH_TYPE. Requer que a opção CURLOPT_TLSAUTH_PASSWORD também esteja definida. Este recurso depende do TLS SRP, que não funciona com o TLS 1.3. Disponível a partir do cURL 7.21.4.

Definida como 1 ativa, e como 0 desativa a solicitação de Transfer Encoding compactada na solicitação HTTP de saída. Se o servidor responder com uma Transfer Encoding compactada, o cURL irá descompactá-la automaticamente na recepção. O padrão é 0. Disponível a partir do cURL 7.21.6.

true para usar modo ASCII para transferências FTP. 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.

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

true para continuar enviando usuário e senha ao seguir localizações (usando CURLOPT_FOLLOWLOCATION), mesmo quando o nome do servidor tiver mudado.

Alguns protocolos possuem mecanismos de "manutenção da 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 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

true para se preparar para um envio.

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

O URL a ser buscado. Isto também pode ser definido ao inicializar uma sessão com curl_init().

Define o nível desejado de SSL/TLS para a transferência 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. Disponível a partir do cURL 7.17.0.

O conteúdo do cabeçalho "User-Agent: " a ser usado em uma requisição HTTP.

O nome de usuário a ser utilizado na autenticação. Disponível a partir do cURL 7.19.1

Um nome de usuário e senha formatados como "[usuário]:[senha]" a serem usados para a conexão.

true para gerar informações detalhadas. Grava a saída em STDERR ou no arquivo especificado usando CURLOPT_STDERR.

Se definida como 1, transfere vários arquivos de acordo com um padrão de nome de arquivo. O padrão pode ser especificado como parte da opção CURLOPT_URL, usando um padrão semelhante ao fnmatch (Shell Pattern Matching) na última parte da URL (nome do arquivo). Disponível a partir do cURL 7.21.0.

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 ou a transferência será abortada com erro.

O arquivo no qual a parte do cabeçalho da transferência é gravada.

Disponível a partir do PHP 8.3.0 e cURL 7.86.0

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. Disponível a partir do PHP 8.2.0 e cURL 7.32.0.

Especifica o token de acesso do OAuth 2.0. Disponível a partir do PHP 7.0.7 e cURL 7.33.0

Passe um callable que será registrado para lidar com pushes do servidor e deverá ter a seguinte assinatura:

parent_ch

O identificador cURL pai (a solicitação feita pelo cliente).

pushed_ch

Um novo identificador cURL para a solicitação enviada.

headers

Os cabeçalhos da promessa push.