{"id":37131,"date":"2025-02-04T18:24:16","date_gmt":"2025-02-04T21:24:16","guid":{"rendered":"https:\/\/www.locaweb.com.br\/ajuda\/?post_type=ht_kb&p=37131"},"modified":"2025-02-17T13:45:17","modified_gmt":"2025-02-17T16:45:17","slug":"curl-php-post","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/curl-php-post\/","title":{"rendered":"Como enviar dados por cURL (POST) em PHP?"},"content":{"rendered":"

Enviar dados por cURL em PHP<\/strong> \u00e9 uma t\u00e9cnica comum para interagir com APIs ou enviar informa\u00e7\u00f5es a um servidor externo. Com o m\u00e9todo POST, voc\u00ea pode enviar dados como arrays ou at\u00e9 mesmo no formato JSON.<\/p>\n

Neste tutorial, vamos mostrar como configurar o ambiente PHP para usar cURL, realizar uma requisi\u00e7\u00e3o POST e como tratar a resposta do servidor de forma eficaz.<\/p>\n

Passo a passo para enviar dados com cURL com POST<\/h2>\n

Passo 1: configurar o ambiente PHP<\/h3>\n

Antes de enviar dados com cURL em PHP<\/a>, \u00e9 importante verificar se a extens\u00e3o cURL est\u00e1 habilitada no ambiente PHP. A maioria das instala\u00e7\u00f5es j\u00e1 inclui cURL por padr\u00e3o, mas voc\u00ea pode confirmar com o seguinte c\u00f3digo:<\/p>\n

 <\/p>\n

Caso o cURL n\u00e3o esteja habilitado, voc\u00ea precisar\u00e1 ativ\u00e1-lo no arquivo php.ini da sua instala\u00e7\u00e3o do PHP<\/strong>. Procure pela linha extension=curl<\/em> e remova o ponto e v\u00edrgula (;) no in\u00edcio, caso ele esteja l\u00e1. Em seguida, reinicie o servidor web para que a altera\u00e7\u00e3o tenha efeito.<\/p>\n

Passo 2: iniciar o recurso cURL<\/h3>\n

Agora que o ambiente PHP est\u00e1 pronto, vamos iniciar o cURL no c\u00f3digo. Para fazer isso, usamos a fun\u00e7\u00e3o curl_init()<\/em>, que cria uma nova sess\u00e3o cURL. Ela retorna um identificador de recurso cURL que ser\u00e1 usado nas chamadas seguintes.<\/p>\n

 <\/p>\n

Esse identificador de recurso $ch<\/em> ser\u00e1<\/strong> usado em todos os outros comandos cURL que voc\u00ea executar<\/strong>.<\/p>\n

Passo 3: definir URL e par\u00e2metros de envio<\/h3>\n

Com o recurso cURL iniciado, o pr\u00f3ximo passo \u00e9 configurar a URL para a qual voc\u00ea deseja enviar os dados. Al\u00e9m disso, vamos configurar os par\u00e2metros de envio (que no caso de um POST incluem os dados que voc\u00ea deseja enviar).<\/p>\n

 <\/p>\n

Agora, vamos passar esses dados para o cURL. Para fazer isso, usamos as op\u00e7\u00f5es CURLOPT_URL,<\/em> para definir a URL, e CURLOPT_POST<\/em> e a requisi\u00e7\u00e3o ser\u00e1 do tipo POST.<\/p>\n

Como configurar CURLOPT_POST e CURLOPT_POSTFIELDS<\/h4>\n

CURLOPT_POST<\/em> \u00e9 uma op\u00e7\u00e3o que define se a requisi\u00e7\u00e3o ser\u00e1 POST (valor true ou 1). J\u00e1 CURLOPT_POSTFIELDS<\/em> permite enviar os dados como um array ou string.<\/p>\n

 <\/p>\n

Exemplo de envio de dados em JSON<\/h4>\n

Se voc\u00ea precisar enviar os dados em formato JSON, basta alterar o formato dos dados e definir o cabe\u00e7alho Content-Type<\/em> como application\/json<\/em>:<\/p>\n

 <\/p>\n

Nesse exemplo, enviamos os dados como JSON. A op\u00e7\u00e3o CURLOPT_HTTPHEADER<\/em> \u00e9 usada para definir o cabe\u00e7alho de conte\u00fado como JSON<\/strong> e enviar o comprimento do corpo da requisi\u00e7\u00e3o.<\/p>\n

Passo 4: executar a requisi\u00e7\u00e3o e fechar o recurso<\/h3>\n

Agora que configuramos todos os par\u00e2metros, podemos executar a requisi\u00e7\u00e3o com a fun\u00e7\u00e3o curl_exec()<\/em>, que envia a requisi\u00e7\u00e3o HTTP para o servidor.<\/p>\n

 <\/p>\n

Aqui, usamos curl_exec($ch)<\/em> para enviar a requisi\u00e7\u00e3o e armazenar a resposta na vari\u00e1vel $response<\/em>.<\/p>\n

Se houver algum erro durante a requisi\u00e7\u00e3o, curl_errno<\/em>($ch)<\/em> ser\u00e1 verdadeiro, e voc\u00ea pode exibir a mensagem de erro com curl_error($ch)<\/em>.<\/p>\n

Finalmente, fechamos a sess\u00e3o com curl_close<\/em>($ch)<\/em>.<\/p>\n

Passo 5: tratar a resposta da requisi\u00e7\u00e3o<\/h3>\n

A resposta do servidor ser\u00e1 armazenada na vari\u00e1vel $response<\/em>. Agora, voc\u00ea pode trat\u00e1-la de acordo com o formato da resposta esperada. Se a resposta for em JSON, por exemplo, podemos decodific\u00e1-la com json_decode()<\/em>.<\/p>\n

 <\/p>\n

No exemplo acima, a resposta \u00e9 decodificada para um array PHP e podemos acessar os valores como qualquer outro array. Lembre-se de verificar o formato de resposta que o servidor retorna para saber como trat\u00e1-la.<\/p>\n

Exemplos pr\u00e1ticos<\/h2>\n

Vamos ver alguns exemplos pr\u00e1ticos de aplica\u00e7\u00e3o?<\/p>\n

Enviar dados em JSON para uma API<\/h3>\n

No exemplo abaixo, vamos enviar dados para uma API em formato JSON. As APIs modernas, geralmente, utilizam o formato JSON para troca de dados, ent\u00e3o, \u00e9 essencial saber como envi\u00e1-los corretamente com o cURL em PHP.<\/p>\n

Vamos criar um exemplo de envio de informa\u00e7\u00f5es de um usu\u00e1rio para uma API fict\u00edcia.<\/p>\n

Passos para envio de dados em JSON<\/h4>\n
    \n
  1. \n
      \n
    1. Dados a serem enviados<\/strong>: primeiro, criamos um array com as informa\u00e7\u00f5es do usu\u00e1rio;<\/li>\n
    2. Convers\u00e3o para JSON<\/strong>: usamos a fun\u00e7\u00e3o json_encode()<\/em> para converter o array em formato JSON;<\/li>\n
    3. Configura\u00e7\u00e3o do cURL<\/strong>: precisamos definir o cabe\u00e7alho HTTP para indicar que enviamos dados JSON;<\/li>\n
    4. Execu\u00e7\u00e3o da requisi\u00e7\u00e3o<\/strong>: enviamos a requisi\u00e7\u00e3o com o cURL e tratamos a resposta.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      Aqui est\u00e1 o c\u00f3digo completo:<\/p>\n

      <?php<\/span><\/i>\r\n\r\n\/\/ URL da API para onde os dados ser\u00e3o enviados<\/span><\/i>\r\n\r\n$url = 'https:\/\/api.exemplo.com\/usuarios';<\/span><\/i>\r\n\r\n\/\/ Dados do usu\u00e1rio a serem enviados<\/span><\/i>\r\n\r\n$data = array(<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'nome' => 'Maria Silva',<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'email' => 'maria@example.com',<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'idade' => 28<\/span><\/i>\r\n\r\n);<\/span><\/i>\r\n\r\n\/\/ Converte os dados para JSON<\/span><\/i>\r\n\r\n$jsonData = json_encode($data);<\/span><\/i>\r\n\r\n\/\/ Inicia a sess\u00e3o cURL<\/span><\/i>\r\n\r\n$ch = curl_init();<\/span><\/i>\r\n\r\n\/\/ Configura\u00e7\u00f5es do cURL<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_URL, $url); \/\/ Define a URL da API<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_POST, true); \/\/ Define o m\u00e9todo POST<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData); \/\/ Envia os dados JSON<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_HTTPHEADER, array(<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'Content-Type: application\/json', \/\/ Define o tipo de conte\u00fado como JSON<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'Content-Length: ' . strlen($jsonData) \/\/ Define o comprimento dos dados<\/span><\/i>\r\n\r\n));<\/span><\/i>\r\n\r\n\/\/ Executa a requisi\u00e7\u00e3o e armazena a resposta<\/span><\/i>\r\n\r\n$response = curl_exec($ch);<\/span><\/i>\r\n\r\n\/\/ Verifica se houve erro na requisi\u00e7\u00e3o<\/span><\/i>\r\n\r\nif(curl_errno($ch)) {<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0echo 'Erro cURL: ' . curl_error($ch);<\/span><\/i>\r\n\r\n} else {<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\/\/ Exibe a resposta da API<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0echo 'Resposta da API: ' . $response;<\/span><\/i>\r\n\r\n}<\/span><\/i>\r\n\r\n\/\/ Fecha a sess\u00e3o cURL<\/span><\/i>\r\n\r\ncurl_close($ch);<\/span><\/i>\r\n\r\n?><\/span><\/i><\/pre>\n
      Nesse exemplo, os dados s\u00e3o enviados como JSON para a URL especificada.<\/p>\n
      O cabe\u00e7alho Content-Type: application\/json<\/em> informa ao servidor que os dados est\u00e3o no formato JSON. A fun\u00e7\u00e3o curl_exec()<\/em> envia a requisi\u00e7\u00e3o e, se n\u00e3o houver erros, a resposta ser\u00e1 exibida.<\/p>\n
      Exemplo com manipula\u00e7\u00e3o de vari\u00e1veis de resposta<\/h3>\n
      Agora, vamos ver como tratar a resposta que recebemos da API. Muitas vezes, as APIs retornam dados em formato JSON e \u00e9 necess\u00e1rio manipular esses dados<\/strong> para utiliz\u00e1-los em sua aplica\u00e7\u00e3o.<\/p>\n
      Passos para manipula\u00e7\u00e3o da resposta<\/h4>\n
        \n
      1. \n
          \n
        1. Decodificar a resposta JSON<\/strong>: ap\u00f3s receber a resposta da API, precisamos decodific\u00e1-la com json_decode() <\/em>para transformar o JSON em um array ou objeto PHP;<\/li>\n
        2. Acessar os dados<\/strong>: uma vez decodificado, podemos acessar os dados de forma simples e manipul\u00e1-los como necess\u00e1rio.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
          Veja o exemplo de c\u00f3digo com manipula\u00e7\u00e3o de vari\u00e1veis de resposta:<\/p>\n
          <?php<\/span><\/i>\r\n\r\n\/\/ URL da API<\/span><\/i>\r\n\r\n$url = 'https:\/\/api.exemplo.com\/usuarios';<\/span><\/i>\r\n\r\n\/\/ Dados a serem enviados (em JSON, como mostrado antes)<\/span><\/i>\r\n\r\n$data = array(<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'nome' => 'Carlos Souza',<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'email' => 'carlos@example.com',<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'idade' => 34<\/span><\/i>\r\n\r\n);<\/span><\/i>\r\n\r\n\/\/ Converte os dados para JSON<\/span><\/i>\r\n\r\n$jsonData = json_encode($data);<\/span><\/i>\r\n\r\n\/\/ Inicia a sess\u00e3o cURL<\/span><\/i>\r\n\r\n$ch = curl_init();<\/span><\/i>\r\n\r\n\/\/ Configura\u00e7\u00f5es do cURL<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_URL, $url);<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_POST, true);<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);<\/span><\/i>\r\n\r\ncurl_setopt($ch, CURLOPT_HTTPHEADER, array(<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'Content-Type: application\/json',<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0'Content-Length: ' . strlen($jsonData)<\/span><\/i>\r\n\r\n));<\/span><\/i>\r\n\r\n\/\/ Executa a requisi\u00e7\u00e3o<\/span><\/i>\r\n\r\n$response = curl_exec($ch);<\/span><\/i>\r\n\r\n\/\/ Verifica se houve erro<\/span><\/i>\r\n\r\nif(curl_errno($ch)) {<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0echo 'Erro cURL: ' . curl_error($ch);<\/span><\/i>\r\n\r\n} else {<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\/\/ Decodifica a resposta JSON<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0$responseData = json_decode($response, true);<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\/\/ Acessa os dados da resposta<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0if (isset($responseData['status']) && $responseData['status'] == 'sucesso') {<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo 'Usu\u00e1rio cadastrado com sucesso!';<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo 'ID do usu\u00e1rio: ' . $responseData['id'];<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0} else {<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo 'Erro no cadastro: ' . $responseData['mensagem'];<\/span><\/i>\r\n\r\n\u00a0\u00a0\u00a0\u00a0}<\/span><\/i>\r\n\r\n}<\/span><\/i>\r\n\r\n\/\/ Fecha a sess\u00e3o cURL<\/span><\/i>\r\n\r\ncurl_close($ch);<\/span><\/i>\r\n\r\n?><\/span><\/i><\/pre>\n
          Nesse exemplo, ap\u00f3s enviar os dados, a resposta da API \u00e9 recebida e decodificada com json_decode()<\/em>. O c\u00f3digo verifica se o status da resposta \u00e9 “sucesso”<\/strong> e, em caso afirmativo, exibe o ID do usu\u00e1rio cadastrado. Caso contr\u00e1rio, ele exibe uma mensagem de erro.<\/p>\n
          A manipula\u00e7\u00e3o da resposta depende do formato e dos campos retornados pela API, e \u00e9 fundamental entender a estrutura do JSON para poder extrair e processar as informa\u00e7\u00f5es corretamente.<\/p>\n
          Erros comuns ao utilizar cURL em PHP<\/h2>\n
          O uso de cURL em PHP \u00e9 bastante comum para interagir com APIs e servi\u00e7os externos, mas \u00e9 poss\u00edvel se deparar com alguns erros. A seguir, discutimos alguns dos erros mais comuns ao utilizar cURL e como resolv\u00ea-los.<\/p>\n
          Como resolver problemas de conex\u00e3o e autentica\u00e7\u00e3o?<\/h3>\n
          Problemas de conex\u00e3o e autentica\u00e7\u00e3o s\u00e3o bastante comuns quando se trabalha com cURL em PHP. Veremos, abaixo, as solu\u00e7\u00f5es para esses problemas.<\/p>\n
          Erro de conex\u00e3o<\/h4>\n
          Um erro de conex\u00e3o ocorre quando o PHP n\u00e3o consegue se conectar ao servidor ou servi\u00e7o de destino. Isso pode ser causado por uma URL incorreta, problemas na rede ou no servidor de destino<\/strong>.<\/p>\n
          Solu\u00e7\u00e3o:<\/strong><\/p>\n