237899745
4350113979
- 在editStorageForm中初始化oss_storage_quota_value和oss_quota_unit - 删除重复的旧配额说明块，保留新的当前配额设置显示 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
109 lines
3.5 KiB
Markdown
109 lines
3.5 KiB
Markdown
|
||
|
||
<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) |