验证码

Testing Is Documentation

tests/Seccode/SeccodeTest.php

QueryPHP 提供的验证组件，扩展包内定义了一些常见用法方便使用，可以满足大部分常用场景。

配置

验证码带有默认的配置参数，支持自定义配置。

Uses

<?php
use Leevel\Seccode\Seccode;

display 验证码基本使用

public function testBaseUse(): void
{
    $seccode = new Seccode([
        'font_path'       => __DIR__.'/font',
    ]);
    $file = __DIR__.'/baseuse.png';
    $seccode->display('abc', $file);
    $this->assertTrue(is_file($file));
    $info = getimagesize($file);
    $data = <<<'eot'
        {
            "0": 160,
            "1": 60,
            "2": 3,
            "3": "width=\"160\" height=\"60\"",
            "bits": 8,
            "mime": "image\/png"
        }
        eot;
    $this->assertSame(
        $data,
        $this->varJson(
            $info
        )
    );
    unlink($file);
}

验证码支持中文

public function testChinese(): void
{
    $seccode = new Seccode([
        'font_path'               => __DIR__.'/font',
        'chinese_font_path'       => __DIR__.'/chinese', // 中文字体过于庞大，本地已经测试通过，这里用的英文的假字体，会乱码
    ]);
    $file = __DIR__.'/chinese.png';
    $seccode->display('中国', $file);
    $this->assertTrue(is_file($file));
    $info = getimagesize($file);
    $data = <<<'eot'
        {
            "0": 160,
            "1": 60,
            "2": 3,
            "3": "width=\"160\" height=\"60\"",
            "bits": 8,
            "mime": "image\/png"
        }
        eot;
    $this->assertSame(
        $data,
        $this->varJson(
            $info
        )
    );
    unlink($file);
}

验证码支持随机生成

支持的类型

# Tests\Seccode\SeccodeTest::getAutoCodeData
public function getAutoCodeData(): array
{
    return [
        [Seccode::ALPHA_NUM],
        [Seccode::ALPHA_NUM_LOWERCASE],
        [Seccode::ALPHA_NUM_UPPERCASE],
        [Seccode::ALPHA],
        [Seccode::ALPHA_LOWERCASE],
        [Seccode::ALPHA_UPPERCASE],
        [Seccode::NUM],
        [Seccode::CHINESE],
    ];
}

public function testAutoCode(string $type): void
{
    $seccode = new Seccode([
        'font_path'               => __DIR__.'/font',
        'chinese_font_path'       => __DIR__.'/chinese', // 中文字体过于庞大，本地已经测试通过，这里用的英文的假字体，会乱码
    ]);
    $file = __DIR__.'/autocode.'.$type.'.png';
    $seccode->display(4, $file, true, $type);
    $this->assertTrue(is_file($file));
    $info = getimagesize($file);
    $data = <<<'eot'
        {
            "0": 160,
            "1": 60,
            "2": 3,
            "3": "width=\"160\" height=\"60\"",
            "bits": 8,
            "mime": "image\/png"
        }
        eot;
    $this->assertSame(
        $data,
        $this->varJson(
            $info
        )
    );
    unlink($file);
}

验证码支持最小尺寸设置

public function testMinWidthAndMinHeight(): void
{
    $seccode = new Seccode([
        'font_path' => __DIR__.'/font',
        'width'     => 2,
        'height'    => 2,
    ]);
    $file = __DIR__.'/minWidthAndMinHeight.png';
    $seccode->display('A', $file);
    $this->assertTrue(is_file($file));
    $info = getimagesize($file);
    $data = <<<'eot'
        {
            "0": 16,
            "1": 16,
            "2": 3,
            "3": "width=\"16\" height=\"16\"",
            "bits": 8,
            "mime": "image\/png"
        }
        eot;
    $this->assertSame(
        $data,
        $this->varJson(
            $info
        )
    );
    unlink($file);
}

验证码支持最大尺寸设置

public function testMaxWidthAndMaxHeight(): void
{
    $seccode = new Seccode([
        'font_path' => __DIR__.'/font',
        'width'     => 1200,
        'height'    => 1200,
    ]);
    $file = __DIR__.'/maxWidthAndMaxHeight.png';
    $seccode->display('IMAX', $file);
    $this->assertTrue(is_file($file));
    $info = getimagesize($file);
    $data = <<<'eot'
        {
            "0": 999,
            "1": 999,
            "2": 3,
            "3": "width=\"999\" height=\"999\"",
            "bits": 8,
            "mime": "image\/png"
        }
        eot;
    $this->assertSame(
        $data,
        $this->varJson(
            $info
        )
    );
    unlink($file);
}

验证码随机颜色

public function testWithoutRandColor(): void
{
    $seccode = new Seccode([
        'font_path'       => __DIR__.'/font',
        'color'           => false,
    ]);
    $file = __DIR__.'/withoutRandColor.png';
    $seccode->display('ABCD', $file);
    $this->assertTrue(is_file($file));
    $info = getimagesize($file);
    $data = <<<'eot'
        {
            "0": 160,
            "1": 60,
            "2": 3,
            "3": "width=\"160\" height=\"60\"",
            "bits": 8,
            "mime": "image\/png"
        }
        eot;
    $this->assertSame(
        $data,
        $this->varJson(
            $info
        )
    );
    unlink($file);
}