zx/demo.md at main

7.0 KiB

Raw Permalink Blame History

范例

详情请查看test目录的PHP源码

配置说明

return [
    'font_file' => '', //自定义字体包路径， 不填使用默认值
    //文字验证码
    'click_world' => [
        'backgrounds' => [] 
    ],
    //滑动验证码
    'block_puzzle' => [
        'backgrounds' => [], //背景图片路径， 不填使用默认值
        'templates' => [], //模板图
        
        'offset' => 10, //容错偏移量

        'is_cache_pixel' => true, //是否开启缓存图片像素值，开启后能提升服务端响应性能（但要注意更换图片时，需要清除缓存）
    ],
    //水印
    'watermark' => [
        'fontsize' => 12,
        'color' => '#ffffff',
        'text' => '我的水印'
    ],
    'cache' => [
        'constructor' => \Fastknife\Utils\CacheUtils::class,//若您使用了框架，并且想使用类似于redis这样的缓存驱动，则应换成框架的中的缓存驱动
        'method' => [
            // 遵守PSR-16规范不需要设置此项（tp6, laravel,hyperf）。如tp5就不支持（tp5缓存方法是rm,所以要配置为"delete" => "rm"）,
            'get' => 'get', //获取
            'set' => 'set', //设置
            'delete' => 'delete',//删除
            'has' => 'has' //key是否存在
        ],
        'options' => [
        //如果您依然使用\Fastknife\Utils\CacheUtils做为您的缓存驱动，那么您可以自定义缓存配置。
            'expire'        => 300,//缓存有效期 （默认为0 表示永久缓存）
            'prefix'        => '', //缓存前缀
            'path'          => '', //缓存目录
            'serialize'     => [], //缓存序列化和反序列化方法
        ]       
    ]
];

缓存配置

config.cache.constructor类型为string|array|function 使用以访问回调的方式获得缓存实例;

laravel 配置：

'constructor' => [Illuminate\Support\Facades\Cache::class, 'store']

tp6(tp5.1) 配置

  'constructor' => [think\Facade\Cache::class, 'instance']

无论配置写成[think\Facade\Cache::class, 'instance'] 还是写成 [think\Facade\Cache::class, 'store'] 目的都是为了获取缓存实例，具体情况视框架而定

灵活自定义：

如果您的需要使用类似以下命令打包配置文件（ThinkPHP,Laravel 命令）
- php think optimize:config
- php artisan optimize
  则需要写成下面这样：

    $instance = \think\facade\Cache::store();//获取缓存想实例
    //省略分部代码
    'constructor' => serialize($instance);

因为在执行optimize打包命令时，会尝试将对象进行序列化。

如果您不需要使用打包压缩命令，或者使用了像hyperf这样的框架，除了上述的写法，还可以写成这样：

   'constructor' => function () {
            $container = \Hyperf\Utils\ApplicationContext::getContainer();
            //在构造函数中传入自已的配置
            return $container->get(\Psr\SimpleCache\CacheInterface::class);
    },

除此之处，您传入的缓存实例应遵守psr-16规范

背景图与滑动图

配置中的backgrounds与templates项均支持，Array, String两种格式

使用Array（索引数组）格式时，表明它每一项都是一张图片。可以是本地图片路径，也可以是网络图片路径。
示例：

    'backgrounds' => [
        '/public/images/xxx.jpg',
        'http://www.image.xx.jpg'
    ]

使用String格式时，表明它是一个图片所在位置的目录
示例：

    'backgrounds' => ROOT_PATH . '/resources/defaultImages/jigsaw/original/'

当配置中的backgrounds与templates项为空时，会将/resources/defaultImages/目录内所有图片做为默认图片。

下面是社区人员一起维护的图片库，这些图片可以与本程序无缝衔接。
https://gitee.com/anji-plus/AJ-Captcha-Images

字体配置

字体配置在水印与文字点击验证功能中使用，其配置格式化String, 指向字体库。为空时会以/resources/fonts下的字体文件为默认值。
示例：

'font_file' => ROOT_PATH . '/resources/fonts/WenQuanZhengHei.ttf'

获取滑动验证码

public function get(){
        $config = require '../src/config.php';
        $service = new BlockPuzzleCaptchaService($config);
        $data = $service->get();
        echo json_encode([
            'error' => false,
            'repCode' => '0000',
            'repData' => $data,
            'repMsg' => null,
            'success' => true,
        ]);
}

滑动验证

     public function check()
    {
        $config = require '../src/config.php';
        $service = new BlockPuzzleCaptchaService($config);
        $data = $_REQUEST;
        $msg = null;
        $error = false;
        $repCode = '0000';
        try {
            $service->check($data['token'], $data['pointJson']);
        } catch (\Exception $e) {
            $msg = $e->getMessage();
            $error = true;
            $repCode = '6111';
        }
        echo json_encode([
            'error' => $error,
            'repCode' => $repCode,
            'repData' => null,
            'repMsg' => $msg,
            'success' => ! $error,
        ]);
    }

获取文字验证码

    public function get()
    {
        $config = require '../src/config.php';
        $service = new ClickWordCaptchaService($config);
        $data = $service->get();
        echo json_encode([
            'error' => false,
            'repCode' => '0000',
            'repData' => $data,
            'repMsg' => null,
            'success' => true,
        ]);
    }

文字验证

    public function check()
    {
        $config = require '../src/config.php';
        $service = new ClickWordCaptchaService($config);
        $data = $_REQUEST;
        $msg = null;
        $error = false;
        $repCode = '0000';
        try {
            $service->check($data['token'], $data['pointJson']);
        } catch (\Exception $e) {
            $msg = $e->getMessage();
            $error = true;
            $repCode = '6111';
        }
        echo json_encode([
            'error' => $error,
            'repCode' => $repCode,
            'repData' => null,
            'repMsg' => $msg,
            'success' => ! $error,
        ]);
    }

前端请求头修改示例

import axios from 'axios';
import qs from 'qs';

axios.defaults.baseURL = 'https://captcha.anji-plus.com/captcha-api';

const service = axios.create({
    timeout: 40000,
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
    },
})
service.interceptors.request.use(
    config => {
        if (config.hasOwnProperty('data')) {
            config.data = qs.stringify(config.data)
        }
        return config
    },
    error => {
        Promise.reject(error)
    }
)

本包后续更新 ThinkPHP、Hyperf 等框架的demo，请持续关注 https://gitee.com/fastknife/aj-captcha

7.0 KiB Raw Permalink Blame History Unescape Escape

范例