<div align="center">
[](https://travis-ci.org/lemonce/svg-captcha)
[](https://www.npmjs.com/package/svg-captcha)
[](https://www.npmjs.com/package/svg-captcha)
</div>
> 在node.js中生成svg格式的验证码
## Translations
[English](README.md)
## 什么情况下使用SVG验证码？
- 无法使用 google recaptcha
- 无法安装 c++ 模块
## 安装
```
npm install --save svg-captcha
```
## 使用方法
```js
var svgCaptcha = require('svg-captcha');
var c = svgCaptcha.create();
console.log(c);
// {data: '<svg.../svg>', text: 'abcd'}
```
在 express中使用
```Javascript
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](LICENSE.md)
马建仓 AI 助手
