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

墨迹

php7早已于2015年12月发布，当前7.0分支已经进化到7.0.11版，而7.1分支也发布了RC3版，很快7.1将发布正式版。本博曾经介绍过在php生成二维码的phpqrcode这个类库，原文见此：https://blog.jjonline.cn/phptech/110.html；但这个类太老旧了，sourceforge代码托管平台上这个类已经很久没更新过了，最新的版本还是2010年10月7日发布的，截止至今天刚好6年。

2009年php发布5.3时首次引入了命名空间的概念，而phpqrcode发布最后一个版本的2010年，那个时候php的命名空间还不流行，也没能在广泛范围内被接受。今天要介绍的php7下生成二维码的高效类QrCode是一个由荷兰开发开发的二维码生成类，可以用composer来管理，php7下当然还可以使用phpqrcode。顺应时代才不会被淘汰，虽然php高版本的命名空间语法让人无比蛋疼。

php的类库管理工具：composer

你是否有这种麻烦？一个项目引入的各种sdk、开源类太多了，而每个开源类又有不同版本，管理起来相当麻烦，只能手工处理每一个类的存放路径和文件引入。

composer就是用于解决这个麻烦的，使用简单的composer命令就可以很便捷的安装和管理各种支持composer的开源类。composer是什么？简单点来说就是一个用于管理php类的工具，使用composer管理和管理的类均自动按一定路径规则存储类文件并提供好php加载器供项目中调用。时下composer越来越方便，各种框架、强大的开源类都逐一支持了composer安装和管理，比如：Yii、ThinkPHP，乃至大名鼎鼎的由PHP官方开发组开发的Zend Framework2框架也支持composer。

composer的具体介绍和使用不再墨迹，网上一大把，留下一个：https://www.kancloud.cn/thinkphp/composer

QrCode的安装和使用

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

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

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

安装完毕该目录下会自动生成vendor目录和composer.json、composer.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']) : 'https://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；注意实际图片大小还受到setPadding和setLabelFontSize的影响

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为：https://blog.jjonline.cn/project/qrcode/，你可以通过get变量data指定生成二维码的内容、size变量指定生成二维码的尺寸，最大1000px，以及label指定生成的label内容，例如：

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

转载请注明本文标题和链接：《php7高效生成二维码：composer和荷兰PHP开发者的QrCode》