PHP 生成、识别二维码及安装相关扩展/工具

2018-02-20 00:30:26 更新：推荐新扩展（极力推荐）

这篇文章里用的两个二维码扩展都有些问题和麻烦：phpqrcode（生成二维码）的源码有点小 bug；而 php-zbarcode（识别二维码）需要其他开源套件和扩展模块的支持，编译起来很容易出问题，只支持 php5，而且 3 年多没维护，目测作者已放弃。对于不爱折腾开发环境的人太不方便。在 github 找到两个扩展，本人推荐：

endroid/qrcode: 生成二维码，第三方包，支持 Composer。ReadMe 里有简明的 Demo，可以快速上手。不再另说了。
php-qrcode-detector-decoder: 识别二维码，第三方包，支持 Composer。只需要 php5.6 以上和 GD 库支持。ReadMe 里也有简明的 Demo，可以快速上手。不再另说。

2018-02-04 23:28:30 更新：使用 apt 安装 zbar

编译安装 zbar 还是有毛病，很容易出问题。Ubuntu 官方源有个 zbar-tools，也就是 zbar。推荐朋友们用 apt 安装，一条命令搞定：

sudo apt-get install zbar-tools

我的系统是 Ubuntu 17.10.1，官方源有 zbar-tools，所以直接装了。装好 zbar 之后就可以使用 zbarimg path/to/your_qrcode.png 识别二维码了。如果你的 ppa 源里没有 zbar-tools、并且也没找到其他可用的ppa，那还是按照本文的 “六、安装 zbar” 部分尝试编译安装吧。

一、php 生成 qr code 二维码

phpqrcode 是由 php 编写的、可以生成 QR Code 二维码的第三方包。官网有很多例子可以参考，使用起来很简单，2 行代码。

<?php

// 1. 使用官网包

require './phpqrcode/qrlib.php';

QRcode::png('http://github.com', 'qrcode.png', QR_ECLEVEL_L, 8, 4, false);

// 该方法的最后一个参数有Bug，写 TRUE 时（保存并打印）并不会打印显示，需要修改源码

// QRcode::png('123', './qrcode.png', QR_ECLEVEL_L, 4, 4, TRUE);

// 2. 使用composer包

// aferrandini/phpqrcode 这个包在packagist.org上排名第一，是根据官网打包的，不过Bug似乎也好好的在那儿～～。

// 其他类似的composer包还有很多，按需求找吧～～

二、jquery 生成 qr code 二维码

jquery.qrcode.js 是前端生成 QR Code 二维码的插件库。下面是我参考 jquery.qrcode.js 在 github 仓库上一个 example 写的。看代码。

<!DOCTYPE html>

<html>

<head>

	<meta charset="utf-8">

	<title>QR Code</title>

	<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.2/jquery.min.js"></script>

	<script type="text/javascript" src="./js/jquery.qrcode.js"></script>

	<script type="text/javascript" src="./js/qrcode.js"></script>

</head>

<body>

	<p>快速渲染：</p>

	<div id="qrcode"></div>

	<p>table渲染：</p>

	<div id="qrcodeTable"></div>

	<p>canvas渲染：</p>

	<div id="qrcodeCanvas"></div>

	<p>设置宽高：</p>

	<div id="qrcodeResize"></div>

	<!-- -------------------------------------------------------- -->

	<script>

		// 快速渲染

		$('#qrcode').qrcode("http://github.com");

		// table渲染

		$('#qrcodeTable').qrcode({

			render	: "table",

			text	: "http://github.com"

		});

		// canvas渲染

		$('#qrcodeCanvas').qrcode({

			render  : "canvas",

			text	: "http://github.com"

		});

		// 设置宽高

		$('#qrcodeResize').qrcode({

			width   : 128,

			height  : 128,

			text	: "http://github.com"

		});

	</script>

</body>

</html>

然后浏览器访问这个页面，就能看到 4 个二维码了。

注意一下：

总之，现在记下这篇文档的时候，按照官网和 github 还有其他一些博客上的说明都只加载了 jquery.qrcode.js (query.js 除外)，但是只加载这一个 jQ 的话我这里行不通，必须再加载 qrcode.js
jQ 生成 QR Code 的代码必需在容器元素后面，可以放在 <body> 标签内最后。如果放在<head>标签中也生不出来 QR Code。这是 github上的一个例子。

三、php 生成电子名片

1. vCard

vCard 是电子名片的文件格式标准。它一般附加在电子邮件之后，但也可以用于其它场合（如在互联网上相互交换）。vCard 可包含的信息有：姓名、地址资讯、电话号码、URL，logo，相片等（摘自维基百科）。

2. 样例

