用PHP识别二维码

PHP 二维码识别的基本原理

PHP 本身不直接支持二维码识别功能，但可以通过调用第三方库或扩展实现。常用方法包括使用 zxing 命令行工具、php-qrcode-detector-decoder 库或基于图像处理的扩展如 imagick。

安装必要的依赖

使用 php-qrcode-detector-decoder 库需要先通过 Composer 安装：

composer require khanamiryan/qrcode-detector-decoder

通过本地文件识别二维码

以下代码演示如何从本地图片文件中读取二维码内容：

require_once 'vendor/autoload.php';
use Zxing\QrReader;

$qrcode = new QrReader('qrcode.png');
$text = $qrcode->text(); 
echo "识别结果：".$text;

处理网络图片中的二维码

通过下载网络图片到临时目录后再进行识别：

$imageUrl = 'https://example.com/qrcode.png';
$tempFile = tempnam(sys_get_temp_dir(), 'qr');
file_put_contents($tempFile, file_get_contents($imageUrl));

$reader = new QrReader($tempFile);
echo $reader->text();
unlink($tempFile); // 清理临时文件

处理摄像头实时捕获的二维码

需要结合前端 JavaScript 获取摄像头图像后提交到 PHP 后端处理：

// 接收Base64格式的图像数据
$imageData = $_POST['image'];
$imageData = str_replace('data:image/png;base64,', '', $imageData);
$imageData = base64_decode($imageData);

$tempFile = tempnam(sys_get_temp_dir(), 'cam');
file_put_contents($tempFile, $imageData);

$result = (new QrReader($tempFile))->text();
echo json_encode(['status' => 'success', 'data' => $result]);

提高识别率的技巧

对低质量图像进行预处理可以提高识别成功率：

$imagick = new \Imagick('low-quality-qr.jpg');
$imagick->enhanceImage();
$imagick->adaptiveSharpenImage(0, 1);
$imagick->writeImage('processed.jpg');

$reader = new QrReader('processed.jpg');
echo $reader->text();

处理多个二维码的复杂场景

当图片中包含多个二维码时，需要先进行图像分割：

$image = imagecreatefromjpeg('multi-qr.jpg');
$width = imagesx($image);
$height = imagesy($image);

// 简单示例：分割为左右两部分
$left = imagecrop($image, ['x' => 0, 'y' => 0, 'width' => $width/2, 'height' => $height]);
$right = imagecrop($image, ['x' => $width/2, 'y' => 0, 'width' => $width/2, 'height' => $height]);

imagejpeg($left, 'left.jpg');
imagejpeg($right, 'right.jpg');

$result1 = (new QrReader('left.jpg'))->text();
$result2 = (new QrReader('right.jpg'))->text();
echo "左侧二维码：$result1\n右侧二维码：$result2";

错误处理与日志记录

完善的错误处理机制能提高系统稳定性：

try {
    $reader = new QrReader('invalid.jpg');
    $text = $reader->text();
    
    if(empty($text)) {
        throw new Exception('未识别到有效二维码');
    }
    
    echo $text;
} catch(Exception $e) {
    error_log('二维码识别失败：'.$e->getMessage());
    http_response_code(400);
    echo '处理失败：'.$e->getMessage();
}

性能优化建议

批量处理时可以考虑以下优化方案：

$files = glob('qrcodes/*.png');
$results = [];

foreach($files as $file) {
    $start = microtime(true);
    $text = (new QrReader($file))->text();
    $time = round(microtime(true) - $start, 3);
    
    $results[] = [
        'file' => basename($file),
        'content' => $text,
        'process_time' => $time.'s'
    ];
}

header('Content-Type: application/json');
echo json_encode($results, JSON_PRETTY_PRINT);