Curl: como usar e principais opções

Curl é uma ferramenta para transferir dados de/para um servidor, usando um dos protocolos suportados. Normalmente, usamos o HTTP, mas as opções são muitas, de FTP e GOPHER a IMAP e LDAP.

O cURL é uma ferramenta de linha de comando que funciona como interface para a biblioteca que faz o serviço pesado, o libcurl.

De forma geral, seu navegador realiza requisições web, recebe respostas, lê/escreve cookies e renderiza sua página. Você pode usar o cURL para fazer tudo isso, exceto a renderização, que cabe ao seu navegador.

Ele oferece uma infinidade de funções úteis como realização de autenticação, interação com API's, preencher formulários HTML, download de arquivos e páginas HTML, etc.

Instalando: como ativar o cURL

No Linux

• Para instalar, se você for usuário de GNU/Linux e usar distribuições baseadas em Debian (como o Ubuntu), basta executar:

• Para distros baseadas em Arch Linux execute:

Para outras distribuições, basta usar o seu gerenciador de pacotes padrão.

No macOS

• Há alguns anos o macOS já vem com o curl instalado. Execute curl --version para verificar. Se por algum motivo não estiver presente, é possivel instalar através do Homebrew:

No Windows

• As últimas versões do Windows também já estão vindo com o curl por padrão. Mas você pode baixar um instalador gráfico. Após isso, o curl deve estar em seu PATH e pronto para usar pelo CMD ou PowerShell.

Visualizando um HTML

• Por exemplo, você pode visualizar o conteúdo HTML da página da Alura executando:

• Nesse caso, não recebemos nenhum retorno, pois quando não incluímos o https:// na url, o site da Alura nos redireciona automaticamente para o endereço que usa HTTPS e o curl, por padrão, não faz redirecionamento. Para alterar esse comportamento e sermos redirecionados, é possível usar a opção -L:

• Agora temos um retorno, o conteúdo do site em HTML:

Também é possível obter uma resposta mais verbosa, permitindo visualizar os cabeçalhos da requisição HTTP usando a opção -i. Executando o comando abaixo você poderá vizualizar informações como o Status Code da resposta, a data e hora em que ela foi enviada, o tipo do conteúdo da resposta e várias outras informações que podem variar a depender da implementação do servidor.

• Agora o retorno é diferente, primeiro vem as informações de cabeçalho e depois o conteúdo:

A primeira linha indica a versão do protocolo HTTP usada e o Status Code de sucesso (200).

• Caso queira ignorar o conteúdo da página e receber somente o cabeçalho, você pode usar a opção -I (i maiúsculo):

• Resultando em:

Fazendo download de arquivos

Vamos utilizar aqui a mídia de instalação da última versão do Ubuntu como exemplo. Para fazer o download de um arquivo, salvando com o mesmo nome do arquivo definido pelo servidor, basta usar a opção -O.

O download será iniciado e as informações sobre ele serão exibidas:

• Para escolher o nome do arquivo que será salvo, basta adicionar o nome desejado no final do comando:

• Você também pode esconder informações de progresso do download usando a opção -s:

• Ou definir uma barra de progresso simples ao invés da informação mais completa com -#:

• O progresso do download será mostrado da seguinte forma:

• Caso um download seja interrompido, é possível continuá-lo usando a opção -C (mesmo que não tenha sido iniciado com o curl):

O hífen (-) após o 'C' indica ao curl para que ele descubra automaticamente onde/como continuar o download.

Interagindo com API's REST com GET e POST

O curl também é útil para realizar testes de API's REST. Tomemos como exemplo a aplicação da JSONPlaceholder que foi feita justamente para fins de testes.

• Ela possui as seguintes rotas:

• GET /posts
• GET /posts/:id
• GET /posts/:id/comments
• GET /comments?postId={:id}
• POST /posts
• PUT /posts/:id
• PATCH /posts/:id
• DELETE /posts/:id

• Por padrão, o curl usa o método HTTP GET para realizar as requisições. Para fazer uma requisição GET, basta executar:

• O retorno será em formato JSON contendo uma lista de posts:

• Também é possível especificar qual método usar, passando a opção -X e o método como argumento:

• Para realizar a criação de um post, você pode executar:

• Resultando em:

A opção -H permite adicionar um cabeçalho e a -d permite passar os dados da requisição. Nesse caso, definimos que o conteúdo é no formato JSON e passamos o conteúdo da requisição que será usado para criar uma conta. Podemos ver no resultado que o status foi 201, indicando que um novo recurso foi criado.

Usando o cURL em scripts

É indicado que sua aplicação possua testes automatizados para verificar se seu código está correto e se comportando da forma desejada. De preferência, esses testes devem implementados com bibliotecas nativas da tecnologia em que ela foi implementada, mas também é possível usar o curl em scripts para analisar o comportamento da aplicação.

Abaixo temos um exemplo de script usando o curl para verificar o status de cada requisição feita baseada num arquivo contendo uma lista de URLs para teste.

• Dado um arquivo chamado urls.txt contendo uma lista de URLs:

• Executando o script no mesmo local onde o arquivo está localizado:

• Temos o resultado:

Dessa forma não é necessario executar manualmente todos os comandos para realizar o teste basta adicionar os endereços desejados na lista de URLs.

cURL versus Postman

O curl, por ser uma ferramenta de linha de comando, tem uma interface menos amigável, mas permite um fluxo diferente no seu uso, podendo ser usado para automatizar tarefas.

Já o Postman possui uma interface gráfica que é mais amigável e permite criação de sessões e organizar seus testes por projetos e de várias outras formas. Se quiser saber mais sobre o Postman, confira este vídeo tutorial sobre a ferramenta no Alura+:

https://www.youtube.com/watch?v=op81bMbgZXs

Como na grande parte das questões relativas à tecnologia, qual das ferramentas usar vai depender do seu contexto e do seu objetivo. Avalie bem suas necessidades, teste as duas aplicações e decida o que for melhor para você.

Usamos muito Postman e cURLna Alura, tanto para testes quanto para automatizações.