下面是一个包含个人信息的 vCard 格式电子名片（摘自维基百科），可以参照它来修改：

BEGIN:VCARD

VERSION:2.1

N:Gump;Forrest

FN:Forrest Gump

ORG:Gump Shrimp Co.

TITLE:Shrimp Man

TEL;WORK;VOICE:(111) 555-1212

TEL;HOME;VOICE:(404) 555-1212

ADR;WORK:;;100 Waters Edge;Baytown;LA;30314;United States of America

LABEL;WORK;ENCODING=QUOTED-PRINTABLE:100 Waters Edge=0D=0ABaytown, LA 30314=0D=0AUnited States of America

ADR;HOME:;;42 Plantation St.;Baytown;LA;30314;United States of America

LABEL;HOME;ENCODING=QUOTED-PRINTABLE:42 Plantation St.=0D=0ABaytown, LA 30314=0D=0AUnited States of America

EMAIL;PREF;INTERNET:forrestgump@walladalla.com

REV:20080424T195243Z

END:VCARD

参考上面的 vCard 样例，可以制作个人的电子名片。具体的各个字段解释可以参考百度百科上的 vCard 介绍。

3. php 生成电子名片

照样子写一个，使用 phpqrcode 包来生成我的电子名片：

<?php

// 使用 phpqrcode 生成电子名片

require './phpqrcode/qrlib.php';

$vcard = <<<EOL

BEGIN:VCARD

VERSION:2.1

N:Jin;mingc

FN:mingc

ORG:free man

TITLE:PHPer

TEL;WORK;VOICE:1382173xxxx

TEL;HOME;VOICE:1383284xxxx

ADR;WORK;TianJin, China

LABEL;WORK;ENCODING=QUOTED-PRINTABLE:TianJin, China(LABEL;WORK)

ADR;HOME;TianJin, China

LABEL;HOME;ENCODING=QUOTED-PRINTABLE:TianJin, China(LABEL;HOME)

EMAIL;PREF;INTERNET:name@example.com

REV:20171201T005548Z

END:VCARD

EOL;

QRcode::png($vcard);

// define('EOL', "\r\n");

// $vcard  = 'BEGIN:VCARD'.EOL;

// $vcard .= 'VERSION:2.1'.EOL;

// $vcard .= 'N:Jin;mingc'.EOL;

// $vcard .= 'FN:mingc'.EOL;

// $vcard .= 'ORG:free man'.EOL;

// $vcard .= 'TITLE:PHPer'.EOL;

// $vcard .= 'TEL;WORK;VOICE:1382173xxxx'.EOL;

// $vcard .= 'TEL;HOME;VOICE:1383284xxxx'.EOL;

// $vcard .= 'ADR;WORK;TianJin, China'.EOL;

// $vcard .= 'LABEL;WORK;ENCODING=QUOTED-PRINTABLE:TianJin, China(LABEL;WORK)'.EOL;

// $vcard .= 'ADR;HOME;TianJin, China'.EOL;

// $vcard .= 'LABEL;HOME;ENCODING=QUOTED-PRINTABLE:TianJin, China(LABEL;HOME)'.EOL;

// $vcard .= 'EMAIL;PREF;INTERNET:name@example.com'.EOL;

// $vcard .= 'REV:20171201T005548Z'.EOL;

// $vcard .= 'END:VCARD';

// QRcode::png($vcard);

浏览器访问这个 php 脚本会显示一张二维码，微信扫一扫，结果如下：

这个电子名片还可以直接添加到你的手机联系人里。

四、php 识别二维码（工具）

php 识别二维码或条形码需要 3 个工具。

1. ImageMagick

ImageMagick 是一个用于查看、编辑位图文件以及进行图像格式转换的开放源代码软件套装。它可以读取、编辑超过 100 种图象格式。ImageMagick 以 ImageMagick 许可证（一个类似 BSD 的许可证）发布。

2. zbar

zbar 是一个开源软件套件，用于读取各种来源的条形码，如视频流，图像文件和原始强度传感器。它支持包括 EAN-13 / UPC-A，UPC-E，EAN-8，Code 128，Code 39，Interleaved 2 of 5 和 QR Code 等多种流行的条码。

3. php-zbarcode

php-zbarcode 是 PHP 读取条形码的扩展模块，目前仅支持 php5.x。使用这个模块之前还需要安装 ImageMagick 和 zbar 这两个命令行套件。

phpzbarcode 依赖于 ImageMagick 和 zbar，zbar 依赖于 ImageMagick，ImageMagick 依赖 jpeg 库来提供 jpeg 图片支持，所以先安装 jpeg 支持。

安装 jpeg 库

