{"id":28656,"date":"2021-06-16T16:06:00","date_gmt":"2021-06-16T13:06:00","guid":{"rendered":"https:\/\/themewp.inform.click\/?p=28656"},"modified":"2021-10-18T03:59:20","modified_gmt":"2021-10-18T00:59:20","slug":"um-guia-de-integracao-do-hcaptcha-com-php","status":"publish","type":"post","link":"https:\/\/themewp.inform.click\/pt-pt\/um-guia-de-integracao-do-hcaptcha-com-php\/","title":{"rendered":"Um guia de integra\u00e7\u00e3o do hCaptcha com PHP"},"content":{"rendered":"

Recentemente, um de nossos leitores perguntou sobre a integra\u00e7\u00e3o do hCapctha em um site. O hCaptcha<\/a> \u00e9 uma boa alternativa ao servi\u00e7o reCAPTCHA do Google. Neste artigo, estudamos como adicionar hCapctha com PHP em seu site.<\/p>\n

\u00c9 sempre recomend\u00e1vel ter um captcha nos formul\u00e1rios do site. Os spams s\u00e3o muito ruins e s\u00f3 te deixam frustrado. Voc\u00ea nunca deseja perder seu valioso tempo limpando coment\u00e1rios falsos \/ desnecess\u00e1rios.<\/p>\n

Usando o hCaptcha, o usu\u00e1rio deve resolver os desafios antes de enviar um formul\u00e1rio. E seu formul\u00e1rio deve prosseguir apenas se o captcha passar na verifica\u00e7\u00e3o. Ao integrar o captcha, ele evita que uma tonelada de spams entrem no banco de dados e na sua caixa de entrada. Porque apenas um ser humano de verdade pode resolver os quebra-cabe\u00e7as do captcha.<\/p>\n

Dito isso, vamos dar uma olhada na integra\u00e7\u00e3o do hCaptcha com o PHP. \u00c9 necess\u00e1rio verificar a resposta do hCaptcha no lado do servidor. Vamos escrever o c\u00f3digo do lado do servidor usando as bibliotecas cURL e Guzzle. O usu\u00e1rio pode usar qualquer um deles.<\/p>\n

Come\u00e7ando<\/h3>\n

Voc\u00ea precisa primeiro criar uma conta com o servi\u00e7o hCaptcha<\/a>. Ao contr\u00e1rio do Google reCAPTCHA, voc\u00ea pode usar as chaves hCaptcha diretamente no seu site. Voc\u00ea n\u00e3o precisa registrar seu dom\u00ednio com eles.<\/p>\n

Mas se desejar, voc\u00ea pode adicionar seu dom\u00ednio clicando no bot\u00e3o Novo Site<\/strong>. Ele abrir\u00e1 um formul\u00e1rio onde voc\u00ea deve passar seu dom\u00ednio para o campo Hostnames.<\/p>\n

Em seguida, clique no \u00edcone de configura\u00e7\u00f5es da mesa e pegue a chave do seu site.<\/p>\n

\"Um<\/a><\/p>\n

Para obter a chave secreta, clique na guia ‘Configura\u00e7\u00f5es’.<\/p>\n

\"Um<\/a><\/p>\n

Quando voc\u00ea estiver pronto com as chaves, h\u00e1 2 etapas necess\u00e1rias a seguir. Primeiro, adicione o hCaptcha em seu formul\u00e1rio. E, em seguida, valide a resposta do captcha no lado do servidor.<\/p>\n

Vamos criar um formul\u00e1rio simples e adicionar hCaptcha a ele da seguinte maneira.<\/p>\n

<form action=\"\" method=\"POST\">\n\u00a0\u00a0\u00a0\u00a0<input type=\"text\" name=\"email\" placeholder=\"Email\" \/>\n\u00a0\u00a0\u00a0\u00a0<input type=\"password\" name=\"password\" placeholder=\"Password\" \/>\n\u00a0\u00a0\u00a0\u00a0<div class=\"h-captcha\" data-sitekey=\"YOUR_SITE_KEY\"><\/div>\n\u00a0\u00a0\u00a0\u00a0<br \/>\n\u00a0\u00a0\u00a0\u00a0<input type=\"submit\" name=\"submit\" value=\"Submit\" \/>\n<\/form>\n<script src=\"https:\/\/hcaptcha.com\/1\/api.js\" async defer><\/script><\/code><\/pre>\n
Aqui, inclu\u00edmos a biblioteca JavaScript de hCaptcha e adicionamos uma classe h-captcha<\/code>ao cont\u00eainer div. Voc\u00ea tamb\u00e9m precisa passar a chave do seu site para a chave do site de dados do atributo de dados<\/strong>.<\/p>\n
Recarregue a p\u00e1gina e voc\u00ea dever\u00e1 ver a caixa de sele\u00e7\u00e3o hCaptcha adicionada ao formul\u00e1rio. Vamos ver agora como validar a resposta do captcha.<\/p>\n
Validar a resposta hCaptcha usando cURL<\/h3>\n
Quando um usu\u00e1rio envia um formul\u00e1rio junto com um captcha, voc\u00ea precisa verificar a resposta do captcha no lado do servidor. Para verifica\u00e7\u00e3o, voc\u00ea deve enviar solicita\u00e7\u00f5es POST para o endpoint do hCaptcha https:\/\/hcaptcha.com\/siteverify<\/code>. Na solicita\u00e7\u00e3o POST, os par\u00e2metros s\u00e3o chave secreta e h-captcha-response (que vem do formul\u00e1rio enviado).<\/p>\n
Em PHP, podemos usar cURL e Guzzle para interagir com o servidor externo. Ao enviar solicita\u00e7\u00f5es por meio de cURL, certifique-se de que a extens\u00e3o cURL esteja habilitada em seu servidor.<\/p>\n
No caso do cURL, seu c\u00f3digo ser\u00e1 o seguinte para verificar a resposta do hCaptcha.<\/p>\n
<?php\nif (isset($_POST['submit'])) {\n\u00a0\u00a0\u00a0\u00a0$data = array(\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'secret' => \"YOUR_SECRET_KEY\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'response' => $_POST['h-captcha-response']\n\u00a0\u00a0\u00a0\u00a0);\n\u00a0\u00a0\u00a0\u00a0$ch = curl_init();\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_URL, \"https:\/\/hcaptcha.com\/siteverify\");\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_POST, true);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n\u00a0\u00a0\u00a0\u00a0$response = curl_exec($ch);\n\u00a0\u00a0\u00a0\u00a0$responseData = json_decode($response);\n\u00a0\u00a0\u00a0\u00a0if($responseData->success) {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\/\/ proceed the form\n\u00a0\u00a0\u00a0\u00a0} else {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo 'Robot verification failed, please try again.';\n\u00a0\u00a0\u00a0\u00a0}\n}\n?><\/code><\/pre>\n
Substitua o marcador pelo valor real. No c\u00f3digo acima, estamos verificando se a success<\/code>vari\u00e1vel \u00e9 verdadeira na resposta. Se for verdade, o formul\u00e1rio pode prosseguir com seguran\u00e7a.<\/p>\n
Validar a resposta hCaptcha usando Guzzle<\/h3>\n
Guzzle<\/a> \u00e9 uma alternativa ao cURL. Ele fornece um c\u00f3digo muito mais limpo em compara\u00e7\u00e3o com cURL. Se voc\u00ea estiver usando o Guzzle, n\u00e3o precisa ter uma extens\u00e3o cURL em seu servidor.<\/p>\n
Para come\u00e7ar, voc\u00ea precisa primeiro instalar a biblioteca Guzzle em seu projeto. Execute o comando abaixo para a instala\u00e7\u00e3o de uma biblioteca.<\/p>\n
composer require guzzlehttp\/guzzle<\/code><\/pre>\n
Depois disso, escreva o c\u00f3digo abaixo que verificar\u00e1 a resposta do hCAPTCHA usando a biblioteca Guzzle.<\/p>\n
<?php\nrequire_once 'vendor\/autoload.php';\n\u00a0\nuse GuzzleHttpClient;\n\u00a0\nif (isset($_POST['submit'])) {\n\u00a0\n\u00a0\u00a0\u00a0\u00a0$client = new Client([\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\/\/ Base URI is used with relative requests\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'base_uri' => 'https:\/\/hcaptcha.com',\n\u00a0\u00a0\u00a0\u00a0]);\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\n\u00a0\u00a0\u00a0\u00a0$response = $client->request('POST', '\/siteverify', [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'form_params' => [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'secret' => \"YOUR_SECRET_KEY\",\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'response' => $_POST['h-captcha-response']\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0]\n\u00a0\u00a0\u00a0\u00a0]);\n\u00a0\n\u00a0\u00a0\u00a0\u00a0$body = $response->getBody();\n\u00a0\u00a0\u00a0\u00a0$arr_body = json_decode($body);\n\u00a0\u00a0\u00a0\u00a0if($arr_body->success) {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\/\/ proceed the form\n\u00a0\u00a0\u00a0\u00a0} else {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo 'Robot verification failed, please try again.';\n\u00a0\u00a0\u00a0\u00a0}\n}\n?><\/code><\/pre>\n
Espero que voc\u00ea entenda a integra\u00e7\u00e3o do hCaptcha com PHP usando cURL e Guzzle. Por favor, compartilhe seus pensamentos e sugest\u00f5es na se\u00e7\u00e3o de coment\u00e1rios abaixo.<\/p>\n
Artigos relacionados<\/h4>\n