萬盛學電腦網

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

PHP 生成二維碼中文亂碼根因分析與多種實作方案

亂碼問題根因探討

作者遇到 Android 掃描 vCard 格式二維碼時中文姓名亂碼,發現缺少 ORG 欄位內容時發生,補上固定字串後恢復正常。這暗示:

  • 編碼模式判斷邏輯可能依賴特定欄位長度或內容特徵
  • 部分掃描器在特定模式下預設非 UTF-8 解碼(如 Shift_JIS、GBK)
  • QR Code 規範建議使用 UTF-8,但實際相容性取決於編碼器與掃描器實作

根治方向:明確指定編碼模式為 UTF-8、確保資料前置 BOM 或使用 ECI 模式指示字符集、驗證生成庫是否支援 QR_MODE_8 (Byte mode) 並正確處理多位元組字符。

四大主流生成方案對比

1. Google Chart API(已停止維護,不建議新專案使用)

<?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,僅供歷史參考。

2. PHP QR Code 庫(純 PHP、零依賴、最推薦)

專案地址: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 (靜區寬度)。

3. libqrencode C 庫 + PHP 擴展(效能最佳)

適用場景:高並發、大批量生成。需編譯安裝 php-qrencode 擴展(安裝參考)。

4. QRcode Perl CGI / PHP 腳本(較老舊)

參考教程,現代專案較少採用。

進階技巧:二維碼中心嵌入 Logo

修改 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%。

中文編碼最佳實踐

  1. 確保 PHP 檔案以 UTF-8 無 BOM 編碼儲存。
  2. 輸入資料預先 mb_convert_encoding($data, 'UTF-8', 'auto') 統一編碼。
  3. 生成時明確使用 Byte 模式:QRcode::png($data, $file, QR_ECLEVEL_H, 4, 2, false, 0x04)(最後參數為 ECI 指示 UTF-8,視庫版本而定)。
  4. 測試多款掃描器(微信、支付寶、iOS 相機、Google Lens)驗證相容性。

綜合考慮維護性、效能與相容性,PHP QR Code 庫為首選;極高併發場景可評估 libqrencode 擴展。

copyright © 萬盛學電腦網 all rights reserved