Como fazer um pedido GET com curl_init?

A função curl_init() do PHP pode ser usada para iniciar a comunicação com um servidor web e recuperar dados via o método GET. Ao especificar a URL desejada, os desenvolvedores podem facilitar tarefas como aquisição de dados e interação com APIs!

Miguel Oliveira

Miguel Oliveira

4 agosto 2025

Como fazer um pedido GET com curl_init?

Apidog para empresas

Implantação local

SSO & RBAC

Conforme SOC 2

Explorar Apidog Enterprise

cURL, abreviação de "Cliente para URLs," é uma potência de software que capacita desenvolvedores com um conjunto versátil de ferramentas para transferir dados. Oferece duas funcionalidades: uma ferramenta de linha de comando amigável e uma poderosa biblioteca que pode ser integrada a programas.

💡
Apidog é uma sofisticada plataforma de desenvolvimento de API que fornece aos desenvolvedores uma infinidade de funcionalidades para todo o ciclo de vida da API.

Se você precisa editar ou testar seus comandos PHP cURL, confira o site da Apidog clicando no botão abaixo.
button

Definição Formal de curl_init()

Com base no site oficial do PHP, a função curl_init inicializa uma sessão cURL e retorna um identificador cURL para uso com as funções curl_setopt(), curl_exec() e curl_close().

Parâmetros Envolvidos

url

Se você fornecer uma URL, a opção CURLOPT_URL será definida como seu valor. Você também pode definir essa opção manualmente usando a função curl_setopt().

No entanto, observe que o protocolo file está desativado pelo próprio cURL se o open_basedir estiver definido.

Valores de Retorno

A função curl_init() retorna um identificador cURL em caso de sucesso, e false em caso de erro.

O que é uma Requisição GET?

No contexto do Protocolo de Transferência de Hipertexto (HTTP), uma requisição GET é um método específico usado para recuperar dados de um recurso designado em um servidor. É classificada como um método seguro, o que significa que não altera o estado do recurso em si. Aqui está uma descrição da definição formal:

Função

A requisição GET é uma representação do recurso especificado.

Resultado Esperado

Uma requisição GET bem-sucedida deve retornar uma resposta contendo os dados solicitados, tipicamente na forma de HTML, texto ou outros formatos de dados.

Modificação de Dados

As requisições GET destinam-se a recuperar informações existentes e não devem ser usadas para modificar dados no servidor.

Cache

As respostas às requisições GET geralmente podem ser armazenadas em cache pelo cliente (navegador da web) e servidores intermediários, o que pode melhorar o desempenho para solicitações subsequentes ao mesmo recurso.

Pontos-Chave da Requisição GET

Exemplos de Código de curl_init() Requisições GET

Para ter uma vantagem na compreensão de como fazer requisições GET com a função curl_init(), continue lendo esta seção!

Requisição GET Básica

<?php

$url = "https://www.example.com";

// Inicializa o curl
$ch = curl_init($url);

// Define a opção para retornar a transferência como uma string
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Executa a requisição
$response = curl_exec($ch);

// Verifica se há erros
if(curl_errno($ch)) {
  echo 'Erro:' . curl_error($ch);
} else {
  // Processa a resposta (por exemplo, echo, decodifica JSON)
  echo $response;
}

// Fecha a sessão curl
curl_close($ch);

?>

Requisição GET com Opção Adicional

<?php

$url = "https://www.example.com";

// Inicializa o curl
$ch = curl_init($url);

// Define o agente do usuário
curl_setopt($ch, CURLOPT_USERAGENT, "Meu Script PHP");

// Define a opção para seguir redirecionamentos
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);

// Define a opção para retornar a transferência como uma string
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Executa a requisição
$response = curl_exec($ch);

// Verifica se há erros
if(curl_errno($ch)) {
  echo 'Erro:' . curl_error($ch);
} else {
  // Processa a resposta
  echo $response;
}

// Fecha a sessão curl
curl_close($ch);

?>

Exemplo de Requisição GET Complexa

Esta é uma requisição GET ligeiramente complicada que envolve uma API que permite filtrar produtos com base na faixa de preço da categoria e opções de ordenação.

<?php

$url = "https://api.example.com/products";

// Define os parâmetros do filtro
$filters = array(
  "category" => "eletrônicos",
  "price_min" => 100,
  "price_max" => 500,
  "sort" => "price_asc"
);

// Constroi a string da consulta com os parâmetros codificados
$queryString = http_build_query($filters);
$url .= "?" . $queryString;

// Inicializa o curl
$ch = curl_init($url);

// Define a opção para retornar a transferência como uma string
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

// Define cabeçalhos para indicar que dados JSON são esperados (opcional)
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
  'Content-Type: application/json'
));

// Executa a requisição
$response = curl_exec($ch);

// Verifica se há erros
if(curl_errno($ch)) {
  echo 'Erro:' . curl_error($ch);
} else {
  // Decodifica a resposta JSON (supondo que a resposta seja JSON)
  $data = json_decode($response, true);
  
  // Processa os dados (por exemplo, itera pelos produtos)
  if (isset($data['products'])) {
    foreach ($data['products'] as $product) {
      echo "Nome do Produto: " . $product['name'] . ", Preço: $" . $product['price'] . PHP_EOL;
    }
  }
}

