升级指南
配置
简例
使用说明
助手模板
QrCode 常规用法
在Laravel外的调用方式
介绍
Simple QrCode 是基于Bacon/BaconQrCode 开发，适用于Laravel框架的软件包. 我们的目的是让二维码能更加便捷的使用在Laravel框架的项目里.
Example 1 Example 2
升级指南
从v2版本升到v3需要将 composer.json 文件中版本改为 ~3
如果你需要使用 png 文件格式，那么你必须安装 imagick PHP扩展.
配置
Composer安装
使用 composer require simplesoftwareio/simple-qrcode "~3" 安装软件包，
Laravel将会自动完成安装工作.
添加 Service Provider
Laravel generate(Request::url()); !!}
扫我返回初始页
嵌入二维码
你也可以嵌入二维码在你的邮件中，让收信的用户可以快速扫描.以下是在Laravel中实现的例子:
//Inside of a blade template.
embedData(QrCode::format('png')->generate('Embed me into an e-mail!'), 'QrCode.png', 'image/png')!!}">
使用说明
基本使用
使用QrCode的Generator非常方便. 多数情况下只要这样:
QrCode::generate('Make me into a QrCode!');
这就能创建一个内容是:"Make me into a QrCode!" 的二维码了.
生成 generate(string $data, string $filename = null)
Generate 是用来创建二维码的方法.
QrCode::generate('Make me into a QrCode!');
注意:要创建二维码必须使用此方法
Generate 默认返回一个 SVG 格式的图片文本. 你可以直接在Laravel 的 Blade页面 中使用,使用方式如下:
{!! QrCode::generate('Make me into a QrCode!'); !!}
generate 方法的第二个参数是指定要存储图片数据的文件地址及命名.
QrCode::generate('Make me into a QrCode!', '../public/qrcodes/qrcode.svg');
格式 format(string $format)
现支持 PNG，EPS，SVG 三种格式,设置方式如下:
QrCode::format('png');//放回PNG图片
QrCode::format('eps');//放回EPS图片
QrCode::format('svg');//放回SVG图片
必须 imagick PHP扩展才能生成 png 图片.
尺寸 size(int $size)
QrCode 的 Generator 默认返回可能最小像素单位的二维码.
你可以使用 size 方法来设置二维码尺寸.下方是设置像素尺寸的方法:
QrCode::size(100);
200 像素 250 像素
颜色 color(int $red, int $green, int $blue, int $alpha = null)
注意改变颜色后,可能会导致某些设备难以识别.
颜色设置的格式必须是RGBA格式. 设置方式如下:
QrCode::color(255, 0, 0); // 红色二维码
QrCode::color(255, 0, 0, 25); //红色二维码+25%透明度
红色二维码 红色透明二维码
背景颜色 backgroundColor(int $red, int $green, int $blue, int $alpha = null)
你可以使用backgroundColor 方法来设置背景颜色.
QrCode::backgroundColor(255, 0, 0); // 红色背景二维码
QrCode::backgroundColor(255, 0, 0, 25); // 红色25%透明背景二维码
红色背景二维码 红色透明背景二维码
渐变 gradient($startRed, $startGreen, $startBlue, $endRed, $endGreen, $endBlue, string $type)
你可以使用 gradient 方法设置渐变.
支持以下渐变类型:
类型范例
vertical垂直垂直
horizontal水平水平
diagonal对角对角
inverse_diagonal反对角反对角
radial迳向迳向
定位颜色 eyeColor(int $eyeNumber, int $innerRed, int $innerGreen, int $innerBlue, int $outterRed = 0, int $outterGreen = 0, int $outterBlue = 0)
你可以使用 eyeColor 方法设置定位眼颜色.
数量范例
0Eye 0
1Eye 1
2Eye 2
风格 style(string $style, float $size = 0.5)
二维码风格可以轻易的使用 square, dot 或 round来调换. 这将改变二维码中的信息块风格. 第二个参数是设置dot'点'的大小和round的圆度.
风格范例
sqaure方方
dot点点
round圆圆
定位眼风格 eyeStyle(string $style)
二维码定位眼支持2个格式, sqaure方 和 circle圆.
风格范例
sqaure方方
circle圆圆
边距 margin(int $margin)
也支持设置边距. 设置方式如下:
QrCode::margin(100);
容错级别
改变二维码的容错级别也很方便. 只要这么设置:
QrCode::errorCorrection('H');
下方是 errorCorrection 方法支持的容错级别设置.
容错级别说明
L7% 的字节码恢复率.
M15% 的字节码恢复率.
Q25% 的字节码恢复率.
H30% 的字节码恢复率.
容错级别越高,二维码越大