作者遇到 Android 掃描 vCard 格式二維碼時中文姓名亂碼,發現缺少 ORG 欄位內容時發生,補上固定字串後恢復正常。這暗示:
根治方向:明確指定編碼模式為 UTF-8、確保資料前置 BOM 或使用 ECI 模式指示字符集、驗證生成庫是否支援 QR_MODE_8 (Byte mode) 並正確處理多位元組字符。
<?php
function generateQRfromGoogle($chl, $widthHeight = 150, $EC_level = 'L', $margin = 0)
{
$url = 'https://chart.googleapis.com/chart?chs=' . $widthHeight . 'x' . $widthHeight
. '&cht=qr&chld=' . $EC_level . '|' . $margin
. '&chl=' . urlencode($chl);
echo "<img src=\"$url\" alt=\"QR Code\" />";
}
⚠️ Google 於 2019 年正式關閉 Chart API,僅供歷史參考。
專案地址:phpqrcode.sourceforge.net | SourceForge 下載
基礎用法:
require_once 'phpqrcode/qrlib.php';
// 直接輸出到瀏覽器
QRcode::png('https://example.com');
// 儲存檔案
QRcode::png('code data text', 'filename.png', QR_ECLEVEL_L, 4, 2);
核心參數:$level (L/M/Q/H 容錯率)、$size (模組像素)、$margin (靜區寬度)。
適用場景:高並發、大批量生成。需編譯安裝 php-qrencode 擴展(安裝參考)。
參考教程,現代專案較少採用。
修改 phpqrcode.php 中 QRimage::png() 方法,新增 $mergePic 參數:
public static function png($frame, $filename = false, $pixelPerPoint = 4, $outerFrame = 4, $saveandprint = FALSE, $mergePic = '')
{
$image = self::image($frame, $pixelPerPoint, $outerFrame);
if ($mergePic) {
$logo = imagecreatefromstring(file_get_contents($mergePic)); // 支援遠端 URL
$logoW = imagesx($logo);
$logoH = imagesy($logo);
// 開啟混合模式保持透明度
imagealphablending($image, true);
imagesavealpha($image, true);
imagealphablending($logo, true);
// 置中貼合,Logo 佔整體 20%~25% 為宜
$qrW = imagesx($image);
$qrH = imagesy($image);
$destX = ($qrW - $logoW) / 2;
$destY = ($qrH - $logoH) / 2;
imagecopy($image, $logo, $destX, $destY, 0, 0, $logoW, $logoH);
imagedestroy($logo);
}
// 輸出/儲存邏輯保持不變...
}
注意:Logo 面積過大會降低容錯率導致掃描失敗,建議容錯等級設為 H (30%) 並控制 Logo 佔比 < 20%。
mb_convert_encoding($data, 'UTF-8', 'auto') 統一編碼。QRcode::png($data, $file, QR_ECLEVEL_H, 4, 2, false, 0x04)(最後參數為 ECI 指示 UTF-8,視庫版本而定)。綜合考慮維護性、效能與相容性,PHP QR Code 庫為首選;極高併發場景可評估 libqrencode 擴展。