curl

curl envia requisições HTTP/HTTPS a partir da hospedagem, mostra status, cabeçalhos e corpo, aceita métodos, dados, cookies e Basic Auth e pode salvar ou abrir a resposta em um editor.

RedeVersão 1.2.5Estável
lil-terminal

Visão geral

Use curl quando importa saber como um endpoint responde a partir do próprio servidor: APIs, redirecionamentos, cabeçalhos, IPv4/IPv6 ou download de respostas sem shell do sistema.

Requisição, resposta e ponto de execução

curl roda no servidor de hospedagem, não no navegador local. Comece com um GET simples ou apenas cabeçalhos e adicione corpo, autenticação ou flags de diagnóstico quando necessário; -k desativa deliberadamente a verificação do certificado.

Sintaxe

lil-terminal
curl <url|host|me> [options]

Referência

curl me

usar o host atual

curl example.com

enviar uma solicitação GET e mostrar status e corpo

curl example.com -I

mostrar somente os cabeçalhos da resposta final

curl example.com -s [file]

salvar a resposta; usar o nome do arquivo da URL quando omitido

curl example.com -X POST -d "a=1"

enviar um corpo de solicitação

-X <method>

definir o método HTTP

-d <data>

definir o corpo da solicitação; padrão POST

-H "Name: value"

adicionar um cabeçalho de solicitação; pode ser repetido

-u <user>

usar autenticação HTTP Basic por meio de uma solicitação de senha oculta

-c '{"name":"value"}'

enviar cookies de um objeto JSON

-s [file] | -o <file>

salvar a resposta no host

-a

acrescentar em vez de substituir; requer -s ou -o

-i

incluir os cabeçalhos finais da resposta

-I

mostrar somente os cabeçalhos finais da resposta

-j

mostrar a resposta como JSON estruturado

-edit @edit

abrir o corpo da resposta no editor de texto

-code @code

abrir o corpo da resposta no editor de código

-t [seconds]

usar 5 segundos ou um tempo limite personalizado de 1 a 300

-T

usar um tempo limite de 300 segundos

-4 | -6

usar IPv4 ou IPv6 quando cURL estiver disponível

-r

não seguir redirecionamentos

-k

permitir um certificado TLS inseguro

Uso prático

Comece com curl example.com para ler a resposta ou -I para ver só os cabeçalhos. -i inclui cabeçalhos e -j retorna JSON estruturado. Para APIs, use -X, -d e -H repetido. -s/-o salvam no servidor, -a acrescenta; -edit/-code abrem o texto no editor instalado.

Limites e segurança

-u <user> solicita a senha separadamente, mas dados em -d e cookies podem ficar no histórico. TLS e até cinco redirecionamentos são verificados por padrão; -k desliga a verificação e -r impede redirecionamentos. Sem PHP cURL, requisições comuns usam streams PHP; -4/-6 exigem cURL. Limites: 8 MiB na tela e 256 MiB ao salvar. Acesse apenas endereços autorizados, inclusive serviços internos. Respostas didáticas, sem conexão real.

Verificação explícita de IPv4/IPv6

curl -4/-6 avisa quando a extensão PHP cURL está ausente, sem ignorar silenciosamente o filtro.

Prévia interativa do sandbox

Execute os exemplos preparados diretamente na página. Os resultados são predefinidos e exibidos no navegador; nenhum comando do terminal é executado no servidor.

Verificar cabeçalhos e depois salvar uma resposta

Instalar e gerenciar

Instale a versão compatível atual. Escolha Base para o conjunto completo de recursos ou Minimum para o pacote reduzido; use upgrade para atualizar um módulo já instalado.

Base e Minimum são dois pacotes da mesma versão atual do módulo.

Pacote Base

Instala o pacote completo com referência local e todos os modos publicados.

install curl
Pacote Minimum

Instalar o pacote reduzido. A referência local é omitida; help <cmd> -i abre a referência atual do servidor.

install curl -m
Versão pública exata

Instalar exatamente esta versão publicada.

install curl -v 1.2.5
Verificar ou atualizar

upgrade verifica compatibilidade e substitui o bloco somente quando necessário.

upgrade curl
Remover módulo

Remove o bloco da extensão sem afetar o núcleo ou outros módulos.

install curl -u

Exemplos

Os exemplos podem ser copiados, mas o site não os executa. Revise caminhos, permissões e opções destrutivas.

Verificar cabeçalhos e depois salvar uma resposta
curl https://example.com
Exemplo de rede ilustrativo — sem requisição real
HTTP:		200
URL:		https://example.com/

<!doctype html>
<html>…</html>
Usar o host atual
curl me
Exemplo de rede ilustrativo — sem requisição real
HTTP:		200
URL:		https://example.com/

<!doctype html>
<html>…</html>
Mostrar somente os cabeçalhos da resposta final
curl https://example.com -I
Exemplo de rede ilustrativo — sem requisição real
HTTP/2 200
content-type: text/html; charset=UTF-8
cache-control: max-age=86000
Incluir os cabeçalhos finais da resposta
curl https://example.com -i
Exemplo de rede ilustrativo — sem requisição real
HTTP/2 200
content-type: text/html; charset=UTF-8

