README

program-captcha 是 superpms 的图片验证码包，提供 helper、pms\facade\Captcha facade、验证码配置对象和 GD 图片生成 driver。

当前实现是“图片 Data URL + AES 票据 + 本地校验”的轻状态验证码：明文答案不写入 session，校验信息被加密打包到 aes 载荷里。

要求

composer require superpms/program-captcha

包的 composer.json 会：

bin/autoload.php 会先加载 bin/helper.php，再加载 bin/autorun.php。当框架存在 pms\hook\LifecycleHook 时，包会在 LIFECYCLE_BOOT 阶段执行：

$config = config('captcha', []);
\pms\facade\Captcha::setConfig($config);

生成验证码：

$payload = captcha();

// $payload['image'] 是 data:image/png;base64,... 字符串
// $payload['aes'] 需要随用户输入一起提交回来

带 scope 生成和校验：

$payload = captcha_scope('login');

$ok = captcha_check($payload['aes'], $userInput, 'login');

临时覆盖配置：

$payload = captcha([
    'length' => 4,
    'expire' => 300,
    'useNoise' => false,
]);

create() 和 helper 返回数组：

[
    'code' => 'abcde',
    'aes' => '...',
    'image' => 'data:image/png;base64,...',
]

code 是当前源码仍然返回的明文验证码字段。对外接口是否透传该字段，应由接口层按安全要求决定。