poster

介绍

基于gd、imagick、phpqrcode

PHP海报生成插件，极速生成方便快捷。

快速生成海报、生成签到日、生成二维码、合成二维码、图片添加水印

滑块验证图片生成、旋转验证图片生成、点击验证图片生成、输入验证图片生成

小提示：

如果无法更新版本，composer 切换回原镜像

全局设置

composer config -g repo.packagist composer https://repo.packagist.org

authors

lang 732853989@qq.com

群号 590660254 点击链接加入群聊【海报图片验证交流群】

安装或更新教程

1. composer require kkokk/poster
2. composer update kkokk/poster

演示效果

输入验证码验证

数字、算术、中文、字母加数字

点击图片验证

旋转图片验证

滑块验证图片

海报生成图片示例

演示地址：暂无

生成签到日历海报、邀请海报

引用海报类

注意：没有特别说明，统一都是px。

文档地址：http://www.520yummy.com/composer/poster/doc.html

通过 PosterManager 调用

xxxxxxxxxx
use Kkokk\Poster\PosterManager; // 使用 PosterManager 调用
$poster = PosterManager::Poster();

通过 Facades 调用

xxxxxxxxxx
use Kkokk\Poster\Facades\Poster; // 使用 Facades\Poster 调用

$result = Poster::config($params)
    ->buildIm($w,$h,$rgba,$alpha) # 创建画布
    ->buildImage($src,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$alpha,$type) # 合成图片
    ->getPoster(); # 获取合成后图片文件地址

技巧：也可以分开使用

xxxxxxxxxx
$Poster = Poster::config($params);
$Poster->buildIm($w,$h,$rgba,$alpha); # 创建画布
$Poster->buildImage($src,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$alpha,$type); # 合成图片
$result = $Poster->getPoster(); # 获取合成后图片文件地址

使用 Gd 拓展

xxxxxxxxxx
$poster = PosterManager::Poster(); // 使用 PosterManager 调用
$Poster = Poster::config($params); // 使用 Facades\Poster 调用

使用 Imagick 拓展

xxxxxxxxxx
$poster = PosterManager::Poster()->extension('imagick'); // 使用 PosterManager 调用
$Poster = Poster::extension('imagick')->config($params); // 使用 Facades\Poster 调用

基础配置

xxxxxxxxxx
$params = [
    'path'        => $path,        // 设置路径
    'font_size'   => $fontSize,    // 统一设置文字大小
    'font_rgba'   => $rgba,        // 统一设置文字颜色
    'font_space'  => $angle,       // 统一设置文字间距
    'font_weight' => $angle,       // 统一设置文字粗细
    'font_family' => $fontFamily,  // 统一设置文字字体，字体绝对路径
    'font_angle'  => $angle,       // 统一设置文字旋转角度
    'font_max_w'  => $maxW,        // 统一设置文字最大换行宽度
];
$poster->config($params);

设置路径

xxxxxxxxxx
$poster->path($path); # 设置路径

参数说明

创建画布

xxxxxxxxxx
$poster->buildIm($w,$h,$rgba,$alpha); # 创建画布

参数说明

创建指定图片为画布

xxxxxxxxxx
$poster->buildImDst($src,$w,$h,$rgba,$alpha); # 创建指定图片为画布

参数说明

创建背景、遮罩

注意：Imagick 方式，背景暂时不能做圆角，渐变色只支持两种

xxxxxxxxxx
// 背景 rgba 参数解释
// color 颜色数组取值范围 0-255
// alpha 透明度范围 1-127
// to 颜色渐变方向取值范围 bottom、 top、 left、 right、 left top、 right top、 left bottom、 right bottom 默认 bottom
// 单色：['color'=>[[0-255,0-255,0-255]],'alpha'=>1-127]
// 多色渐变：['color'=>[[0-255,0-255,0-255], [0-255,0-255,0-255]],'alpha'=>1-127, 'to'=>'left']
// radius string|array|integer 圆角 默认0 ( '10 20', [10, 20, 30], 10)
// [20] 四个角
// [20,30] 第一个值 左上 右下 第二个值 右上 左下
// [20,30,20] 第一个值 左上 第二个值 右上 左下 第三个值 右下
// [20,30,20,10]  左上 右上 右下  左下
$poster->buildBg(400,526,[
    'color'=>[
        [0,0,162], 
        [0,255,162], 
        [255,255,162], 
        [255, 0, 0], 
        [0, 255, 0]
    ], 
    'alpha'=>50, 
    'to'=>'bottom', 
    'radius'=>'10'
], true, ['center', -10], ['center', 10], 0, 0 , function($im){         
    $im->buildText('明月几时有，把酒问青天。不知天上宫阙，今夕是何年。','center',100,20,[255, 255, 255, 50]);     
}); # 创建画布

