invisible-recaptcha配置速查siteKey、secretKey等5个关键配置项详解【免费下载链接】invisible-recaptchaAn invisible reCAPTCHA package for Laravel, Lumen, CI or native PHP.项目地址: https://gitcode.com/gh_mirrors/in/invisible-recaptchainvisible-recaptcha 是一款专为 Laravel、Lumen、CodeIgniter 或原生 PHP 打造的invisible reCAPTCHA 封装包让用户无需点击我不是机器人仅凭页面底部一个小小的角标badge即可完成人机验证。本文将带你快速掌握它的5 个关键配置项siteKey、secretKey、hideBadge、dataBadge和debug配一张.env速查表10 分钟完成全部配置。什么是 invisible-recaptcha传统 reCAPTCHA v2 要求用户手动勾选验证框而 invisible reCAPTCHA 是无感升级版不嵌入任何可见的验证框用户无感知仅在页面底部显示一个 reCAPTCHA 小角标提示站点正在使用该技术通过 src/config/captcha.php 一份配置文件即可完成所有定制⚠️ 注意申请密钥时务必在 Google 后台选择invisible reCAPTCHA类型选错类型会导致验证失败。5 个关键配置项详解 所有配置定义在src/config/captcha.php通过构造函数注入核心类 src/InvisibleReCaptcha.php并可通过.env环境变量覆盖。1️⃣ siteKey —— 前端身份标识必填siteKey env(INVISIBLE_RECAPTCHA_SITEKEY),对应.env变量INVISIBLE_RECAPTCHA_SITEKEY作用写入前端 HTML 的data-sitekey属性用于加载 invisible reCAPTCHA 脚本安全提示siteKey 会暴露在前端可以公开但切勿与 secretKey 混淆2️⃣ secretKey —— 后端验证密钥必填secretKey env(INVISIBLE_RECAPTCHA_SECRETKEY),对应.env变量INVISIBLE_RECAPTCHA_SECRETKEY作用提交表单后服务端用它向 Google 的siteverify接口发起验证请求见 src/InvisibleReCaptcha.php 中的verifyResponse方法安全提示secretKey 属于机密只应存在于服务器端.env中不要提交到代码仓库3️⃣ hideBadge —— 隐藏角标可选hideBadge env(INVISIBLE_RECAPTCHA_BADGEHIDE, false),对应.env变量INVISIBLE_RECAPTCHA_BADGEHIDE设为true时会注入一段 CSSdisplay:none !important把 reCAPTCHA 角标隐藏掉⚠️ 官方建议不建议完全隐藏角标保留它能提升用户信任度4️⃣ dataBadge —— 角标位置可选dataBadge env(INVISIBLE_RECAPTCHA_DATABADGE, bottomright),对应.env变量INVISIBLE_RECAPTCHA_DATABADGE三个可选值取值效果bottomright右下角默认值bottomleft左下角inline行内模式可用自定义 CSS 控制位置5️⃣ debug —— 控制台调试开关可选debug env(INVISIBLE_RECAPTCHA_DEBUG, false),对应.env变量INVISIBLE_RECAPTCHA_DEBUG设为true后浏览器控制台会打印_submitForm、_captchaForm、_captchaSubmit三个元素的绑定状态见renderDebug方法用途当点击提交没反应时第一时间用它在控制台定位是哪一环没绑定成功生产环境请保持false 附赠配置项timeout请求超时timeout env(INVISIBLE_RECAPTCHA_TIMEOUT, 5),对应.env变量INVISIBLE_RECAPTCHA_TIMEOUTGuzzle HTTP 客户端的超时秒数默认 5 秒弱网环境可适当调大.env 配置速查表 在 Laravel 项目根目录的.env文件中一次性写全即可// 必填 INVISIBLE_RECAPTCHA_SITEKEY{你的siteKey} INVISIBLE_RECAPTCHA_SECRETKEY{你的secretKey} // 可选 INVISIBLE_RECAPTCHA_BADGEHIDEfalse INVISIBLE_RECAPTCHA_DATABADGEbottomright INVISIBLE_RECAPTCHA_TIMEOUT5 INVISIBLE_RECAPTCHA_DEBUGfalse在 Laravel 5.5 中服务提供者 src/InvisibleReCaptchaServiceProvider.php 支持包自动发现无需手动注册它还会把配置文件发布到config/captcha.php供你直接修改。常见坑位提醒 ⚠️密钥类型选错申请时没选 invisible reCAPTCHA验证永远失败——去后台重新生成一对表单里只有 1 个 submit 按钮invisible reCAPTCHA 通过拦截 submit 事件触发验证按钮的type必须是submit且表单内只能有一个render() 必须在 form 内调用captcha或app(captcha)-render()需要放在form标签内验证规则要加上Laravel 校验规则写入g-recaptcha-response required|captchacaptcha规则由服务提供者自动注册多表单场景master 分支不支持同一页面多个验证码多表单需求请使用multi-forms分支总结 ✅invisible-recaptcha 的 5 个关键配置项各司其职siteKey和secretKey是身份与验证的基石必填hideBadge控制角标显隐dataBadge决定角标位置debug是排障利器。全部配置集中在src/config/captcha.php配合.env即可零代码完成部署——让我是人类的验证从此对用户彻底隐身。【免费下载链接】invisible-recaptchaAn invisible reCAPTCHA package for Laravel, Lumen, CI or native PHP.项目地址: https://gitcode.com/gh_mirrors/in/invisible-recaptcha创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考