O cURL é um instrumento de linha de comando que facilita a obtenção ou envio de dados através da sintaxe de URL.
Se você atua como desenvolvedor ou em funções de suporte técnico, é imprescindível que esteja familiarizado com o uso do comando cURL para diagnosticar problemas em aplicações web. O cURL é uma ferramenta versátil, compatível com diversos sistemas operacionais, incluindo Windows, macOS e UNIX.
A seguir, apresentamos algumas das sintaxes mais utilizadas, acompanhadas de exemplos práticos para melhor compreensão.
Verificação da Conectividade com uma URL
Ao trabalhar em um ambiente UNIX e tentar acessar uma URL externa, o primeiro passo é verificar se a conexão com a URL é possível através do cURL.
curl yoururl.com
Essa ação normalmente não produzirá nenhuma saída visível. No entanto, se o servidor não conseguir se conectar, mensagens de erro, como “não foi possível resolver o host”, serão exibidas.
[[email protected] tmp]# curl helloitdoesntexist.com curl: (6) Could not resolve host: helloitdoesntexist.com; Unknown error [[email protected] tmp]#
Salvando o Conteúdo de uma URL/URI em um Arquivo
Caso necessite salvar o conteúdo de uma URL ou URI em um arquivo específico, utilize a seguinte sintaxe:
curl https://yoururl.com > yoururl.html
Exemplo:
[[email protected] tmp]# curl https://gf.dev > /tmp/gfhtml
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 18557 0 18557 0 0 72565 0 --:--:-- --:--:-- --:--:-- 72772
[[email protected] tmp]#
O comando acima salvará todo o conteúdo da página gf.dev no arquivo /tmp/gf.html.
Exibindo os Cabeçalhos de Requisição e Resposta
Em situações de problemas de conexão, é útil validar se os cabeçalhos de requisição e resposta estão sendo recebidos corretamente.
curl -v yoururl.com
Exemplo:
[[email protected] tmp]# curl -v https://etechpt.com.com * About to connect() to etechpt.com.com port 443 (#0) * Trying 104.25.134.107... * Connected to etechpt.com.com (104.25.134.107) port 443 (#0) * Initializing NSS with certpath: sql:/etc/pki/nssdb * CAfile: /etc/pki/tls/certs/ca-bundle.crt CApath: none * SSL connection using TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 * Server certificate: * subject: CN=ssl371609.cloudflaressl.com,OU=PositiveSSL Multi-Domain,OU=Domain Control Validated * start date: Nov 07 00:00:00 2019 GMT * expire date: May 15 23:59:59 2020 GMT * common name: ssl371609.cloudflaressl.com * issuer: CN=COMODO ECC Domain Validation Secure Server CA 2,O=COMODO CA Limited,L=Salford,ST=Greater Manchester,C=GB > GET / HTTP/1.1 > User-Agent: curl/7.29.0 > Host: etechpt.com.com > Accept: */* > < HTTP/1.1 200 OK < Date: Sat, 09 Nov 2019 19:41:37 GMT < Content-Type: text/html; charset=UTF-8 < Transfer-Encoding: chunked < Connection: keep-alive < Set-Cookie: __cfduid=d2ce6cd359ebc0b6eb5ff3a454ed042021573328497; expires=Sun, 08-Nov-20 19:41:37 GMT; path=/; domain=.etechpt.com.com; HttpOnly; Secure < Vary: Accept-Encoding < Link: <https://etechpt.com.com/wp-json/>; rel="https://api.w.org/" < Link: <https://etechpt.com.com/>; rel=shortlink < X-SRCache-Fetch-Status: HIT < X-SRCache-Store-Status: BYPASS < X-Frame-Options: SAMEORIGIN < X-Powered-By: EasyEngine v4.0.12 < Via: 1.1 google < CF-Cache-Status: DYNAMIC < Strict-Transport-Security: max-age=15552000; preload < X-Content-Type-Options: nosniff < Alt-Svc: h3-23=":443"; ma=86400 < Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct" < Server: cloudflare < CF-RAY: 533243e4bcd4bbf4-LHR <
Download com Limite de Velocidade
Para simular downloads em diferentes velocidades, útil em otimizações, utilize o seguinte comando:
curl –-limit-rate 2000B
Exemplo:
curl –-limit-rate 2000B https://gf.dev
Conexão Utilizando um Proxy
Esta funcionalidade é essencial quando você trabalha em servidores DMZ e necessita acessar recursos externos através de um proxy.
curl --proxy yourproxy:port https://yoururl.com
O cURL permite a inclusão de cabeçalhos personalizados para testes ou resolução de problemas. Veja o exemplo para definir o Content-Type:
curl --header 'Content-Type: application/json' http://yoururl.com
Ao executar o comando acima, o cURL incluirá o cabeçalho Content-Type com o valor application/json na requisição.
Para verificar rapidamente os cabeçalhos de resposta, utilize a seguinte sintaxe:
curl --head http://yoururl.com
Exemplo:
[[email protected] tmp]# curl --head https://chandan.io HTTP/1.1 200 OK Date: Sat, 09 Nov 2019 19:51:23 GMT Content-Type: text/html Connection: keep-alive Set-Cookie: __cfduid=d3cb2c7b8e566ad99c870b0af12b0f1eb1573329083; expires=Sun, 08-Nov-20 19:51:23 GMT; path=/; domain=.chandan.io; HttpOnly X-GUploader-UploadID: AEnB2Uo96JhvJmR2zYUL-Ndh2ta3UD_ykQAB5C7O8cjZQhCf-GxHQ0MsodSzRnl3guSN3ywAYNjtWcPXfwDXjLg3bQ-P5vQMOA Expires: Sat, 09 Nov 2019 20:51:23 GMT Cache-Control: public, max-age=3600 Last-Modified: Mon, 06 Aug 2018 10:45:47 GMT x-goog-generation: 1533552347482034 x-goog-metageneration: 1 x-goog-stored-content-encoding: identity x-goog-stored-content-length: 24620 x-goog-hash: crc32c=DpDPAQ== x-goog-hash: md5=cIP/3rusdUx12Zla1kf1yA== x-goog-storage-class: MULTI_REGIONAL Accept-Ranges: bytes CF-Cache-Status: DYNAMIC Expect-CT: max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct" Server: cloudflare CF-RAY: 53325234dc2fbb9a-LHR [[email protected] tmp]#
Conexão com URLs HTTPS/SSL Ignorando Erros de Certificado
Ao tentar acessar uma URL segura com um certificado SSL/TLS inválido ou com um CN (Common Name) não correspondente, um erro semelhante ao seguinte será exibido:
curl: (51) Unable to communicate securely with peer: requested domain name does not match the server's certificate.
Felizmente, o cURL permite ignorar esses erros de certificação através do sinalizador --insecure.
curl --insecure https://yoururl.com
Conexão Utilizando um Protocolo Específico (SSL/TLS)
Esta funcionalidade é crucial para testar se uma URL específica pode estabelecer uma conexão segura utilizando um protocolo SSL/TLS específico.
Para conexões usando SSL v3:
curl --sslv3 https://yoururl.com
Para testar diferentes versões do TLS:
curl --tlsv1 https://example.com curl --tlsv1.0 https://example.com curl --tlsv1.1 https://example.com curl --tlsv1.2 https://example.com curl --tlsv1.3 https://example.com
Download de Arquivos de Servidores FTP
O cURL também pode ser utilizado para baixar arquivos de servidores FTP, especificando nome de usuário e senha.
curl -u user:password -O ftp://ftpurl/style.css
O sinalizador -v pode ser usado em conjunto com qualquer sintaxe para exibir informações detalhadas da operação.
O cabeçalho de host é útil para testar uma URL em relação a um IP, quando o conteúdo está disponível apenas com o cabeçalho de host correto. Ou, para testar aplicações usando o IP ou URL de um balanceador de carga.
curl --header 'Host: targetapplication.com' https://192.0.0.1:8080/
cURL Online
Sim, é possível utilizar o cURL online através de diversas ferramentas. Isso permite executar comandos cURL remotamente.
O Online CURL é uma ferramenta simples para acessar URLs online, oferecendo as seguintes opções:
--connect-timeout --cookie --data --header --head --location --max-time --proxy --request --user --url --user-agent
Construtor de Linha de Comando cURL – esta ferramenta oferece uma interface gráfica para criar comandos cURL, que podem ser gerados e copiados para utilização.
O cURL é uma ferramenta valiosa para diagnosticar problemas de conectividade em tempo real. Esperamos que as informações acima tenham sido úteis. Se desejar aprofundar seus conhecimentos, recomendamos o curso online Fundamentos da Linha de Comando do Linux.