参数说明

合成图片

xxxxxxxxxx
$poster->buildImage($src,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$alpha,$type); # 合成图片

参数说明

批量合成图片

xxxxxxxxxx
$images = [
    [
        'src'   => $src,
        'dst_x' => $dst_x,
        'dst_y' => $dst_y,
        'src_x' => $src_x,
        'src_y' => $src_y,
        'src_w' => $src_w,
        'src_h' => $src_h,
        'alpha' => $alpha,
        'type'  => $type
    ]
];
$poster->buildImageMany($images); # 批量合成图片

参数说明：与合成图片参数一致。

合成二维码

xxxxxxxxxx
$poster->buildQr($text,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$size,$margin); # 合成二维码

参数说明

批量合成二维码

xxxxxxxxxx
$qrs = [
    [
        'text'   => $text,
        'dst_x'  => $dst_x,
        'dst_y'  => $dst_y,
        'src_x'  => $src_x,
        'src_y'  => $src_y,
        'src_w'  => $src_w,
        'src_h'  => $src_h,
        'size'   => $size,
        'margin' => $margin
    ]
];
$poster->buildQrMany($qrs); # 批量合成二维码

参数说明：与合成二维码参数一致。

合成线段

xxxxxxxxxx
$poster->buildLine($x1, $y1, $x2, $y2, $rgba, $type, $weight);

合成圆弧

xxxxxxxxxx
$poster->buildArc($cx, $cy, $w, $h, $s, $e, $rgba, $type, $style, $weight);

合成文字

xxxxxxxxxx
$poster->buildText($content,$dst_x,$dst_y,$font,$rgba,$max_w,$font_family,$weight,$space); # 合成文字

// 新增文字宽度定位
$dst_x = "center | left | right"; // 特殊值：center 居中 left 靠左 right 靠右
$dst_x = ['center', 10]; // 居中且向右偏移10 负数向左偏移
$dst_x = ['left', 10]; // 靠左且向右偏移10 负数向左偏移
$dst_x = ['right', 10]; // 靠左且向右偏移10 负数向左偏移
// 自定义宽度定位， center left right 
$dst_x = ['custom', 'center', 100, 200, 0]; // 在图像对象的x坐标100到200之间居中, 偏移0

// 新增文字高度定位
$dst_y = "center | top | bottom"; // 特殊值：center 居中 top 靠顶 bottom 靠底
$dst_y = ['center', 10]; // 居中且向下偏移10 负数向上偏移
$dst_y = ['top', 10]; // 靠顶且向下偏移10 负数向上偏移
$dst_y = ['bottom', 10]; // 靠底且向下偏移10 负数向上偏移
// 自定义高度定位， center top bottom 
$dst_y = ['custom', 'center', 100, 200, 0]; // 在图像对象的y坐标100到200之间居中, 偏移0

参数说明

批量合成文字

xxxxxxxxxx
$texts = [
    [
        'content'     => $content,
        'dst_x'       => $dst_x,
        'dst_y'       => $dst_y,
        'font'        => $font,
        'rgba'        => $rgba,
        'max_w'       => $max_w,
        'font_family' => $font_family,
        'weight'      => $weight,
        'space'       => $space,
        'angle'       => $angle,
    ]
];
$poster->buildTextMany($texts); # 批量合成文字

参数说明：与合成文字参数一致。

获取海报

xxxxxxxxxx
$poster->getPoster($path = ''); # 获取合成后图片文件地址

参数说明：无。

返回说明：返回数组，返回文件地址。

处理海报、图片

xxxxxxxxxx
$poster->setPoster(); # 处理图片，需要传原图片

参数说明：无。

返回说明：处理原图片资源，无返回。

输出图片流

xxxxxxxxxx
$poster->stream(); # 输出图片流

参数说明：无。

返回说明：返回文件流，可输出到浏览器或img标签。

输出base64

xxxxxxxxxx
$poster->baseData(); # 返回base64

参数说明：无。