下载地址：http://www.imagemagick.org/download/delegates/，我下载的包名为 jpegsrc.v9b.tar.gz 。

wget http://www.imagemagick.org/download/delegates/jpegsrc.v9b.tar.gz

tar xf jpegsrc.v9b.tar.gz

cd jpeg-9b/

./configure

make

sudo make install

五、安装 ImageMagick

下载地址：https://www.imagemagick.org/download/，我下载的包名为 ImageMagick.tar.gz 。

wget https://www.imagemagick.org/download/ImageMagick.tar.gz

tar xf ImageMagick.tar.gz

cd ImageMagick-7.0.7-13

./configure

make

sudo make install

sudo ldconfig /usr/local/lib

magick --version

********************************************* 常见错误 *******************************************

出错1：安装好以后使用 magick 、 convert 等相关命令时，加载动态链接库出错

convert: error while loading shared libraries: libMagickCore-7.Q16HDRI.so.4: cannot open shared object file: No such file or directory

解决方法：设置动态加载动态链接库

sudo ldconfig /usr/local/lib

然后就可以正常使用命令行接口了。

六、安装 zbar

下载地址：https://sourceforge.net/projects/zbar/files/zbar/。我下载的最新版 0.10，包名为 zbar-0.10.tar.gz 。

tar xf zbar-0.10.tar.gz

cd zbar-0.10/

sudo ln -s /usr/local/include/ImageMagick-7 /usr/local/include/ImageMagick

sudo ln -s /usr/local/include/ImageMagick-7/MagickWand /usr/local/include/wand

./configure --disable-video --without-gtk --without-qt --without-python

make

make

sudo make install

zbarimg --version

********************************************* 常见错误 ********************************************

出错1：找不到 MagickWand.h 头文件

ImageMagick package found but wand/MagickWand.h not installed?!

-this is a problem with your ImageMagick install,

-please resolve the inconsistency and try again...

解决方法：zbar 的配置文件 ./configure 在运行时会找不到 MagickWand.h，它在 /usr/local/include/ImageMagick-7/MagickWand 目录下，但是 ./configure 执行时会去 wand/ 目录找（找不到），所以需要做两个软连接让 ./configure 能找到 MagickWand.h 文件

sudo ln -s /usr/local/include/ImageMagick-7 /usr/local/include/ImageMagick

sudo ln -s /usr/local/include/ImageMagick-7/MagickWand /usr/local/include/wand

出错2：make 编译期间多处 warning 和 error

zbar/decoder/ean.c: In function ‘ean_part_end4’:

