README_CN.md

在node.js中生成svg格式的验证码

Translations

English

什么情况下使用SVG验证码？

• 无法使用 google recaptcha
• 无法安装 c++ 模块

安装

npm install --save svg-captcha

使用方法

var svgCaptcha = require('svg-captcha');

var c = svgCaptcha.create();
console.log(c);
// {data: '<svg.../svg>', text: 'abcd'}

在 express中使用

var svgCaptcha = require('svg-captcha');

app.get('/captcha', function (req, res) {
	var captcha = svgCaptcha.create();
	req.session.captcha = captcha.text;
	
	res.type('svg');
	res.status(200).send(captcha.data);
});

API

svgCaptcha.create(options)

如果没有任何参数，则生成的 svg 图片有4个字符。

• size: 4 // 验证码长度
• ignoreChars: '0o1i' // 验证码字符中排除 0o1i
• noise: 1 // 干扰线条的数量
• color: true // 验证码的字符是否有颜色，默认没有，如果设定了背景，则默认有
• background: '#cc9966' // 验证码图片背景颜色

该函数返回的对象拥有以下属性

• data: string // svg 路径
• text: string // 验证码文字

svgCaptcha.createMathExpr(options)

和前面的 api 的参数和返回值都一样。不同的是这个 api 生成的 svg 是一个算数式，而 text 属性上是算数式的结果。不过用法和之前是完全一样的。

svgCaptcha.loadFont(url)

加载字体，覆盖内置的字体。

• url: string // 字体文件存放路径 该接口会调用opentype.js同名的接口。 你可能需要更改一些配置才能让你得字体好看。
  详见下面的这个接口：

svgCaptcha.options

这是全局配置对象。 create和createMathExpr接口的默认配置就是使用的这个对象。

除了 size, noise, color, 和 background 之外，你还可以修改以下属性：

• width: number // width of captcha
• height: number // height of captcha
• fontSize: number // captcha text size
• charPreset: string // random character preset

svgCaptcha.randomText([size|options])

返回随机字符串

svgCaptcha(text, options)

返回基于text参数生成得svg路径
在 1.1.0 版本之前你需要调用上面的两个接口，但是现在只需要调用 create()
一个接口就行，可以少打几个字了 (^_^)/

图片示例

默认生成图片：

生成数学公式并且有颜色的验证码：

为什么使用 svg 格式?

不需要引用 c++ 模块。
如果你认为可以用正则匹配text标签，那就大错特错了。 这个项目使用了opentype.js，把文字转化为了路径。
换句话说，你得到的是 '<path fill="#444" d="M104.83 19.74L107.85 19.74L112 33.56L116.13 19.74L119.15 19.74L113.48 36.85...' 这样的路径，没有text标签。所以SVG验证码可能比的图片普通验证码要更难识别，因为你必须先做SVG到其它格式的转化。

License

MIT