返回说明：返回回base64，不保留在服务器直接使用。

生成二维码

xxxxxxxxxx
$qr = PosterManager::Poster()->Qr('http://www.520yummy.com','poster/1.png'); # 生成二维码

参数说明

返回说明：outfile 为空，输出二维码图片，不生成文件；否则返回图片路径。

验证码使用说明

滑块图片验证

xxxxxxxxxx
# 自定义参数
$params = [
    'src'           => '',  // 背景图片，尺寸 340 * 191
    'im_width'      => 340, // 画布宽度
    'im_height'     => 251, // 画布高度
    'im_type'       => 'png', // png 默认 jpg quality 质量
    'quality'       => 80,    // jpg quality 质量
    'bg_width'      => 340, // 背景宽度
    'bg_height'     => 191, // 背景高度
    'slider_width'  => 50,  // 滑块宽度
    'slider_height' => 50,  // 滑块高度
    'slider_border' => 2,   // 滑块边框
    'slider_bg'     => 1,   // 滑块背景数量
];

$type = 'slider';

/**
  * 获取验证参数
  * 内部使用了 laravel 的 cache 缓存，返回的是图片的 base64 、 缓存key 、滑块高度
  * @param string $type   验证码类型
  * @param array  $params 验证码自定义参数
  * @return arary
  */
$data = PosterManager::Captcha()->type($type)->config($params)->get();

/** 
  * 验证
  * 前端根据相关滑块操作进行处理, 返回x坐标，返回 true 则验证成功
  * @param string     $key     缓存key
  * @param string|int $value   前端传回来的x坐标
  * @param int        $leeway  误差值
  * @return boolean
  */
$res = PosterManager::Captcha()->type($type)->check($key, $value, $leeway);

旋转图片验证

xxxxxxxxxx
# 自定义参数
$params = [
        'src'           => '',  // 背景图片，尺寸 350 * 350 正方形都可 
        'im_width'      => 350, // 画布宽度
        'im_height'     => 350, // 画布高度
        'im_type'       => 'png', // png 默认 jpg quality 质量
        'quality'       => 80,    // jpg quality 质量
    ];

$type = 'rotate';

/**
  * 获取验证参数
  * 内部使用了 laravel 的 cache 缓存，返回的是图片的 base64 、 缓存key
  * @param string $type   验证码类型
  * @param array  $params 验证码自定义参数
  * @return arary
  */
$data = PosterManager::Captcha()->type($type)->config($params)->get();

/** 
  * 验证
  * 前端根据相关滑块操作进行处理, 返回x坐标，返回 true 则验证成功
  * @param string     $key     缓存key
  * @param string|int $value   前端传回来的旋转角度
  * @param int        $leeway  误差值
  * @return boolean
  */
$res = PosterManager::Captcha()->type($type)->check($key, $value, $leeway);

点击图片验证

xxxxxxxxxx
# 自定义参数
$params = [
        'src'         => '',
        'im_type'     => 'png', // png 默认 jpg quality 质量
        'quality'     => 80,    // jpg quality 质量
        'font_family' => '', // 感谢站酷提供免费商用站酷库黑体、可自定义炫酷字体文件（绝对路径）
        'contents'    => '', // 自定义文字
        'font_count'  => 0,  // 文字长度
        'font_size'   => 42, // 字体大小
        'line_count'  => 0,  // 干扰线数量
        'char_count'  => 0,  // 干扰字符数量
    ];

$type = 'click';

/**
  * 获取验证参数
  * 内部使用了 laravel 的 cache 缓存，返回的是图片的 base64 、 缓存key
  * @param string $type   验证码类型
  * @param array  $params 验证码自定义参数
  * @return arary
  */
$data = PosterManager::Captcha()->type($type)->config($params)->get();

/** 
  * 验证
  * 前端根据相关点击操作进行处理, 返回点击坐标数组，返回 true 则验证成功
  * @param string            $key     缓存key
  * @param string|int|array  $value   前端传回来的坐标数组
  * @return boolean
  */
$res = PosterManager::Captcha()->type($type)->check($key, $value);

手动输入验证

