PHP QR Code 是輕量級的二維碼生成庫,支援 QR Code 標準、多種容錯等級、尺寸自訂。本文從安裝到進階應用(Logo 嵌入、批量生成、效能優化)完整解析。
composer require endroid/qr-code
注意:原版 phpqrcode 多年未維護,建議改用現代化分支 endroid/qr-code(支援 PHP 8、命名空間、PSR-4、型別提示)。
lib/phpqrcode/require_once 'lib/phpqrcode/qrlib.php';<?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');
<?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" />';
<?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、惡劣環境、金屬蝕刻 | 最高 |
gc_collect_cycles()、避免在迴圈中重複建立 Writer