zbar/decoder/ean.c:245:13: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

     if(!par == fwd) {

             ^~

zbar/decoder/ean.c:245:8: note: add parentheses around left hand side expression to silence this warning

     if(!par == fwd) {

        ^~~~

        (   )

zbar/decoder/ean.c: In function ‘ean_part_end7’:

zbar/decoder/ean.c:294:13: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

     if(!par == fwd) {

             ^~

zbar/decoder/ean.c:294:8: note: add parentheses around left hand side expression to silence this warning

     if(!par == fwd) {

        ^~~~

        (   )

zbar/qrcode/qrdec.c: In function ‘qr_finder_quick_crossing_check’:

zbar/qrcode/qrdec.c:1215:27: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

   if(!_img[_y0*_width+_x0]!=_v||!_img[_y1*_width+_x1]!=_v)return 1;

                           ^~

zbar/qrcode/qrdec.c:1215:6: note: add parentheses around left hand side expression to silence this warning

   if(!_img[_y0*_width+_x0]!=_v||!_img[_y1*_width+_x1]!=_v)return 1;

      ^~~~~~~~~~~~~~~~~~~~~

      (                    )

zbar/qrcode/qrdec.c:1215:54: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

   if(!_img[_y0*_width+_x0]!=_v||!_img[_y1*_width+_x1]!=_v)return 1;

                                                      ^~

zbar/qrcode/qrdec.c:1215:33: note: add parentheses around left hand side expression to silence this warning

   if(!_img[_y0*_width+_x0]!=_v||!_img[_y1*_width+_x1]!=_v)return 1;

                                 ^~~~~~~~~~~~~~~~~~~~~

                                 (                    )

zbar/qrcode/qrdec.c:1216:45: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

   if(!_img[(_y0+_y1>>1)*_width+(_x0+_x1>>1)]==_v)return -1;

                                             ^~

zbar/qrcode/qrdec.c:1216:6: note: add parentheses around left hand side expression to silence this warning

   if(!_img[(_y0+_y1>>1)*_width+(_x0+_x1>>1)]==_v)return -1;

      ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

      (                                      )

zbar/qrcode/qrdec.c: In function ‘qr_finder_locate_crossing’:

zbar/qrcode/qrdec.c:1257:33: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

     if(!_img[x0[1]*_width+x0[0]]!=_v)break;

                                 ^~

zbar/qrcode/qrdec.c:1257:8: note: add parentheses around left hand side expression to silence this warning

     if(!_img[x0[1]*_width+x0[0]]!=_v)break;

        ^~~~~~~~~~~~~~~~~~~~~~~~~

        (                        )

zbar/qrcode/qrdec.c:1269:33: warning: logical not is only applied to the left hand side of comparison [-Wlogical-not-parentheses]

     if(!_img[x1[1]*_width+x1[0]]!=_v)break;

                                 ^~

zbar/qrcode/qrdec.c:1269:8: note: add parentheses around left hand side expression to silence this warning

     if(!_img[x1[1]*_width+x1[0]]!=_v)break;

        ^~~~~~~~~~~~~~~~~~~~~~~~~

        (                        )

zbar/jpeg.c: In function ‘_zbar_convert_jpeg_to_y’:

zbar/jpeg.c:174:39: warning: assignment from incompatible pointer type [-Wincompatible-pointer-types]

         cinfo->src->fill_input_buffer = fill_input_buffer;

                                       ^

解决方法：再次编译

make

七、安装 php-zbarcode

下载地址：https://github.com/mkoppanen/php-zbarcode

wget https://github.com/mkoppanen/php-zbarcode/archive/master.zip

unzip master.zip

cd php-zbarcode-master/

phpize

./configure --with-php-config=/usr/bin/php-config

make

sudo make install

成功后会提示安装到的模块目录

Installing shared extensions:     /usr/lib/php/20131226/

确认模块的位置

mingc@mingc-GE60-2PL:~/Downloads/qrcode/php-zbarcode-master$ ls /usr/lib/php/20131226/

build        dom.so       gettext.so   mcrypt.so     mysqli.so   pdo_mysql.so   posix.so      sockets.so  tokenizer.so  xmlwriter.so

bz2.so       exif.so      iconv.so     memcached.so  mysqlnd.so  pdo_odbc.so    readline.so   sqlite3.so  wddx.so       xsl.so

calendar.so  fileinfo.so  igbinary.so  memcache.so   mysql.so    pdo.so         redis.so      sysvmsg.so  xmlreader.so  zbarcode.so

ctype.so     ftp.so       json.so      mongo.so      odbc.so     pdo_sqlite.so  shmop.so      sysvsem.so  xmlrpc.so     zip.so

dba.so       gd.so        mbstring.so  msgpack.so    opcache.so  phar.so        simplexml.so  sysvshm.so  xml.so

可以看到有了 zbarcode.so 文件。然后启用 zbarcode 扩展，编辑 /etc/php/5.6/apache2/php.ini 文件

sudo vim /etc/php/5.6/apache2/php.ini

最后添加一行

extension=zbarcode.so

重启 apache

sudo /etc/init.d/apache2 restart

这就好了，可以使用条形码扩展了。

注意 php -m 命令显示的是 php-cli 模式启用的扩展，要让 php-cli 模式也启用扩展的话，需要再编辑 cli 模式的配置文件。在 /etc/php/5.6/cli/php.ini 里，最后添加一行

extension=zbarcode.so

然后就能使用 php -m 命令看到 zbarcode 模块了。

八、php 识别二维码

参照 github 上的 php-zbarcode 示例，识别一下我刚才生成的电子名片。

<?php

/* Create new image object */

$image = new ZBarCodeImage("./qrcode_vcard.png");

/* Create a barcode scanner */

$scanner = new ZBarCodeScanner();

/* Scan the image */

$barcode = $scanner->scan($image);

/* Loop through possible barcodes */

if (!empty($barcode)) {

	foreach ($barcode as $code) {

		printf("Found type %s barcode with data %s\n", $code['type'], $code['data']);

	}

}

识别结果：

Found type QR-Code barcode with data BEGIN:VCARD

VERSION:2.1

N:Jin;mingc

FN:mingc

ORG:free man

TITLE:PHPer

TEL;WORK;VOICE:1382173xxxx

TEL;HOME;VOICE:1383284xxxx

ADR;WORK;TianJin, China

LABEL;WORK;ENCODING=QUOTED-PRINTABLE:TianJin, China(LABEL;WORK)

ADR;HOME;TianJin, China

LABEL;HOME;ENCODING=QUOTED-PRINTABLE:TianJin, China(LABEL;HOME)

EMAIL;PREF;INTERNET:name@example.com

REV:20171201T005548Z

END:VCARD

九、参考链接