xxxxxxxxxx
# 自定义参数
$params = [
        'src'         => '',
        'im_width'    => 256,
        'im_height'   => 64,
        'im_type'     => 'png', // png 默认 jpg quality 质量
        'quality'     => 80,    // jpg quality 质量
        'type'        => 'number', // type = number 数字 alpha_num 字母和数字 math 计算 text 文字
        'font_family' => '', // 可自定义炫酷字体文件
        'font_size'   => 32, // 字体大小
        'font_count'  => 4,  // 字体长度
        'line_count'  => 5,  // 干扰线数量
        'char_count'  => 10,  // 干扰字符数量
    ];

$type = 'click';

/**
  * 获取验证参数
  * 内部使用了 laravel 的 cache 缓存，返回的是图片的 base64 、 缓存key
  * @param string $type   验证码类型
  * @param array  $params 验证码自定义参数
  * @return arary
  */
$data = PosterManager::Captcha()->type($type)->config($params)->get();

/** 
  * 验证
  * 前端根据相关输入, 返回输入结果，返回 true 则验证成功
  * @param string            $key     缓存key
  * @param string|int|array  $value   输入结果
  * @return boolean
  */
$res = PosterManager::Captcha()->type($type)->check($key, $value);

示例

图片验证

xxxxxxxxxx
    use Kkokk\Poster\PosterManager;
    use Kkokk\Poster\Exception\PosterException;
    
    try {
        # 滑块验证
        $type = 'slider';
        $data = PosterManager::Captcha()->type($type)->get();
        $res = PosterManager::Captcha()->type($type)->check($key, $value);
        
        # 旋转图片验证
        $type = 'rotate';
        $data = PosterManager::Captcha()->type($type)->get();
        $res = PosterManager::Captcha()->type($type)->check($key, $value);
        
        # 点击验证
        $type = 'click';
        $data = PosterManager::Captcha()->type($type)->get();
        $res = PosterManager::Captcha()->type($type)->check($key, $value);
        
        # 输入验证
        $type = 'input';
        $data = PosterManager::Captcha()->type($type)->get();
        $res = PosterManager::Captcha()->type($type)->check($key, $value);
        
    } catch (PosterException $e) {
        print_r($e->getMessage())
    }

海报类静态调用

xxxxxxxxxx
use Kkokk\Poster\PosterManager;
use Kkokk\Poster\Exception\Exception;
# 合成图片
try {
    $addImage = "https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=2854425629,4097927492&fm=26&gp=0.jpg";
    $result = PosterManager::Poster('poster/poster_user') //生成海报，这里写保存路径和文件名，可以指定图片后缀。默认png
        ->buildIm(638,826,[255,255,255,127],false)
        ->buildImage('https://test.acyapi.51acy.com/wechat/poster/top_bg.png')
        ->buildImage('https://test.acyapi.51acy.com/wechat/poster/half_circle.png',254,321)
        ->buildImage($addImage,253,326,0,0,131,131,false,'circle')
        ->buildImage('https://test.acyapi.51acy.com/wechat/poster/fengexian.png',0,655)
        ->buildText('苏 轼','center',477,16,[51, 51, 51,1])
        ->buildText('明月几时有，把酒问青天。不知天上宫阙，今夕是何年。','center',515,14,[53, 53, 53, 1])
        ->buildText('我欲乘风归去，又恐琼楼玉宇，高处不胜寒。','center',535,14,[53, 153, 153, 1])
        ->buildText('起舞弄清影，何似在人间。转朱阁，低绮户，照无眠。','center',555,14,[53, 153, 153, 1])
        ->buildText('不应有恨，何事长向别时圆？','center',575,14,[53, 153, 153, 1])
        ->buildText('人有悲欢离合，月有阴晴圆缺，此事古难全。','center',595,14,[53, 153, 153, 1])
        ->buildText('但愿人长久，千里共婵娟。','center',615,14,[53, 153, 153, 1])
        ->buildText('长按识别',497,720,15,[53, 153, 153, 1])
        ->buildText('查看TA的更多作品',413,757,15,[53, 153, 153, 1])
        ->buildQr('http://www.520yummy.com',37,692,0,0,0,0,4,1)
        ->getPoster();

    # 批量合成
    $buildImageManyArr = [
        [
            'src' => 'https://test.acyapi.51acy.com/wechat/poster/top_bg.png'
        ],
    ];
    $buildTextManyArr  = [
        [
            'content'=> '明月几时有，把酒问青天。不知天上宫阙，今夕是何年。',
            'dst_x' => 'center',
            'dst_y' => 515,
            'font' => 16,
            'rgba' => [51, 51, 51, 1],
            'max_w'=> 0,
            'font_family' => '',
            'weight' => 1,
            'space'=>20
        ],
    ];
    $buildQrManyArr    = [
        [
            'text'=>'http://www.520yummy.com',
            'dst_x'=>37,
            'dst_y'=>692,
            'src_x'=>0,
            'src_y'=>0,
            'src_w'=>0,
            'src_h'=>0,
            'size'=>4,
            'margin'=>1
        ],
    ];

    $result = PosterManager::Poster('poster/poster_user')
        ->buildIm(638,826,[255,255,255,127],false)
        ->buildImageMany($buildImageManyArr)
        ->buildTextMany($buildImageManyArr)
        ->buildQrMany($buildQrManyArr)
        ->buildBg(400,526,
            ['color'=>[[0,0,162], [0,255,162], [255,255,162], [255, 0, 0], [0, 255, 0]], 
             'alpha'=>50, 
             'to'=>'bottom'
            ],
            true, 
            ['center', -10], 
            ['center', 10], 
            0, 
            0 ,
            function($im){
              $im->buildText('明月几时有，把酒问青天。不知天上宫阙，今夕是何年。','center',100,20,[255, 255, 255, 50]);
            }
        )->getPoster();
    
    # 给图片添加水印
    $setImage = "https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=2854425629,4097927492&fm=26&gp=0.jpg";
    $result = PosterManager::Poster() //给指定图片添加水印，这里为空就好
        ->buildImDst(__DIR__.'/test.jpeg')
        ->buildImage($setImage,'-20%','-20%',0,0,0,0,false)
        ->setPoster();

    # 生成二维码
    $result = PosterManager::Poster()->Qr('http://www.baidu.com','poster/1.png');
} catch (Exception $e){
    echo $e->getMessage();
}

