PHP实现二维码生成与扫描的完整教程

M66 2025-10-29

PHP中实现二维码生成与扫描的方法

二维码在现代应用中随处可见，无论是移动支付、网站登录还是商品追踪，都离不开二维码的支持。本文将介绍如何在PHP中生成和扫描二维码，使用简单的代码实现完整的二维码功能。

准备工作：引入必要的库

要在PHP中处理二维码，我们主要用到两个库：

PHP QR Code：用于生成二维码图片。
ZBar：用于识别二维码内容。

首先，可以从GitHub上下载 PHP QR Code 的源码并引入到项目中。接着，请确保PHP环境中启用了GD扩展，因为该扩展负责图像的生成与处理。

使用PHP QR Code生成二维码

以下示例演示了如何使用 PHP QR Code 库生成二维码图片：

// 引入QR Code库
require_once('qrlib.php');

// 配置参数
$text = 'https://example.com';  // 二维码中包含的文本信息
$size = 10;  // 二维码的大小，单位为像素

// 生成二维码图片
$filename = 'qrcode.png';
QRcode::png($text, $filename, QR_ECLEVEL_L, $size);

echo '二维码已生成：' . $filename;

执行以上代码后，会在项目目录中生成一个二维码图片文件。你可以将该图片输出到浏览器，或保存到服务器中以便后续使用。

使用ZBar实现二维码扫描识别

二维码生成后，我们还需要实现扫描功能。ZBar 是一个开源的二维码识别库，它支持多种语言和平台。安装后即可通过PHP扩展调用。

在Linux系统下，可使用包管理器安装ZBar；在Windows系统中，可以从ZBar官网获取二进制版本并配置环境变量。

二维码扫描代码示例

下面的示例展示了如何使用ZBar扩展在PHP中识别二维码图片内容：

// 创建图像资源
$image = imagecreatefrompng('qrcode.png');

// 初始化ZBar扩展
$scanner = zbar_scanner_create();
zbar_scanner_set_config($scanner, 0, ZBAR_CFG_ENABLE, 1);

// 扫描图像中的二维码
zbar_scan_image($scanner, $image);  // 返回的结果对象是一个数组

// 获取识别结果
$results = zbar_get_results($scanner);
foreach ($results as $result) {
  echo '识别结果：' . $result->data . ' (类型：' . $result->type . ')' . PHP_EOL;
}

// 释放资源
zbar_image_destroy($image);
zbar_scanner_destroy($scanner);

执行后，程序会读取指定的二维码图片并输出识别到的内容。例如，当二维码中包含一个URL或文本时，脚本会在终端中显示该数据。

总结

通过本文介绍的方法，开发者可以轻松在PHP中实现二维码的生成与扫描功能。使用PHP QR Code库生成二维码，再结合ZBar进行识别，不仅高效可靠，而且实现简单，适合在网站、后台系统或管理工具中集成使用。希望这篇教程能帮助你更好地掌握PHP的二维码应用。