# php


# 贡献者

隔壁老李@fastknife https://gitee.com/fastknife (opens new window)

# 介绍

这个类库使用 PHP实现了行为验证码。基于gd扩展生成滑动验证码和文字验证码。允许 phper定制验证码规则,并且不再使用 curl来请求第三方验证。

# 注意事项

  • 你需要打开 gd、 openssl扩展
  • PHP版本至少需要7.1
  • 此软件包自带缓存,如有需要请自行更换
  • anji-plus/captcha前端默认请求头是 application/json 需替换为 application/x-www-form-urlencode

# 如何使用

test 目录下示例了三种使用方式,phper可以参考使用。查看demo (opens new window)

本软件包需要配合composer一起使用

  1. 非框架使用的场景,直接使用git下载这个软件包。然后执行composer命令composer install安装本软件包依赖,接着手动引入对应的 service层文件即可(同test目录里的原生引用方式)。

  2. 基本于框架使用的场景,输入安装命令composer require fastknife/ajcaptcha(稳定版) 或者composer require fastknife/ajcaptcha dev-master(最新版) ,建议使用composer阿里源(https://mirrors.aliyun.com/composer

    • 支持各种前沿框架(ThinkPHP, YII, Laravel, Hyperf,IMI,Swoft,EasySwoole)
    • 本软件包内,未使用单例、注册树(容器)模式,不含任何全局变量,基于swoole开发的同学不用担心内存泄露。

# 项目结构

本软件包基于整洁架构理念,设计了下文的目录结构。Domain(领域层)作为内层同心圆承担所有业务逻辑功能,Service(服务层)并向最外层Controller(需自行实现)提供粗颗粒度服务。
区别于DDD(领域驱动设计),本软件包的领域层不含Entity(实体),以Logic(逻辑层)实现单元逻辑,为了方便管理作者将逻辑层的数据处理与图形处理分隔,以达到整洁效果。

AJ-Captcha for php
│
├─resources 资源
│	│
│	├─defaultImages 图片资源
│	│
│	└─fonts 字体
│
├─src 源码
│	│
│	├─Domian 领域层
│	│
│	├─Exception 异常
│	│
│	├─Service 服务层
│	│
│	└─Utils 工具类
│
├─test 测试实例
│	│
│	├─thinkphp thinkphp框架测试示例
│	│
│	├─laravel laravel框架测试示例
│	│
│	└─*.php 原生测试文件 配置文件
└─config.php 配置参考

若此软件对您有所帮助,您可以点右上角 💘Star💘支持