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
九、参考链接
