As contantes abaixo são definidas por esta extensão e
só estarão disponíveis quando a extensão tiver sido compilada no PHP
ou tiver sido carregada dinamicamente em tempo de execução.
Constantes |
Descrição |
curl_getinfo()
CURLINFO_APPCONNECT_TIME
(int)
|
Tempo em segundos que levou desde o início até que a conexão/handshake SSL/SSH com o host remoto fosse concluída.
|
CURLINFO_APPCONNECT_TIME_T
(int)
|
Tempo, em microssegundos, desde o início até que a conexão/handshake SSL/SSH com o host remoto fosse concluída.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
CURLINFO_CAINFO
(int)
|
Caminho do certificado CA integrado padrão.
Disponível a partir do PHP 8.3.0 e cURL 7.84.0.
|
CURLINFO_CAPATH
(int)
|
String de caminho de CA integrada padrão.
Disponível a partir do PHP 8.3.0 e cURL 7.84.0.
|
CURLINFO_CERTINFO
(int)
|
Cadeia de certificados TLS.
|
CURLINFO_CONDITION_UNMET
(int)
|
Informações sobre condicional de tempo não cumprido.
|
CURLINFO_CONNECT_TIME
(int)
|
Tempo decorrido para estabelecer a conexão em segundos.
|
CURLINFO_CONNECT_TIME_T
(int)
|
Tempo total gasto, em microssegundos, desde o início até a conexão com o host remoto (ou proxy) ser concluída.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
CURLINFO_CONTENT_LENGTH_DOWNLOAD
(int)
|
Comprimento do conteúdo do download, lido do campo "Content-Length:"
|
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
(int)
|
O comprimento do conteúdo do recebimento. Este é o valor lido do campo "Content-Length:" menos 1 se o tamanho não for conhecido.
Disponível a partir do PHP 7.3.0 e cURL 7.55.0.
|
CURLINFO_CONTENT_LENGTH_UPLOAD
(int)
|
Tamanho especificado de envio
|
CURLINFO_CONTENT_LENGTH_UPLOAD_T
(int)
|
O tamanho especificado do envio. -1 se o tamanho não for conhecido.
Disponível a partir do PHP 7.3.0 e cURL 7.55.0.
|
CURLINFO_CONTENT_TYPE
(int)
|
"Content-Type:" do documento solicitado. NULL indica que o servidor não enviou cabeçalho "Content-Type:" válido
|
CURLINFO_COOKIELIST
(int)
|
Todos os cookies conhecidos.
|
CURLINFO_EFFECTIVE_URL
(int)
|
Último URL efetivo
|
CURLINFO_FILETIME
(int)
|
Horário remoto do documento recuperado, com CURLOPT_FILETIME habilitado; se -1 for retornado o horário do documento é desconhecido.
|
CURLINFO_FILETIME_T
(int)
|
Horário remoto do documento recuperado (como timestamp Unix), uma alternativa a CURLINFO_FILETIME para permitir que sistemas com variáveis longas de 32 bits extraiam datas fora do intervalo de timestamp de 32 bits.
Disponível a partir do PHP 7.3.0 e cURL 7.59.0.
|
CURLINFO_FTP_ENTRY_PATH
(int)
|
Caminho de entrada no servidor FTP.
|
A string de solicitação enviada. Para que isso funcione, adicione a opção CURLINFO_HEADER_OUT ao identificador chamando curl_setopt().
|
Tamanho total de todos os cabeçalhos recebidos.
|
CURLINFO_HTTPAUTH_AVAIL
(int)
|
Máscara de bits indicando o(s) método(s) de autenticação disponíveis de acordo com a resposta anterior.
|
CURLINFO_HTTP_CODE
(int)
|
O último código de resposta.
A partir do cURL 7.10.8, este é um apelido legado de CURLINFO_RESPONSE_CODE .
|
CURLINFO_HTTP_CONNECTCODE
(int)
|
O código de resposta CONNECT.
|
CURLINFO_HTTP_VERSION
(int)
|
A versão usada na última conexão HTTP. O valor de retorno será uma das constantes CURL_HTTP_VERSION_* definidas ou 0 se a versão não puder ser determinada.
Disponível a partir do PHP 7.3.0 e cURL 7.50.0.
|
CURLINFO_LOCAL_IP
(int)
|
Endereço IP local (fonte) da conexão mais recente.
|
CURLINFO_LOCAL_PORT
(int)
|
Porta local (fonte) da conexão mais recente.
|
CURLINFO_NAMELOOKUP_TIME
(int)
|
Tempo em segundos até a resolução do nome ser concluída.
|
CURLINFO_NAMELOOKUP_TIME_T
(int)
|
Tempo em microssegundos desde o início até a conclusão da resolução do nome.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
CURLINFO_NUM_CONNECTS
(int)
|
Número de conexões que o curl teve que criar para alcançar a transferência anterior.
|
CURLINFO_OS_ERRNO
(int)
|
Número de erro devido a uma falha de conexão. O número é específico do sistema operacional e do sistema.
|
CURLINFO_PRETRANSFER_TIME
(int)
|
Tempo em segundos desde o início até pouco antes do início da transferência do arquivo.
|
CURLINFO_PRETRANSFER_TIME_T
(int)
|
Tempo decorrido desde o início até o início da transferência do arquivo, em microssegundos.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
CURLINFO_PRIMARY_IP
(int)
|
Endereço IP da conexão mais recente.
|
CURLINFO_PRIMARY_PORT
(int)
|
Porta de destino da conexão mais recente.
|
CURLINFO_PRIVATE
(int)
|
Dados privados associados a este identificador cURL, previamente definido com a opção CURLOPT_PRIVATE de curl_setopt().
|
CURLINFO_PROTOCOL
(int)
|
O protocolo usado na última conexão HTTP. O valor retornado será exatamente um dos valores CURLPROTO_* .
Disponível a partir do PHP 7.3.0 e cURL 7.52.0.
|
CURLINFO_PROXYAUTH_AVAIL
(int)
|
Máscara de bits indicando o(s) método(s) de autenticação de proxy disponíveis de acordo com a resposta anterior.
|
CURLINFO_PROXY_ERROR
(int)
|
O código de erro de proxy detalhado (SOCKS) quando a transferência mais recente retornou um erro CURLE_PROXY . O valor retornado será exatamente um dos valores CURLPX_* . O código de erro será CURLPX_OK se nenhum código de resposta estiver disponível.
Disponível a partir do PHP 8.2.0 e cURL 7.73.0.
|
CURLINFO_PROXY_SSL_VERIFYRESULT
(int)
|
O resultado da verificação do certificado solicitado (usando a opção CURLOPT_PROXY_SSL_VERIFYPEER ). Usado apenas para proxies HTTPS.
Disponível a partir do PHP 7.3.0 e cURL 7.52.0.
|
CURLINFO_REDIRECT_COUNT
(int)
|
Número de redirecionamentos, com a opção CURLOPT_FOLLOWLOCATION habilitada.
|
CURLINFO_REDIRECT_TIME
(int)
|
Tempo em segundos de todas as etapas de redirecionamento antes do início da transação final, com a opção CURLOPT_FOLLOWLOCATION habilitada.
|
CURLINFO_REDIRECT_TIME_T
(int)
|
Tempo total, em microssegundos, necessário para todas as etapas de redirecionamento, incluindo pesquisa de nome, conexão, pré-transferência e transferência, antes do início da transação final.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
CURLINFO_REDIRECT_URL
(int)
|
Com a opção CURLOPT_FOLLOWLOCATION desabilitada: URL de redirecionamento encontrada na última transação, que deverá ser solicitada manualmente a seguir. Com a opção CURLOPT_FOLLOWLOCATION habilitada: fica vazia. A URL de redirecionamento neste caso está disponível em CURLINFO_EFFECTIVE_URL .
|
CURLINFO_REFERER
(int)
|
O cabeçalho do referenciador.
Disponível a partir do PHP 8.2.0 e cURL 7.76.0.
|
CURLINFO_REQUEST_SIZE
(int)
|
Tamanho total de solicitações emitidas, atualmente apenas para solicitações HTTP.
|
CURLINFO_RESPONSE_CODE
(int)
|
O último código de resposta.
Disponível a partir do cURL 7.10.8.
|
CURLINFO_RETRY_AFTER
(int)
|
As informações do cabeçalho "Retry-After:" ou zero se não houver cabeçalho válido.
Disponível a partir do PHP 8.2.0 e cURL 7.66.0
|
CURLINFO_RTSP_CLIENT_CSEQ
(int)
|
Próximo CSeq do cliente RTSP.
|
CURLINFO_RTSP_CSEQ_RECV
(int)
|
CSeq recebido recentemente.
|
CURLINFO_RTSP_SERVER_CSEQ
(int)
|
Próximo CSeq do servidor RTSP.
|
CURLINFO_RTSP_SESSION_ID
(int)
|
ID da sessão RTSP.
|
CURLINFO_SCHEME
(int)
|
O esquema de URL usado para a conexão mais recente.
Disponível a partir do PHP 7.3.0 e cURL 7.52.0.
|
CURLINFO_SIZE_DOWNLOAD
(int)
|
Número total de bytes recebidos.
|
CURLINFO_SIZE_DOWNLOAD_T
(int)
|
Número total de bytes que foram recebidos. O número é apenas para a última transferência e será redefinido novamente a cada nova transferência.
Disponível a partir do PHP 7.3.0 e cURL 7.50.0.
|
CURLINFO_SIZE_UPLOAD
(int)
|
Número total de bytes enviados.
|
CURLINFO_SIZE_UPLOAD_T
(int)
|
Número total de bytes que foram enviados.
Disponível a partir do PHP 7.3.0 e cURL 7.50.0.
|
CURLINFO_SPEED_DOWNLOAD
(int)
|
Velocidade média de recebimento.
|
CURLINFO_SPEED_DOWNLOAD_T
(int)
|
A velocidade média de recebimento em bytes/segundo medida para o recebimento completo.
Disponível a partir do PHP 7.3.0 e cURL 7.50.0.
|
CURLINFO_SPEED_UPLOAD
(int)
|
Velocidade média de envio.
|
CURLINFO_SPEED_UPLOAD_T
(int)
|
A velocidade média de envio em bytes/segundo medida para o envio completo.
Disponível a partir do PHP 7.3.0 e cURL 7.50.0.
|
CURLINFO_SSL_ENGINES
(int)
|
Motores criptográficos OpenSSL suportados.
|
CURLINFO_SSL_VERIFYRESULT
(int)
|
Resultado da verificação da certificação SSL solicitada pela configuração CURLOPT_SSL_VERIFYPEER .
|
CURLINFO_STARTTRANSFER_TIME
(int)
|
Tempo em segundos até que o primeiro byte esteja prestes a ser transferido.
|
CURLINFO_STARTTRANSFER_TIME_T
(int)
|
Tempo, em microssegundos, desde o início até o recebimento do primeiro byte.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
CURLINFO_TOTAL_TIME
(int)
|
Tempo total de transação em segundos para a última transferência.
|
CURLINFO_TOTAL_TIME_T
(int)
|
Tempo total em microssegundos para a transferência anterior, incluindo resolução de nomes, conexão TCP etc.
Disponível a partir do PHP 7.3.0 e cURL 7.61.0.
|
Constantes |
Descrição |
cURL error constants
CURLE_ABORTED_BY_CALLBACK
(int)
|
Abortado por retorno de chamada. Um retorno de chamada retornou "abort" para libcurl.
|
CURLE_BAD_CALLING_ORDER
(int)
|
|
CURLE_BAD_CONTENT_ENCODING
(int)
|
Codificação de transferência não reconhecida.
|
CURLE_BAD_DOWNLOAD_RESUME
(int)
|
O download não pôde ser retomado porque o deslocamento especificado estava fora do limite do arquivo.
|
CURLE_BAD_FUNCTION_ARGUMENT
(int)
|
Uma função foi chamada com um parâmetro incorreto.
|
CURLE_BAD_PASSWORD_ENTERED
(int)
|
|
CURLE_COULDNT_CONNECT
(int)
|
Falha ao conectar ao host ou proxy.
|
CURLE_COULDNT_RESOLVE_HOST
(int)
|
Não foi possível resolver o host. O host remoto fornecido não foi resolvido.
|
CURLE_COULDNT_RESOLVE_PROXY
(int)
|
Não foi possível resolver o proxy. O host proxy fornecido não pôde ser resolvido.
|
CURLE_FAILED_INIT
(int)
|
Falha no código de inicialização antecipada.
É provável que seja um erro ou problema interno,
ou um problema de recursos em que algo fundamental não pôde ser feito no momento da inicialização.
|
CURLE_FILESIZE_EXCEEDED
(int)
|
Tamanho máximo do arquivo excedido.
|
CURLE_FILE_COULDNT_READ_FILE
(int)
|
Um arquivo fornecido com FILE:// não pôde ser aberto.
Provavelmente porque o caminho do arquivo não identifica um arquivo existente ou
devido à falta de permissões de arquivo apropriadas.
|
CURLE_FTP_ACCESS_DENIED
(int)
|
|
CURLE_FTP_BAD_DOWNLOAD_RESUME
(int)
|
|
CURLE_FTP_CANT_GET_HOST
(int)
|
Uma falha interna ao pesquisar o host usado para a nova conexão.
|
CURLE_FTP_CANT_RECONNECT
(int)
|
|
CURLE_FTP_COULDNT_GET_SIZE
(int)
|
|
CURLE_FTP_COULDNT_RETR_FILE
(int)
|
Esta foi uma resposta inesperada a um comando 'RETR'
ou uma transferência de zero byte concluída.
|
CURLE_FTP_COULDNT_SET_ASCII
(int)
|
|
CURLE_FTP_COULDNT_SET_BINARY
(int)
|
|
CURLE_FTP_COULDNT_STOR_FILE
(int)
|
|
CURLE_FTP_COULDNT_USE_REST
(int)
|
O comando FTP REST retornou um erro.
Isso nunca deveria acontecer se o servidor estiver saudável.
|
CURLE_FTP_PARTIAL_FILE
(int)
|
|
CURLE_FTP_PORT_FAILED
(int)
|
O comando FTP PORT retornou erro.
Isso acontece principalmente quando um endereço bom o suficiente não foi especificado para uso da libcurl.
Consulte CURLOPT_FTPPORT .
|
CURLE_FTP_QUOTE_ERROR
(int)
|
|
CURLE_FTP_SSL_FAILED
(int)
|
|
CURLE_FTP_USER_PASSWORD_INCORRECT
(int)
|
|
CURLE_FTP_WEIRD_227_FORMAT
(int)
|
Os servidores FTP retornam uma linha 227 como resposta a um comando PASV.
Se a libcurl não conseguir analisar essa linha, esse código de retorno será retornado.
|
CURLE_FTP_WEIRD_PASS_REPLY
(int)
|
Após enviar a senha do FTP ao servidor, a libcurl espera uma resposta adequada.
Este código de erro indica que um código inesperado foi retornado.
|
CURLE_FTP_WEIRD_PASV_REPLY
(int)
|
A libcurl não conseguiu obter um resultado sensato do servidor
como resposta a um comando PASV ou EPSV. O servidor está falho.
|
CURLE_FTP_WEIRD_SERVER_REPLY
(int)
|
O servidor enviou dados que o libcurl não pôde analisar.
Este código de erro é conhecido como CURLE_WEIRD_SERVER_REPLY
a partir do cURL 7.51.0.
|
CURLE_FTP_WEIRD_USER_REPLY
(int)
|
|
CURLE_FTP_WRITE_ERROR
(int)
|
|
CURLE_FUNCTION_NOT_FOUND
(int)
|
Função não encontrada. Uma função zlib necessária não foi encontrada.
|
CURLE_GOT_NOTHING
(int)
|
Nada foi retornado do servidor e, dadas as circunstâncias,
não receber nada é considerado um erro.
|
CURLE_HTTP_NOT_FOUND
(int)
|
|
CURLE_HTTP_PORT_FAILED
(int)
|
|
CURLE_HTTP_POST_ERROR
(int)
|
Este é um erro estranho que ocorre principalmente devido a confusão interna.
|
CURLE_HTTP_RANGE_ERROR
(int)
|
|
CURLE_HTTP_RETURNED_ERROR
(int)
|
Isto é retornado se CURLOPT_FAILONERROR estiver definido como true
e o servidor HTTP retornar um código de erro maior ou igual a 400.
|
CURLE_LDAP_CANNOT_BIND
(int)
|
O LDAP não pode ser vinculado. A operação de ligação LDAP falhou.
|
CURLE_LDAP_INVALID_URL
(int)
|
|
CURLE_LDAP_SEARCH_FAILED
(int)
|
A pesquisa LDAP falhou.
|
CURLE_LIBRARY_NOT_FOUND
(int)
|
|
CURLE_MALFORMAT_USER
(int)
|
|
CURLE_OBSOLETE
(int)
|
|
CURLE_OK
(int)
|
Tudo bem. Proceda normalmente.
|
CURLE_OPERATION_TIMEDOUT
(int)
|
Tempo limite de operação.
O período de tempo limite especificado foi alcançado de acordo com as condições.
|
CURLE_OPERATION_TIMEOUTED
(int)
|
|
CURLE_OUT_OF_MEMORY
(int)
|
Falha na solicitação de alocação de memória.
|
CURLE_PARTIAL_FILE
(int)
|
A transferência de arquivos foi mais curta ou maior que o esperado.
Isso acontece quando o servidor primeiro informa um tamanho de transferência esperado
e depois entrega dados que não correspondem ao tamanho fornecido anteriormente.
|
CURLE_PROXY
(int)
|
Erro de estabelecimento de comunicação com o proxy.
CURLINFO_PROXY_ERROR fornece detalhes extras sobre o problema específico.
Disponível a partir do PHP 8.2.0 e cURL 7.73.0.
|
CURLE_READ_ERROR
(int)
|
Ocorreu um problema ao ler um arquivo local ou um erro retornado pelo retorno de chamada de leitura.
|
CURLE_RECV_ERROR
(int)
|
Falha no recebimento de dados da rede.
|
CURLE_SEND_ERROR
(int)
|
Falha ao enviar dados de rede.
|
CURLE_SHARE_IN_USE
(int)
|
|
CURLE_SSH
(int)
|
Ocorreu um erro não especificado durante a sessão SSH.
Disponível a partir do cURL 7.16.1.
|
CURLE_SSL_CACERT
(int)
|
|
CURLE_SSL_CACERT_BADFILE
(int)
|
Problema ao ler o certificado SSL CA.
|
CURLE_SSL_CERTPROBLEM
(int)
|
Problema com o certificado do cliente local.
|
CURLE_SSL_CIPHER
(int)
|
Não foi possível usar a cifra especificada.
|
CURLE_SSL_CONNECT_ERROR
(int)
|
Ocorreu um problema em algum lugar na comunicação inicial SSL/TLS.
A leitura da mensagem no buffer de erros fornece mais detalhes sobre o problema.
Podem ser certificados (formatos de arquivo, caminhos, permissões), senhas e outros.
|
CURLE_SSL_ENGINE_NOTFOUND
(int)
|
O mecanismo de criptografia especificado não foi encontrado.
|
CURLE_SSL_ENGINE_SETFAILED
(int)
|
Falha ao definir o mecanismo de criptografia SSL selecionado como padrão.
|
CURLE_SSL_PEER_CERTIFICATE
(int)
|
|
CURLE_SSL_PINNEDPUBKEYNOTMATCH
(int)
|
Falha ao corresponder à chave fixada especificada com
CURLOPT_PINNEDPUBLICKEY .
|
CURLE_TELNET_OPTION_SYNTAX
(int)
|
|
CURLE_TOO_MANY_REDIRECTS
(int)
|
Muitos redirecionamentos. Ao seguir redirecionamentos, a libcurl atingiu o valor máximo.
O limite pode ser definido com CURLOPT_MAXREDIRS .
|
CURLE_UNKNOWN_TELNET_OPTION
(int)
|
|
CURLE_UNSUPPORTED_PROTOCOL
(int)
|
A URL passada para libcurl usou um protocolo que a libcurl não suporta.
O problema pode ser uma opção de tempo de compilação que não foi usada,
uma string de protocolo com erro ortográfico ou apenas um protocolo para o qual a libcurl não possui código.
|
CURLE_URL_MALFORMAT
(int)
|
O URL não foi formatado corretamente.
|
CURLE_URL_MALFORMAT_USER
(int)
|
|
CURLE_WEIRD_SERVER_REPLY
(int)
|
O servidor enviou dados que a libcurl não pôde analisar.
Este código de erro era conhecido como CURLE_FTP_WEIRD_SERVER_REPLY
antes do cURL 7.51.0.
Disponível a partir do PHP 7.3.0 e cURL 7.51.0.
|
CURLE_WRITE_ERROR
(int)
|
Ocorreu um erro ao gravar dados recebidos em um arquivo local
ou um erro foi retornado para a libcurl a partir de um retorno de chamada de gravação.
|