// Fecha a sessão curl
curl_close($ch);

?>

Explicação do Código:

  1. Definimos uma URL de ponto final da API e parâmetros de filtro (categoria, faixa de preço e ordenação).
  2. Usamos http_build_query para criar uma string de consulta com valores de parâmetro codificados e anexá-la à URL.
  3. curl_setopt define opções para a requisição, incluindo a captura da resposta e potencialmente configurando cabeçalhos se a API espera um formato de dados específico (como JSON).
  4. Após a verificação de erros, a resposta é decodificada como JSON (supondo que a API retorne dados JSON).
  5. Iteramos pelos dados decodificados (array de produtos) e exibimos os detalhes do produto.

Nota Importante

Observe que estes são apenas exemplos de código que foram simplificados para explicar como é possível fazer requisições GET usando a função curl_init(), portanto, verifique se as modificações necessárias são feitas em seu respectivo IDE!

Para a documentação oficial, você pode verificar em: https://www.php.net/manual/en/book.curl.php

Apidog - Trabalhe Com Arquivos cURL Sem Esforço

Apidog é uma sofisticada plataforma de desenvolvimento de API que fornece aos usuários todas as ferramentas necessárias para todo o ciclo de vida da API. Com funcionalidades de ferramentas populares como Postman e Insomnia, você não precisa mais baixar nenhum outro aplicativo!

especificações do apidog
button

Importe Rápido Comandos cURL para o Apidog

importar curl apidog

O Apidog suporta usuários que desejam importar comandos cURL para Apidog. Em um projeto vazio, clique no botão roxo + na parte superior esquerda da janela do Apidog e selecione Importar cURL.

exemplo de código stripe curl

Copie e cole o comando cURL na caixa exibida em sua tela.

sucesso na importação do código curl

Se bem-sucedido, você deve agora conseguir visualizar o comando cURL na forma de uma requisição de API.

button

Gere Código PHP com Apidog

Se você precisar de assistência com codificação PHP, o Apidog tem um recurso de geração de código que pode ajudá-lo com isso.

apedog gerar código de cliente

Primeiro, localize o botão </> Gerar Código em qualquer API ou requisição e selecione Gerar Código de Cliente na lista suspensa.

apidog gerar código php

Em seguida, selecione PHP e encontre a seção cURL. Agora você deve ver o código gerado para cURL. Tudo o que você precisa fazer é copiar e colar no seu IDE (Ambiente de Desenvolvimento Integrado) e continuar desenvolvendo seu aplicativo.

Conclusão

A função curl_init() no PHP permite que você recupere dados de servidores da web usando requisições GET. Este bloco de construção fundamental permite que você interaja com APIs, faça download de arquivos e colete conteúdo da web. Ao dominar curl_init(), você pode automatizar tarefas, coletar informações programaticamente e estender a funcionalidade de seus aplicativos PHP.

Lembre-se de explorar as extensas opções oferecidas pelo cURL para ajustar suas requisições, lidar com erros de forma adequada e garantir uma comunicação segura. Com sua versatilidade e poder, curl_init() desbloqueia um mundo de possibilidades para seus empreendimentos de desenvolvimento web.

Explore more

Plugin de Entrega ao Vivo do Qwen: Como Executar Tarefas Longas de Agente com Controle Total

Plugin de Entrega ao Vivo do Qwen: Como Executar Tarefas Longas de Agente com Controle Total

O plugin de entrega contínua ao vivo (Live Delivery Plugin) de código aberto do Qwen transforma uma longa tarefa do Codex em uma série de versões utilizáveis que você pode direcionar a partir de um workbench no navegador. Veja o que ele inclui, como instalá-lo, os orçamentos, o aviso sobre...

16 novembro 2026

Como Usar o Qwen4-Max Grátis: 1 Milhão de Tokens de API e Mais 3 Alternativas

Como Usar o Qwen4-Max Grátis: 1 Milhão de Tokens de API e Mais 3 Alternativas

O Qwen4-Max tem uma cota gratuita de 1 milhão de tokens na API de Cingapura do QwenCloud. Veja como aproveitá-la sem ser surpreendido por cobranças, até onde ela vai, as alternativas gratuitas mais acessíveis (Qoder, QwenWork, QwenStudio) e quando a API paga sai mais barato.

16 novembro 2026

Benchmarks do Qwen4-Max: Work360, Terminal-Bench 4.0 e o que as pontuações significam

Benchmarks do Qwen4-Max: Work360, Terminal-Bench 4.0 e o que as pontuações significam

O Qwen4-Max supera o Qwen3.8-Max em todos os benchmarks compartilhados e lidera em 4 de 16 no total, mas 10 dessas pontuações vieram de execuções feitas pela própria Alibaba. Aqui estão todos os números, quem executou cada teste e como fazer sua própria verificação.

16 novembro 2026

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs