萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP QR Code 庫生成二維碼完整教學:安裝、參數調優、Logo 嵌入與批量生成

PHP QR Code 是輕量級的二維碼生成庫,支援 QR Code 標準、多種容錯等級、尺寸自訂。本文從安裝到進階應用(Logo 嵌入、批量生成、效能優化)完整解析。

安裝方式

Composer(推薦)

composer require endroid/qr-code

注意:原版 phpqrcode 多年未維護,建議改用現代化分支 endroid/qr-code(支援 PHP 8、命名空間、PSR-4、型別提示)。

手動下載(舊專案相容)

  1. 下載 phpqrcode 解壓至專案 lib/phpqrcode/
  2. 引入 require_once 'lib/phpqrcode/qrlib.php';

基礎用法(Endroid QR Code v4+)

<?php
require_once 'vendor/autoload.php';

use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;

$qrCode = new QrCode('https://example.com');
$qrCode->setSize(300);           // 像素尺寸
$qrCode->setMargin(10);          // 邊距
$qrCode->setErrorCorrectionLevel('H'); // L/M/Q/H,H 最高容錯 30%

$writer = new PngWriter();
$result = $writer->write($qrCode);

// 直接輸出瀏覽器
header('Content-Type: ' . $result->getMimeType());
echo $result->getString();

// 或儲存檔案
$result->saveToFile(__DIR__ . '/qrcode.png');

舊版 phpqrcode 相容寫法

<?php
include 'lib/phpqrcode/qrlib.php';

$data = 'https://example.com';
$level = 'H';      // 容錯等級
$size = 10;        // 模組大小 (1-50)
$margin = 2;       // 邊距模組數
$filename = 'temp/qrcode_' . time() . '.png';

QRcode::png($data, $filename, $level, $size, $margin);
echo '<img src="' . $filename . '" alt="QR Code" />';

進階:嵌入 Logo(品牌化二維碼)

<?php
use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;
use Endroid\QrCode\Logo\Logo;
use Endroid\QrCode\Logo\LogoPath;

$qrCode = new QrCode('https://example.com');
$qrCode->setSize(400);
$qrCode->setErrorCorrectionLevel('H'); // 嵌入 Logo 必須用 H 級

$logo = new Logo(new LogoPath(__DIR__ . '/logo.png'));
$logo->setWidth(80);  // Logo 寬度
$logo->setHeight(80);

$writer = new PngWriter();
$result = $writer->write($qrCode, logo: $logo);
$result->saveToFile('qrcode_with_logo.png');

原理:QR Code 容錯機制允許部分模組被遮蓋仍可解碼。H 級容錯 30%,Logo 面積建議 < 20% 確保可讀性。

批量生成效能優化

<?php
use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;

$writer = new PngWriter(); // 重用 writer 實例
$qrCode = new QrCode('');
$qrCode->setSize(200);
$qrCode->setErrorCorrectionLevel('M');

$urls = [
    'https://site.com/user/1',
    'https://site.com/user/2',
    // ... 10000 筆
];

foreach ($urls as $i => $url) {
    $qrCode->setData($url);
    $result = $writer->write($qrCode);
    $result->saveToFile("qrcodes/{$i}.png");

    // 每 100 釋放記憶體
    if ($i % 100 === 0) gc_collect_cycles();
}

容錯等級選擇指南

等級容錯率適用場景密度
L (Low)7%乾淨環境、大尺寸列印最低
M (Medium)15%一般用途、螢幕顯示中等
Q (Quartile)25%可能有污損、小尺寸列印較高
H (High)30%嵌入 Logo、惡劣環境、金屬蝕刻最高

常見問題排查

  • 掃不出來:檢查邊距是否足夠(≥4 模組)、對比度是否足夠、Logo 是否過大遮蓋定位點
  • 中文亂碼:QR Code 標準支援 UTF-8,確保輸入字串為 UTF-8 編碼
  • 記憶體耗盡:批量生成時分批處理、及時 gc_collect_cycles()、避免在迴圈中重複建立 Writer
  • 輸出格式:支援 PNG、SVG、EPS,SVG 適合無限縮放列印
copyright © 萬盛學電腦網 all rights reserved