
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),僅供參考