# poster **Repository Path**: 623466433/poster ## Basic Information - **Project Name**: poster - **Description**: PHP海报生成、图片验证，极速生成方便快捷。 快速生成海报、生成签到日历、生成二维码、合成二维码、图片添加水印、图片水印、水印 滑块验证、旋转图片验证等 - **Primary Language**: PHP - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 89 - **Created**: 2023-01-23 - **Last Updated**: 2024-09-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ### **poster** #### 介绍 **基于gd库、phpqrcode** PHP海报生成插件，极速生成方便快捷。 快速生成海报、生成签到日、生成二维码、合成二维码、图片添加水印 增加滑块验证图片生成、旋转验证图片生成、点击验证图片生成、输入验证图片生成 **小提示：** **如果无法更新版本，composer 切换回原镜像** 全局设置 composer config -g repo.packagist composer https://repo.packagist.org #### authors lang 732853989@qq.com #### 安装或更新教程 1. composer require kkokk/poster 2. composer update kkokk/poster #### 演示效果 2022-12 ##### **增加了输入验证码验证** 数字、算术、中文、字母加数字 ##### **点击图片验证** 输入图片说明 ##### 旋转图片验证 输入图片说明 ##### 生成滑块验证图片 输入图片说明 ##### 海报生成图片示例 输入图片说明 输入图片说明 ![输入图片说明](https://cdn.learnku.com/uploads/images/202210/19/54036/JoJhekR1um.png!large "在这里输入图片标题") 演示地址：暂无 ​ 生成签到日历海报、邀请海报 #### **引用海报类** 注意：没有特别说明，统一都是px。 文档地址：http://www.520yummy.com/composer/poster/doc.html ```php use Kkokk\Poster\PosterManager; use Kkokk\Poster\Exception\Exception; ``` #### 海报使用说明 ```php $poster = PosterManager::Poster(); ``` ##### 设置路径 ```php $poster->path($path); # 设置路径 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ---- | ------------- | ---- | ------------------------------ | | path | string\|array | 是 | 地址，例如：poster/poster_user | ##### **创建画布** ```php $poster->buildIm($w,$h,$rgba,$alpha); # 创建画布 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ----- | ------- | ---- | ------------------------ | | w | number | 是 | 画布宽 | | h | number | 是 | 画布高 | | rgba | array | 否 | 颜色rbga,[255,255,255,1] | | alpha | boolean | 否 | 是否透明，是：true | ##### **创建指定图片为画布** ```php $poster->buildImDst($src,$w,$h,$rgba,$alpha); # 创建指定图片为画布 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ----- | ------- | ---- | ------------------------- | | src | source | 是 | 图像资源 | | w | number | 否 | 画布宽，默认原图宽 | | h | number | 否 | 画布高，默认原图高 | | rgba | array | 否 | 颜色rbga，[255,255,255,1] | | alpha | boolean | 否 | 是否透明，默认false | ##### **创建背景、遮罩** ```php // 背景 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]); }); # 创建画布 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ----- | ------- | ---- | ------------------------ | | w | number | 是 | 画布宽 | | h | number | 是 | 画布高 | | rgba | array | 否 | 详见上方注释 | | alpha | boolean | 否 | 是否透明，是：true | | dst_x | number\|string\|array | 否 | 画布位置x 特殊值 center 居中，居中并向左偏移 ['center',-5]， 居中并向右偏移 ['center',5]； 支持百分比20% 支持自定义 支持正负 | | dst_y | number\|string\|array | 否 | 画布位置y 特殊值 center 居中，居中并向上偏移 ['center',-5]， 居中并向下偏移 ['center',5]； 支持百分比20% 支持自定义 支持正负 | | src_x | number | 否 | 图片x轴，默认0 | | src_y | number | 否 | 图片y轴，默认0 | | func | closure | 否 | 匿名函数（闭包），可以已当前背景为基础合成相应的内容 | ##### **合成图片** ```php $poster->buildImage($src,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$alpha,$type); # 合成图片 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ----- | -------------- | ---- | ------------------------------------------------------------ | | src | string | 是 | 路径，支持网络图片（带http或https） | | dst_x | number\|string | 否 | 画布位置x 特殊值 center 居中，居中并向左偏移 ['center',-5]， 居中并向右偏移 ['center',5]； 支持百分比20% 支持自定义 支持正负 | | dst_y | number\|string | 否 | 画布位置y 特殊值 center 居中，居中并向上偏移 ['center',-5]， 居中并向下偏移 ['center',5]； 支持百分比20% 支持自定义 支持正负 | | src_x | number | 否 | 图片x轴，默认0 | | src_y | number | 否 | 图片y轴，默认0 | | src_w | number | 否 | 图片自定义宽，默认原宽 | | src_h | number | 否 | 图片自定义高，默认原高 | | alpha | boolean | 否 | 是否透明，true：是 | | type | string | 否 | 图片变形类型，正常形状：'normal'，圆形：'circle' ，默认normal | ##### **批量合成图片** ```php $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); # 批量合成图片 ``` 参数说明：与**合成图片**参数一致。 ##### **合成二维码** ```php $poster->buildQr($text,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$size,$margin); # 合成二维码 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ------ | -------------- | ---- | ------------------------------------------------------------ | | text | string | 是 | 内容，例如：http://www.520yummy.com | | dst_x | number\|string | 否 | 画布位置x 特殊值 center 居中，居中并向左偏移 ['center',-5]， 居中并向右偏移 ['center',5]； 支持百分比20% 支持自定义 支持正负 | | dst_y | number\|string | 否 | 画布位置y 特殊值 center 居中，居中并向上偏移 ['center',-5]， 居中并向下偏移 ['center',5]； 支持百分比20% 支持自定义 支持正负 | | src_x | number | 否 | 图片x轴，默认0 | | src_y | number | 否 | 图片y轴，默认0 | | src_w | number | 否 | 图片自定义宽，默认原宽 | | src_h | number | 否 | 图片自定义高，默认原高 | | alpha | integer | 否 | 大小，默认4 | | margin | integer | 否 | 白边大小，默认1 | ##### **批量合成二维码** ```php $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); # 批量合成二维码 ``` 参数说明：与**合成二维码**参数一致。 ##### 合成文字 ```php $poster->buildText($content,$dst_x,$dst_y,$font,$rgba,$max_w,$font_family,$weight,$space); # 合成文字 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ----------- | --------------------- | ---- | ------------------------------------------------------------ | | content | string | 是 | 内容，例如：http://www.520yummy.com | | dst_x | number\|string\|array | 否 | 画布位置x ；特殊值 center 居中；居中并向左偏移 ['center',-5]， 居中并向右偏移 ['center',5] | | dst_y | number | 否 | 画布位置y，默认0 | | font | number | 否 | 字体大小，默认16 | | rgba | array | 否 | 颜色rbga，[255,255,255,1] | | max_w | number | 否 | 最大换行宽度，默认0不换行。达到换行宽度自动换行 | | font_family | string | 否 | 字体，可不填，有默认 (相对路径为项目根目录) | | weight | integer | 否 | 字体粗细 默认字体大小 | | space | integer | 否 | 字体间距 默认无 | ##### 批量合成文字 ```php $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 ] ]; $poster->buildQrMany($texts); # 批量合成文字 ``` 参数说明：与**合成文字**参数一致。 ##### 获取海报 ```php $poster->getPoster(); # 获取合成后图片文件地址 ``` 参数说明：无。 返回说明：返回数组，返回文件地址。 ##### 处理海报、图片 ```php $poster->setPoster(); # 处理图片，需要传原图片 ``` 参数说明：无。 返回说明：处理原图片资源，无返回。 ##### 输出图片流 ```php $poster->stream(); # 输出图片流 ``` 参数说明：无。 返回说明：返回文件流，可输出到浏览器或img标签。 ##### **输出base64** ```php $poster->baseData(); # 返回base64 ``` 参数说明：无。 返回说明：返回回base64，不保留在服务器直接使用。 ##### 生成二维码 ```php $qr = PosterManager::Poster()->Qr('http://www.520yummy.com','poster/1.png'); # 生成二维码 ``` 参数说明 | 变量 | 类型 | 必填 | 注释 | | ------------ | --------------- | ---- | ------------------------------------------------------------ | | text | string | 是 | 二维码包含的内容，可以是链接、文字、json字符串等等，例如：http://www.520yummy.com | | outfile | boolean\|string | 否 | 默认为false，不生成文件，只将二维码图片返回输出；否则需要给出存放生成二维码图片的文件名及路径 | | level | string | 否 | 容错级别，默认为L， 可传递的值分别是L(QR_ECLEVEL_L，7%)、M(QR_ECLEVEL_M，15%)、Q(QR_ECLEVEL_Q，25%)、H(QR_ECLEVEL_H，30%)。这个参数控制二维码容错率，不同的参数表示二维码可被覆盖的区域百分比，也就是被覆盖的区域还能识别 | | size | integer | 否 | 控制生成图片的大小，默认为4 | | margin | integer | 否 | 控制生成二维码的空白区域大小，默认4 | | saveandprint | boolean | 否 | 保存二维码图片并显示出来，outfile 必须传递图片路径，默认false | 返回说明：outfile 为空，输出二维码图片，不生成文件；否则返回图片路径。 #### 验证码使用说明 ##### 滑块图片验证 ```php # 自定义参数 $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, // 滑块边框 ]; $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); ``` ##### 旋转图片验证 ```php # 自定义参数 $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); ``` ##### 点击图片验证 ```php # 自定义参数 $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); ``` ##### 手动输入验证 ```php # 自定义参数 $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); ``` #### 示例 ##### 图片验证 ```php 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()) } ``` ##### 海报类静态调用 ```php 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(); } ``` ##### 海报类实例化调用 ```php 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(); } ```