NIUSHOP开源商城 V6，优秀的架构设计！代码干净，高质量，为开发者而生！前后端API接口分离！前端采用最流行技术Vite+...

### **poster** #### 介绍 **得益于 gd、imagick、phpqrcode、wkhtmltopdf** **主要为了封装一个生成图片便捷的插件，非常感谢使用到的所有工具背后开发者的贡献** PHP海报生成插件，极速生成方便快捷。 快速生成海报、生成签到日、生成二维码、合成二维码、图片添加水印 滑块验证图片生成、旋转验证图片生成、点击验证图片生成、输入验证图片生成 **小提示：** **如果无法更新版本，composer 切换回原镜像** 全局设置 composer config -g repo.packagist composer https://repo.packagist.org #### authors lang 732853989@qq.com 群号 590660254 [点击链接加入群聊【海报图片验证交流群】](https://jq.qq.com/?_wv=1027&k=k374FhrR) #### 使用文档 > 文档地址：http://langlanglang.gitee.io/poster-doc/ #### 安装或更新 1. composer require kkokk/poster 2. composer update kkokk/poster #### 演示效果 ##### **输入验证码验证** 数字、算术、中文、字母加数字 ##### **点击图片验证** <img src="tests/1223015613615230151165.gif" alt="输入图片说明" style="zoom: 33%;" /> ##### 旋转图片验证 <img src="tests/1223015613610230151165.gif" alt="输入图片说明" style="zoom: 33%;" /> ##### 滑块验证图片 <img src="tests/122301561368230151165-1.gif" alt="输入图片说明" style="zoom: 33%;" /> ##### 海报生成图片示例 <img src="tests/Kvt1cV5ygB.png" alt="输入图片说明" title="在这里输入图片标题" style="zoom:50%;" /> <img src="tests/YRG3X4WgSZ3lLlwULkxZ3W3LLGgZ4b.jpeg" alt="输入图片说明" style="zoom:50%;" /> <img src="tests/JoJhekR1um.png" alt="输入图片说明" style="zoom:50%;" /> 演示地址：暂无 ​ 生成签到日历海报、邀请海报 #### **生成海报** 注意：没有特别说明，统一都是px。 ##### 通过 PosterManager 调用 ```php use Kkokk\Poster\PosterManager; // 使用 PosterManager 调用 $poster = PosterManager::Poster(); ``` ##### 通过 Facades 调用 ```php 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(); # 获取合成后图片文件地址 ``` > 技巧：也可以分开使用 ```php $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 拓展 ```php $poster = PosterManager::Poster(); // 使用 PosterManager 调用 $Poster = Poster::config($params); // 使用 Facades\Poster 调用 ``` ##### 使用 Imagick 拓展 ```php $poster = PosterManager::Poster()->extension('imagick'); // 使用 PosterManager 调用 $Poster = Poster::extension('imagick')->config($params); // 使用 Facades\Poster 调用 ``` ##### 基础配置 ```php $params = [ 'path' => $path, // 设置路径 'dpi' => $dpi, // int[]|int 设置 dpi 只针对 Imagick 有效 '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); ``` ##### 设置路径 ```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 | ##### **创建背景、遮罩** > 注意：Imagick 方式，背景目前支持做圆角，渐变色可以支持多种，方向只支持上下 ```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 /** * 合成图片 * @param string|array $src 图片地址，旋转角度 */ $poster->buildImage($src,$dst_x,$dst_y,$src_x,$src_y,$src_w,$src_h,$alpha,$type); # 合成图片 ``` > 注意：旋转角度是顺时针 参数说明 | 变量 | 类型 | 必填 | 注释 | | ----- |----------------|----|------------------------------------------------------------------------------------------| | src | string\|array | 是 | ['src'=> $src, 'angle'=> $angle] <br> $src: 路径，支持网络图片（带http或https）<br>$angle: 旋转角度，顺时针旋