O comando curl no Linux
Percebe a finalidade, lê a sintaxe e explora os exemplos antes de adaptares o comando ao teu sistema.
O que faz e quando utilizar
Cabeçalhos. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
Como escrever o comando
curl [opções] URL
Os elementos entre [ ] são opcionais e as reticências indicam que um argumento pode repetir-se. Estes sinais explicam a estrutura: não são texto para escrever literalmente. Na secção seguinte encontras exemplos completos.
O nome curl identifica a ferramenta ou o interno da shell. As opções ajustam o comportamento; os restantes argumentos indicam os dados, nomes ou caminhos usados na operação.
Exemplos explicados
Começa pelos exemplos de consulta. Quando uma operação altera dados ou configurações, lê o aviso e confirma os argumentos antes de a executar.
1. Cabeçalhos
Cabeçalhos. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -I https://example.com2. Seguir redirecionamentos
Seguir redirecionamentos. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -IL https://example.com3. Código HTTP
Código HTTP. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -sS -o /dev/null -w "%{http_code}\n" https://example.com4. Tempo de resposta
Tempo de resposta. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -sS -o /dev/null -w "%{time_total}\n" https://example.com5. Testar vhost local
Testar vhost local. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl --resolve teste.exemplo.test:80:192.0.2.15 -I http://teste.exemplo.test/6. Diagnóstico detalhado
Diagnóstico detalhado. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -vI https://example.com7. Guardar ficheiro
Guardar ficheiro. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -fL -o ficheiro.zip https://example.com/ficheiro.zip8. Timeout
Timeout. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl --connect-timeout 5 --max-time 15 -I https://example.com9. Mostrar certificados
Mostrar certificados. Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -vI https://example.com 2>&1 | grep -i certificate10. POST JSON (exemplo)
POST JSON (exemplo). Transfere dados através de URLs e permite inspecionar pedidos e respostas HTTP. -I pede apenas cabeçalhos, -L segue redirecionamentos e -o escolhe um ficheiro de saída. Valida o certificado HTTPS e confirma o destino antes de enviar dados com opções de formulário ou autenticação.
curl -X POST -H "Content-Type: application/json" -d '{"teste":true}' https://example.com/api11. Consultar cabeçalhos de um serviço local
Pede apenas os cabeçalhos HTTP a um serviço no próprio computador.
curl -I --max-time 10 http://127.0.0.1/Como interpretar
-I utiliza o método HEAD e --max-time limita a duração total a dez segundos. O exemplo só contacta a interface local.
O código HTTP descreve a resposta recebida; um servidor pode tratar HEAD de forma diferente de GET, pelo que esta consulta não testa toda a página.
Erros frequentes e como os evitar
- Nomes de contas, pacotes, dispositivos e caminhos são ilustrativos: têm de corresponder ao sistema onde vais trabalhar.
- Não assumes que /dev/hda ou /dev/sda identificam o mesmo disco em duas máquinas. Confirma o dispositivo e o estado de montagem.
Uma forma de praticar
Escolhe um dos exemplos acima e identifica o programa, cada opção e os argumentos. Explica por palavras tuas qual deverá ser o resultado. Se faltar um ficheiro, pacote ou dispositivo, resolve primeiro esse requisito; não acrescentes privilégios apenas para tentar eliminar uma mensagem de erro.
Testa primeiro uma variante de consulta, usando ficheiros de ensaio quando fizer sentido. Compara o resultado com a explicação e só depois acrescenta outra opção, para perceberes o efeito de cada alteração.