菜缤的世界 CairBin's Blog - cloudflare
type: channel
link: https://blog.cairbin.top/index.php/tag/cloudflare/
items: XCaptcha-for-Typecho 新一代的Typecho验证插件

XCaptcha-for-Typecho 新一代的Typecho验证插件
type: item
date: 2024-11-15T19:15:00+00:00
description: XCaptcha-for-Typecho 新一代的Typecho验证插件更新日志[1.3.1] - 2025-11-23Fixed修复Altcha PHP72的兼容性问题，PHP72没有JSON_THROW_ON_ERROR(PHP73引入)，会导致./lib/class.altcha.php报错修复登陆界面验证码占位符不消失以及按钮无法启用的bug(issue #8)修复评论区验证码占位符不消失的bug优化Altcha样式[1.3.0] - 2025-10-10Fixed修复了Altcha未正确返回值导致评论异常问题修复了PHP8.2不支持动态创建属性而报错(./lib/class.geetestlib.php文件)，前端请求Action接口获取到的是报错信息而非JSON文本，最终导致JSON解析出错Geetest验证码渲染失败的问题。[v1.3.0 pre-release]Added添加了渲染组件以及校验成功的回调函数，用于禁用/启用按钮和提示验证码组件正在加载[v1.2.1]Fixed移除./includes/XCaptcha_Config.php的personalConfig方法修复Typecho控制台 -> 个人配置 显示XCaptcha配置找不到的bug(issue #1 )[v1.2.0]Added添加了altcha，纯本地的工程量计算的验证码方案[v1.1.1]Deprecated极验证加载不再依赖JQuery，启用JQuery与JQuery CDN URL项已被移除Changed对代码进行重构，做了结构性优化Added添加管理员评论无需验证功能，此项为可选项兼容Typecho 1.1旧版本[v1.0.2]Changed修改部分可能引发歧义的字段名称Added支持修改验证接口地址添加"极验证展现方式"设置项验证码尺寸样式选项支持极验证[v1.0.1]Fixed修复了极验证jQuery CDN失效的Bug原默认使用字节跳动的CDN加载jQuery，部分地区可能加载失效，现在默认采用jsDelivrAdded支持在配置页面启用或禁用插件自带的jQuery，对于部分自带jQuery的主题（如Handsome）无需启用该项为了避免资源失效，支持在配置页修改jQuery CDN地址，此项仅在勾选启用插件自带的jQuery选项后生效Others本插件的jQuery仅用于极验证，对其它验证码的使用无影响。起因之前由于博客垃圾评论过多，因此想要找一个验证码插件来给评论提交添加验证。一开始我用的是本地的数字图片验证码，后来在别人项目的基础上改进了CairBin/typecho-plugin-geetest。但是这个仅支持极验证，如果需要用Google reCaptcha等还需要重新上传，于是便打算自己写一个支持多种验证码的插件。Github项目地址 CairBin/XCaptcha支持验证码类型目前支持的验证码如下：hCaptchaCloudflare TurnstileGoogle reCaptcha v2极验证Geetest v3altcha-org考虑接下来支持：Google reCaptcha v3极验证Geetest v4使用方式下载本项目可以通过Git获取本项目：git clone https://github.com/CairBin/XCaptcha.git或者下载本项目的压缩包wget https://github.com/CairBin/XCaptcha/archive/refs/heads/main.zip以上两种方式通常包含插件最近提交的代码，包括正在开发的功能和补丁，但也有可能不稳定，建议去Release页面下载Release版本。解压后需要将插件文件夹的名称改为XCaptcha。配置插件将XCaptcha文件夹上传到你的Typecho博客的usr/plugins/目录下，在Typecho后台的插件面板里激活即可。从上述所支持验证码的官网注册账户，然后获取你站点的Captcha ID和Secret Key，有的也叫Site Key和Secret Key，本质上都一样，对应公钥和私钥。前者用于前端标识可以公开，后者用于服务端向验证码服务器校验需要保密。修改主题模板的comments.php文件，主题目录是usr/themes/your_theme/，在评论提交按钮之前或者表单最后添加一行代码，然后回到博客后台配置插件，将获取到的ID/Key填写进去，以及配置其他参数即可。<?php if (array_key_exists('XCaptcha', Typecho_Plugin::export()['activated'])) : XCaptcha_Plugin::showCaptcha(); endif; …