海报类实例化调用

use Kkokk\Poster\PosterManager;
use Kkokk\Poster\Exception\Exception;
# 合成图片
try {
    $addImage = "https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=2854425629,4097927492&fm=26&gp=0.jpg";
    $PosterManager = new PosterManager('poster/poster_user'); //生成海报，这里写保存路径和文件名，可以指定图片后缀。默认png
    $result = $PosterManager->buildIm(638,826,255,255,255,1]27,false)
    ->buildIm(638,826,[255,255,255,127],false)
    ->buildImage('https://test.acyapi.51acy.com/wechat/poster/top_bg.png')
    ->buildImage('https://test.acyapi.51acy.com/wechat/poster/half_circle.png',254,321)
    ->buildImage($addImage,253,326,0,0,131,131,false,'circle')
    ->buildImage('https://test.acyapi.51acy.com/wechat/poster/fengexian.png',0,655)
    ->buildText('苏 轼','center',477,16,[51, 51, 51,1])
    ->buildText('明月几时有，把酒问青天。不知天上宫阙，今夕是何年。','center',515,14,[53, 53, 53, 1])
    ->buildText('我欲乘风归去，又恐琼楼玉宇，高处不胜寒。','center',535,14,[53, 153, 153, 1])
    ->buildText('起舞弄清影，何似在人间。转朱阁，低绮户，照无眠。','center',555,14,[53, 153, 153, 1])
    ->buildText('不应有恨，何事长向别时圆？','center',575,14,[53, 153, 153, 1])
    ->buildText('人有悲欢离合，月有阴晴圆缺，此事古难全。','center',595,14,[53, 153, 153, 1])
    ->buildText('但愿人长久，千里共婵娟。','center',615,14,[53, 153, 153, 1])
    ->buildText('长按识别',497,720,15,[53, 153, 153, 1])
    ->buildText('查看TA的更多作品',413,757,15,[53, 153, 153, 1])
    ->buildQr('http://www.520yummy.com',37,692,0,0,0,0,4,1)
    ->getPoster();

    # 给图片添加水印
    $setImage = 'https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/u=2854425629,4097927492&fm=26&gp=0.jpg';
    $PosterManager = new PosterManager(); //给指定图片添加水印，这里为空就好
    $result = $PosterManager->buildImDst(__DIR__.'/test.jpeg')
    ->buildImage($setImage,'center','-20%',0,0,0,0,true)
    ->setPoster();

    # 生成二维码
    $result = $PosterManager->Qr('http://www.baidu.com','poster/1.png');

} catch (Exception $e){
    echo $e->getMessage();
}