php7高效生成二维码:composer和荷兰PHP开发者的QrCode

QrCode的安装和使用

关于QrCode这个类库没必要详细介绍,基于php的GD库,用于生成任意尺寸的二维码,并且可以将logo水印也打上去,还可以在二维码图片下方加入文字。QrCode的项目地址:https://github.com/endroid/QrCode

在命令行下操作安装QrCode类:进入项目根目录或测试目录,执行composer安装命令,如下

cd /wwwRoot/Blog/wwwRoot/project/qrcodecomposer require endroid/qrcode 

安装完毕该目录下会自动生成vendor目录和composer.jsoncomposer.lock文件,截图如下:

其中font目录是我后面加入的字体文件放置目录,index.php是本次测试调用入口文件。composer安装完毕,QrCode的类文件就按照composer的规则自动存放在vendor目录下了,打开vendor目录你会发现有个autoload.php文件和几个文件夹,这几个文件存放的就是各种类库文件了。vendor目录结构如下:

其中composer目录是composer这个工具所实现的php自动加载器,endroid目录就是本次QrCode的类库文件了,而symfony目录则是endroid依赖的另外一个php类库,安装QrCode库时symfony会自动安装,不用手动处理依赖关系。而autoload.php文件则是composer自动为我们处理好的php类加载器,我们要调用由composer安装的某个类时,引用这个文件即可,不用再去include一堆文件了,这就是命名空间与文件存储路径按一定规则一一对应,并利用php的spl_autoload_register函数实现的自动加载机制实现各个类的自动加载功能,所以我们要调用由composer安装的类时只需要引入autoload.php这个加载器文件就可以了。如果我们自己的项目也有自动加载器也并不影响,这就是spl_autoload_register这个函数的好处了,可以存在多个加载器。

QrCode调用的代码示例:

本次示例很简单,并没有融入到已有项目中,所以新建一个index.php直接调用就可以了,代码中会有一些解释,代码如下:

<?php/** * php7下生成二维码 * `利用composer管理类` * @authors Jea杨 (JJonline@JJonline.Cn) * @date    2016-10-07 20:26:05 * @version 1.0 */error_reporting(0);//引入composer自动生成的类加载器require_once 'vendor/autoload.php';//命名空间方式调用QrCode类use Endroid\QrCode\QrCode as EndroidQrCode;//将QrCode命名空间腾出来 //处理需生成二维码的内容、参数和文字$data  = trim($_GET['data']) ? trim($_GET['data']) : 'http://blog.jjonline.cn/';$size  = intval($_GET['size']) > 1000 ? 1000 : intval($_GET['size']);$label = trim($_GET['label']) ? trim($_GET['label']) : null; $QrModel = new EndroidQrCode();##默认参数$QrModel->setText($data) //设置二维码上的内容        ->setPadding(5) //设置二维码内容距离图片边缘的便宜量,单位:像素px        ->setErrorCorrection('high') //设置二维码的纠错率,可以有low、medium、quartile、hign多个纠错率        ->setForegroundColor(array('r' => 0, 'g' => 0, 'b' => 0, 'a' => 0)) //设置二维码的rgb颜色和透明度a,这里是黑色        ->setBackgroundColor(array('r' => 255, 'g' => 255, 'b' => 255, 'a' => 0)) //设置二维码图片的背景底色,这里是白色        ->setImageType(EndroidQrCode::IMAGE_TYPE_PNG);//设置输出的二维码图片格式,这里设置成png格式,还可以有gif、jpeg、wbmp###可能的指定生成的二维码尺寸,由get变量获取$size ? $QrModel->setSize(intval($size)) : $QrModel->setSize(190);###可能的指定二维码下方的文字,由get变量获取;写死15px的字体大小,方正静蕾简体手写体的字体$label && $QrModel->setLabelFontPath('./font/yaya.ttf')->setLabel($label)->setLabelFontSize(15); ###设置输出的header头:输出的内容是一张图片header('Content-Type: '.$QrModel->getContentType());##QrCode类的输出png图片数据的方法输出图片,这个时候使用浏览器访问这个Url将显示一张二维码图片$QrModel->render(); ###如果要加上logo水印,则在调用render方法之前调用setLogo和setLogoSize方法#这里就不调用了,写出示例/** * $QrModel->setLogo('./logo.png');//设置logo水印图片的路径,相对路径和绝对路径均可,这里`./logo.png`表示使用与本文件平级的logo.png * $QrModel->setLogoSize(48);//设置logo水印的大小,参数是一个int数字,单位px (注意:这里假设你的logo是一个正方形) *  * header('Content-Type: '.$QrModel->getContentType()); * $QrModel->render(); */ 

1、设置二维码的内容方法:setText,参数为需要写入到二维码图像中的文本内容,可以是任意文本,但不能超过二维码图像的信息容量

2、设置二维码尺寸的方法:setSize,参数为int型的数字,单位为像素px;注意实际图片大小还受到setPaddingsetLabelFontSize的影响

3、设置二维码距离边界的偏移量方法:setPadding,参数为int型的数字,单位为像素px

4、设置水印和水印尺寸的方法:setLogo方法指定水印图片的路径,也就是该方法的参数是水印图片的路径,可以是相对路径,也可以是绝对路径,以及setLogoSize方法设置水印图片尺寸大小,参数为int型的数字,单位为像素px,默认值为48,这个方法设置了水印图片在二维码图中的大小,并且假设了你的logo是个正方形,所以要留意参数范围。

