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

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

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:. O padrão é 0. Disponível a partir do cURL 7.1.0.

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.

Esta constante não é mais usada desde o PHP 5.5.0. Descontinuada a partir do PHP 8.4.0.

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.

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.

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.

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.

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.

true para enviar informação de certificação SSL para STDERR em transferências seguras. Requer CURLOPT_VERBOSE ligada para ter efeito. O padrão é false. Disponível a partir do cURL 7.19.1.

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.

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

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.

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.

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.

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.

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.

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

true para converter novas linhas Unix para novas linhas CRLF nas transferências. Disponível a partir do cURL 7.1.0.

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. Esta opção aceita uma string ou null. Disponível a partir do cURL 7.1.0.

Note:

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

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.

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. 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. Esta opção aceita qualquer valor que possa ser convertido para um int válido. Disponível a partir do cURL 7.9.3.

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). Esta opção aceita uma string ou null. 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.

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.

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

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.

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.

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.

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.

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.

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.

O limite de tempo para respostas Expect: 100-continue em milissegundos. 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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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. Esta opção aceita uma string ou null. Disponível a partir do cURL 7.1.0.

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.

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.

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.

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.

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.

Disponível a partir do cURL 7.11.0 e descontinuada a partir do cURL 7.16.4.

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.

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.

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.

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

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.

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.

Uma função de retorno do tipo callable com a seguinte assinatura:

curlHandle

O identificador cURL.

headerData

Os dados de cabeçalho que precisam ser escritos pela função.

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.

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.

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.

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.

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.

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.

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.

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.

Defina como true para encapsular através de um determinado proxy HTTP. Disponível a partir do cURL 7.3.0.

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.

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.

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.

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.

O tamanho esperado do arquivo, em bytes, ao enviá-lo a 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.

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.

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. Defina para uma das constantes CURL_IPRESOLVE_*. O 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.

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.

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.

Aceita uma string com a senha requerida para usar a chave privada CURLOPT_SSLKEY ou CURLOPT_SSH_PRIVATE_KEYFILE. 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.

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

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. 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. Esta opção aceita qualquer valor que possa ser convertido para um int válido. Disponível a partir do cURL 7.1.0.

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.

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.

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.

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

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.

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

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

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

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. Esta opção aceita qualquer valor que possa ser convertido para um int válido. 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. Esta opção aceita qualquer valor que possa ser convertido para um int válido. Disponível a partir do cURL 7.15.5.

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.

Defina como true para manter silêncio completo no que se refere às funções cURL. 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.

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.

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.

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.

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

Note:

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 do tipo callable com a seguinte assinatura:

curlHandle

O identificador cURL.

passwordPrompt

Uma string contendo um texto solicitando senha.

maximumPasswordLength

Comprimento máximo da senha.

Aceita uma string com a senha a ser usada na autenticação. Disponível a partir do cURL 7.19.1.

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.

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.

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

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.

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.

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

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.

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.

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 do tipo callable com a seguinte assinatura:

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.

Note:

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. O padrão é CURLPROTO_ALL, ou seja, o cURL aceitará todos os protocolos suportados. Consulte também CURLOPT_REDIR_PROTOCOLS. Disponível a partir do cURL 7.19.4 e descontinuada a partir do 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.

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.

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.

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.

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

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.

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.

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.

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.

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 CA do cURL esteja armazenado. Disponível a partir do PHP 7.3.0 e cURL 7.52.0.

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 CA do cURL esteja armazenado. Disponível a partir do PHP 8.2.0 e cURL 7.77.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.

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.

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.

Uma string com o certificado SSL do emissor do proxy. 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 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.

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

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

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.

Uma string com o certificado de cliente do proxy SSL. Disponível a partir do PHP 8.1.0 e cURL 7.71.0.

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.

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.

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.

Define a versão do TLS do proxy HTTPS para uma das constantes CURL_SSLVERSION_*. O padrão é CURL_SSLVERSION_DEFAULT.

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.

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.

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

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

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.

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.

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

Note:

A autenticação Secure Remote Password (SRP) para TLS fornece autenticação mútua se ambos os lados tiverem um segredo compartilhado. Para usar TLS-SRP, as opções CURLOPT_PROXY_TLSAUTH_USERNAME e CURLOPT_PROXY_TLSAUTH_PASSWORD também precisam ser definidas.

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_READDATA e CURLOPT_INFILESIZE. Disponível a partir do cURL 7.1.0 e descontinuada a partir do cURL 7.12.1.

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.

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.

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.

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. Defina como null para desabilitar a requisição de um intervalo de bytes. Disponível a partir do cURL 7.1.0.

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 do tipo callable com a seguinte assinatura:

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.

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 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 e descontinuada a partir do cURL 7.85.0.

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.

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.

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.

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", "example2.com:443:127.0.0.2", ) Disponível a partir do cURL 7.21.3.

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.

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

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.

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.

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.

Os métodos de autenticação SOCKS5 a serem utilizados. As opções são: 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. 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 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.

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.

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:

curlHandle

O identificador cURL.

keyType

Um dos tipos de chave CURLKHTYPE_*.

key

A chave a ser verificada.

keyLength

O comprimento da chave em bytes.

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.

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.

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

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.

O nome de um arquivo que contém um certificado no formato PEM. Disponível a partir do cURL 7.1.0.

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.

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.

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.

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.

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.

O nome de um arquivo que contém uma chave SSL privada. Disponível a partir do cURL 7.9.3.

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

Note:

Como esta opção contém uma senha confidencial, lembre-se de manter 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, DER, ENG. O padrão é PEM. Disponível a partir do cURL 7.9.3.

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.

Uma das constantes CURL_SSLVERSION_*.

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.

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 o cURL foi compilado suportá-lo), que pode ser usado para negociar HTTP2. Disponível a partir do PHP 7.0.7 e do cURL 7.36.0 e descontinuada a partir do cURL 7.86.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 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.

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.

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. Disponível a partir do cURL 7.8.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 de certificados CA instalado a partir do cURL 7.10. Disponível a partir do cURL 7.4.2.

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.

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.

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. O padrão é false. Disponível a partir do PHP 7.3.0 e cURL 7.54.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.

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. O padrão é true. 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.0.

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. O padrão é false. Disponível a partir do PHP 7.0.7 e do 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. Disponível a partir do cURL 7.1.0.

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.

O número máximo de milissegundos para permitir a execução de funções cURL. 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.

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.

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.

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

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. O padrão é false. Disponível a partir do cURL 7.1.1.

Permite o uso de soquetes de domínio Unix como terminal de conexão e define o caminho para a string fornecida. Defina como null para desabilitar. O padrão é null. 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. O padrão é false. Disponível a partir do cURL 7.10.4.

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 é CURL_UPKEEP_INTERVAL_DEFAULT que atualmente é 60 segundos. Disponível a partir do PHP 8.2.0 e cURL 7.62.0.

true para se preparar e realizar um envio. O padrão é false. Disponível a partir do cURL 7.1.0.

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

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 constantes CURLUSESSL_*. 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. Disponível a partir do cURL 7.1.0.

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. Available as cURL 7.1.0.

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.

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 do tipo callable com a seguinte assinatura:

curlHandle

O identificador cURL.

data

Os dados a serem escritos.

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.

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.

Uma função de retorno do tipo callable com a seguinte assinatura:

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.

Especifica o token de acesso do OAuth 2.0. Defina como null para desabilitar. O padrão é null. 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.