<!doctype html>
<html>…</html>
Mostrar a resposta como JSON estruturado
curl https://example.com -j
Exemplo de rede ilustrativo — sem requisição real
{
  "status": 200,
  "url": "https://example.com/",
  "headers": [
    "HTTP/2 200",
    "content-type: text/html; charset=UTF-8"
  ],
  "body": "<html>…</html>"
}
Enviar um corpo de solicitação
curl https://example.com -X POST -d "name=lil"
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Example response to a POST request; the server may reject POST or return another status.
Definir o corpo da solicitação; padrão POST
curl https://example.com -d "name=lil"
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Example response to a POST request; the server may reject POST or return another status.
Adicionar um cabeçalho de solicitação; pode ser repetido
curl https://example.com -H "Accept: application/json"
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Request contains custom headers; the remote reply depends on the endpoint.
Adicionar um cabeçalho de solicitação; pode ser repetido
curl https://example.com -H "Accept: application/json" -H "X-Demo: 1"
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Request contains custom headers; the remote reply depends on the endpoint.
Enviar cookies de um objeto JSON
curl https://example.com -c '{"theme":"dark"}'
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Request includes Cookie: theme=dark; the server decides how to respond.
Usar autenticação HTTP Basic por meio de uma solicitação de senha oculta
curl https://example.com -u demo
Exemplo de rede ilustrativo — sem requisição real
A separate secret-password prompt appears before the request is sent.
Salvar a resposta; usar o nome do arquivo da URL quando omitido
curl https://example.com -s
Exemplo de rede ilustrativo — sem requisição real
sandbox/
  index.html
The response body is saved on the hosting account.
Rejeitar um protocolo não suportado
curl https://example.com -s tmp/example.html
Exemplo de rede ilustrativo — sem requisição real
sandbox/tmp/
  example.html
The response body is saved on the hosting account.
Salvar a resposta no host
curl https://example.com -o tmp/example.html
Exemplo de rede ilustrativo — sem requisição real
sandbox/tmp/
  example.html
The response body is saved on the hosting account.
Acrescentar em vez de substituir; requer -s ou -o
curl https://example.com -o tmp/example.html -a
Exemplo de rede ilustrativo — sem requisição real
sandbox/tmp/
  example.html
The body is appended to the existing file.
Usar 5 segundos ou um tempo limite personalizado de 1 a 300
curl https://example.com -t
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Timeout option changes the maximum wait, not the response format.
Usar 5 segundos ou um tempo limite personalizado de 1 a 300
curl https://example.com -t 2
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Timeout option changes the maximum wait, not the response format.
Usar um tempo limite de 300 segundos
curl https://example.com -T
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Timeout option changes the maximum wait, not the response format.
Usar IPv4 ou IPv6 quando cURL estiver disponível
curl https://example.com -4
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Requested IP family IPv4 (requires PHP cURL).
Usar IPv4 ou IPv6 quando cURL estiver disponível
curl https://example.com -6
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Requested IP family IPv6 (requires PHP cURL).
Não seguir redirecionamentos
curl https://example.com -r
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Redirect following disabled; response status depends on endpoint.
Permitir um certificado TLS inseguro
curl https://example.com -k
Exemplo de rede ilustrativo — sem requisição real
HTTP: 200
URL: https://example.com/

Certificate verification disabled for this diagnostic request.
Abrir o corpo da resposta no editor de texto
curl https://example.com -edit
Exemplo de rede ilustrativo — sem requisição real
The installed text editor opens the response in a protected temporary file.
Abrir o corpo da resposta no editor de código
curl https://example.com -code
Exemplo de rede ilustrativo — sem requisição real
The installed code editor opens the response in a protected temporary file.
Mostrar a resposta como JSON estruturado
curl https://example.com -j -code
Exemplo de rede ilustrativo — sem requisição real
The installed code editor opens the response in a protected temporary file as formatted JSON.
Abrir o corpo da resposta no editor de texto
curl https://example.com -edit -s tmp/example.html
Exemplo de rede ilustrativo — sem requisição real
Editor mode cannot be combined with -s or -o
Acrescentar em vez de substituir; requer -s ou -o
curl https://example.com -a
Exemplo de rede ilustrativo — sem requisição real
Append requires an output file
Curl · com
curl ftp://example.com
Exemplo de rede ilustrativo — sem requisição real
Invalid URL
Usar IPv4 ou IPv6 quando cURL estiver disponível
curl https://example.com -4 -6
Exemplo de rede ilustrativo — sem requisição real
Choose either IPv4 or IPv6
Definir o método HTTP
curl https://example.com -X 9bad
Exemplo de rede ilustrativo — sem requisição real
Invalid HTTP method
Adicionar um cabeçalho de solicitação; pode ser repetido
curl https://example.com -H "broken"
Exemplo de rede ilustrativo — sem requisição real
Invalid header
Enviar cookies de um objeto JSON
curl https://example.com -c not-json
Exemplo de rede ilustrativo — sem requisição real
Invalid cookie JSON
Usar 5 segundos ou um tempo limite personalizado de 1 a 300
curl https://example.com -t 301
Exemplo de rede ilustrativo — sem requisição real
Invalid timeout
Salvar a resposta no host
curl https://example.com -o
Exemplo de rede ilustrativo — sem requisição real
Output file required
Abrir o corpo da resposta no editor de texto
curl https://example.com -edit -code
Exemplo de rede ilustrativo — sem requisição real
Choose one editor

Documentação relacionada

Quais diagnósticos de rede estão disponíveis? →O que acontece se repo.lil.dog ficar indisponível? →

Versão pública atual

v1.2.52026-10-31

Verificação explícita de IPv4/IPv6

curl -4/-6 avisa quando a extensão PHP cURL está ausente, sem ignorar silenciosamente o filtro.

# Histórico de versões