5、设置label和label字体大小以及字体的方法:setLabelFontPath方法指定生成label文字的字体文件位置,参数是字体文件的路径、setLabel设置指定label的内容、setLabelFontSize设置生成的label字体的大小,参数为int型的数字,单位为像素px

6、如果生成的二维码图片不是输出到浏览器,需要保存到服务器中,使用save方法,参数是保存这张二维码图片的路径,相对路径和绝对路径均可

何为label?见上图,上图中晶晶的博客就是label,上图为了便于说明,我加上了1px绿色的边框。

何为二维码距离边界的偏移量?上图黑色二维图像边缘并不是靠近图片边界的,二维码图像距离图片边界的距离即为setPadding方法设置的偏移量,上图的setPadding值设置的5,也就是5像素。

代码中已有详细的注释和说明,就不再墨迹了,需要注意的是:composer需要php5.3.2以上的php环境,本次试验环境是php7.0.11,QrCode支持链式调用,所以写法上要能理解。

几个留意点

1、QrCode生成中文汉字的label的问题:需要引入中文字体,所以需要调用setLabelFontPath方法传入一个中文字体的路径,QrCode默认提供有一个字体为opensans.ttf,在\vendor\endroid\qrcode\assets\font路径下,但QrCode类并未默认调用这个字体,若不调用setLabelFontPath方法设置字体的话,生成中文的label会是小方框。另外需要使用UTF8编码的中文设置label

2、GD库编译参数的影响:当编译php时加上了–enable-gd-jis-conv参数的话,也就是让php的GD库支持日文编码的字库;简单点来说:开启了这个选项的话GD就会把TTF字库中大于127的部分(即不属于标准拉丁文字库的部分)按照日文JIS的顺序来映射,那么用来映射中文字体的时候自然就变成乱码了。如果你的php开启了–enable-gd-jis-conv选项,设置中文label时纵使你传入的是utf8编码的也会出现乱码错误,原因前述已解释。考虑到国内制作图片时需要支持鬼子文字的情况较少,建议编译php时去除–enable-gd-jis-conv选项。

3、若调用QrCode代码生成二维码出现错误,请检查你的php版本,还有GD库编译参数:譬如是否支持png、jpeg、gif、wbmp等。

-----

最后将本文的示例放在线上环境,url为:http://blog.jjonline.cn/project/qrcode/,你可以通过get变量data指定生成二维码的内容、size变量指定生成二维码的尺寸,最大1000px,以及label指定生成的label内容,例如:

http://blog.jjonline.cn/project/qrcode/?data=http://blog.jjonline.cn/&size=300&label=%E6%99%B6%E6%99%B6%E7%9A%84%E5%8D%9A%E5%AE%A2

原创声明,本文系作者授权云+社区发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Small Code

【Python】解决使用 plt.savefig 保存图片时一片空白

更新 这里我会列出对本文的更新。 2017 年 9 月 28 日:修正几处错字,优化排版。 问题 当使用如下代码保存使用 plt.savefig 保存生成的图片...

8169
来自专栏陈树义

Java 图片处理解决方案:ImageMagick 快速入门教程

ImageMagick介绍 ImageMagick是一个免费的创建、编辑、合成图片的软件,可以实现图片切割、颜色替换、图片缩略图、图片水印等各种效果。Imag...

5464
来自专栏潇涧技术专栏

Mou and StackEdit and Mathjax

本文记录使用Mou和Stackedit中出现的一些问题,使其能够正常渲染带数学公式的文章

981
来自专栏性能与架构

JS引发页面重排重绘的代价

示例 目标是修改div内容,3种实现方式,看下每种方式的执行时间 <html> <body> <div id="myDiv1"></div> <div id="...

3606
来自专栏Windows Community

New Windows 10 SDK - Toast Notification

概述 Toast Notification 在 UWP App 中有很重要的作用,能够很大程度上增强 App 和用户之间的沟通,比如运营推广活动、版本更新、提醒...

3657
来自专栏后端技术探索

2分钟夜读学习:设置图片加载失败时的默认图片

通过程序执行就行呗,程序有时候可能考虑不到这个问题,每次去判断图片是否存在也太麻烦了。最简单的就是通过图片配置实现。

874
来自专栏pangguoming

Angular2 -- 生命周期钩子

指令和组件的实例有一个生命周期:新建、更新和销毁。 每个接口都有唯一的一个钩子方法,它们的名字是由接口名加上 ng前缀构成的。比如,OnInit接口的钩子方法...

1022
来自专栏夏时

使用PHP抓取Bing每日图像并为己所用

2143
来自专栏macOS 开发学习

Mac OSX 开发基础控件学习之 NSOutlineView

在开发基于osx的Application的过程中,当我们需要显示一组列表结构的数据时,比较容易想到的控件是NSTableView;但如果你显示的数据有层级结构...

2112
来自专栏前端布道

Angular开发实践(五):深入解析变化监测

什么是变化监测 在使用 Angular 进行开发中,我们常用到 Angular 中的绑定——模型到视图的输入绑定、视图到模型的输出绑定以及视图与模型的双向绑定。...

4148

扫码关注云+社区

领取腾讯云代金券