invisible-recaptcha配置速查siteKey、secretKey等5個(gè)關(guān)鍵配置項(xiàng)詳解【免費(fèi)下載鏈接】invisible-recaptchaAn invisible reCAPTCHA package for Laravel, Lumen, CI or native PHP.項(xiàng)目地址: https://gitcode.com/gh_mirrors/in/invisible-recaptchainvisible-recaptcha 是一款專為 Laravel、Lumen、CodeIgniter 或原生 PHP 打造的invisible reCAPTCHA 封裝包讓用戶無需點(diǎn)擊我不是機(jī)器人僅憑頁(yè)面底部一個(gè)小小的角標(biāo)badge即可完成人機(jī)驗(yàn)證。本文將帶你快速掌握它的5 個(gè)關(guān)鍵配置項(xiàng)siteKey、secretKey、hideBadge、dataBadge和debug配一張.env速查表10 分鐘完成全部配置。什么是 invisible-recaptcha傳統(tǒng) reCAPTCHA v2 要求用戶手動(dòng)勾選驗(yàn)證框而 invisible reCAPTCHA 是無感升級(jí)版不嵌入任何可見的驗(yàn)證框用戶無感知僅在頁(yè)面底部顯示一個(gè) reCAPTCHA 小角標(biāo)提示站點(diǎn)正在使用該技術(shù)通過 src/config/captcha.php 一份配置文件即可完成所有定制?? 注意申請(qǐng)密鑰時(shí)務(wù)必在 Google 后臺(tái)選擇invisible reCAPTCHA類型選錯(cuò)類型會(huì)導(dǎo)致驗(yàn)證失敗。5 個(gè)關(guān)鍵配置項(xiàng)詳解 所有配置定義在src/config/captcha.php通過構(gòu)造函數(shù)注入核心類 src/InvisibleReCaptcha.php并可通過.env環(huán)境變量覆蓋。1?? siteKey —— 前端身份標(biāo)識(shí)必填siteKey env(INVISIBLE_RECAPTCHA_SITEKEY),對(duì)應(yīng).env變量INVISIBLE_RECAPTCHA_SITEKEY作用寫入前端 HTML 的data-sitekey屬性用于加載 invisible reCAPTCHA 腳本安全提示siteKey 會(huì)暴露在前端可以公開但切勿與 secretKey 混淆2?? secretKey —— 后端驗(yàn)證密鑰必填secretKey env(INVISIBLE_RECAPTCHA_SECRETKEY),對(duì)應(yīng).env變量INVISIBLE_RECAPTCHA_SECRETKEY作用提交表單后服務(wù)端用它向 Google 的siteverify接口發(fā)起驗(yàn)證請(qǐng)求見 src/InvisibleReCaptcha.php 中的verifyResponse方法安全提示secretKey 屬于機(jī)密只應(yīng)存在于服務(wù)器端.env中不要提交到代碼倉(cāng)庫(kù)3?? hideBadge —— 隱藏角標(biāo)可選hideBadge env(INVISIBLE_RECAPTCHA_BADGEHIDE, false),對(duì)應(yīng).env變量INVISIBLE_RECAPTCHA_BADGEHIDE設(shè)為true時(shí)會(huì)注入一段 CSSdisplay:none !important把 reCAPTCHA 角標(biāo)隱藏掉?? 官方建議不建議完全隱藏角標(biāo)保留它能提升用戶信任度4?? dataBadge —— 角標(biāo)位置可選dataBadge env(INVISIBLE_RECAPTCHA_DATABADGE, bottomright),對(duì)應(yīng).env變量INVISIBLE_RECAPTCHA_DATABADGE三個(gè)可選值取值效果bottomright右下角默認(rèn)值bottomleft左下角inline行內(nèi)模式可用自定義 CSS 控制位置5?? debug —— 控制臺(tái)調(diào)試開關(guān)可選debug env(INVISIBLE_RECAPTCHA_DEBUG, false),對(duì)應(yīng).env變量INVISIBLE_RECAPTCHA_DEBUG設(shè)為true后瀏覽器控制臺(tái)會(huì)打印_submitForm、_captchaForm、_captchaSubmit三個(gè)元素的綁定狀態(tài)見renderDebug方法用途當(dāng)點(diǎn)擊提交沒反應(yīng)時(shí)第一時(shí)間用它在控制臺(tái)定位是哪一環(huán)沒綁定成功生產(chǎn)環(huán)境請(qǐng)保持false 附贈(zèng)配置項(xiàng)timeout請(qǐng)求超時(shí)timeout env(INVISIBLE_RECAPTCHA_TIMEOUT, 5),對(duì)應(yīng).env變量INVISIBLE_RECAPTCHA_TIMEOUTGuzzle HTTP 客戶端的超時(shí)秒數(shù)默認(rèn) 5 秒弱網(wǎng)環(huán)境可適當(dāng)調(diào)大.env 配置速查表 在 Laravel 項(xiàng)目根目錄的.env文件中一次性寫全即可// 必填 INVISIBLE_RECAPTCHA_SITEKEY{你的siteKey} INVISIBLE_RECAPTCHA_SECRETKEY{你的secretKey} // 可選 INVISIBLE_RECAPTCHA_BADGEHIDEfalse INVISIBLE_RECAPTCHA_DATABADGEbottomright INVISIBLE_RECAPTCHA_TIMEOUT5 INVISIBLE_RECAPTCHA_DEBUGfalse在 Laravel 5.5 中服務(wù)提供者 src/InvisibleReCaptchaServiceProvider.php 支持包自動(dòng)發(fā)現(xiàn)無需手動(dòng)注冊(cè)它還會(huì)把配置文件發(fā)布到config/captcha.php供你直接修改。常見坑位提醒 ??密鑰類型選錯(cuò)申請(qǐng)時(shí)沒選 invisible reCAPTCHA驗(yàn)證永遠(yuǎn)失敗——去后臺(tái)重新生成一對(duì)表單里只有 1 個(gè) submit 按鈕invisible reCAPTCHA 通過攔截 submit 事件觸發(fā)驗(yàn)證按鈕的type必須是submit且表單內(nèi)只能有一個(gè)render() 必須在 form 內(nèi)調(diào)用captcha或app(captcha)-render()需要放在form標(biāo)簽內(nèi)驗(yàn)證規(guī)則要加上Laravel 校驗(yàn)規(guī)則寫入g-recaptcha-response required|captchacaptcha規(guī)則由服務(wù)提供者自動(dòng)注冊(cè)多表單場(chǎng)景master 分支不支持同一頁(yè)面多個(gè)驗(yàn)證碼多表單需求請(qǐng)使用multi-forms分支總結(jié) ?invisible-recaptcha 的 5 個(gè)關(guān)鍵配置項(xiàng)各司其職siteKey和secretKey是身份與驗(yàn)證的基石必填hideBadge控制角標(biāo)顯隱dataBadge決定角標(biāo)位置debug是排障利器。全部配置集中在src/config/captcha.php配合.env即可零代碼完成部署——讓我是人類的驗(yàn)證從此對(duì)用戶徹底隱身?！久赓M(fèi)下載鏈接】invisible-recaptchaAn invisible reCAPTCHA package for Laravel, Lumen, CI or native PHP.項(xiàng)目地址: https://gitcode.com/gh_mirrors/in/invisible-recaptcha創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考