萬盛學電腦網

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

PHP QR Code 庫生成固定尺寸 QR Code 完整教學:修改 qrimage.php 實現自訂寬高

專案背景

PHP QR Code (LGPL) 是純 PHP 實作的 QR Code 產生器,基於 `libqrencode`,支援 1-40 版本、數字/英數/8-bit/漢字模式、PNG/JPEG 輸出、TCPDF 整合。專案網址:SourceForge。

痛點:原版無固定輸出尺寸參數

預設輸出尺寸 = `模組寬度 × pixelPerPoint`,隨內容長度/版本變化。若需固定 500×500px 輸出 (列印/設計稿需求),原版 API 無直接參數。

解決方案:Patch qrimage.php 繼承類別

原始碼修改 (Diff 格式)

--- original/phpqrcode/qrimage.php  2010-08-18
+++ qrimage.php  2012-07-13
@@ -86,10 +86,15 @@
 
-    $target_image = ImageCreate($imgW * $pixelPerPoint, $imgH * $pixelPerPoint);
-    ImageCopyResized($target_image, $base_image, 0, 0, 0, 0,
-                     $imgW * $pixelPerPoint, $imgH * $pixelPerPoint, $imgW, $imgH);
+
+    $targetW = (defined('IMAGE_WIDTH')  ? IMAGE_WIDTH  : $imgW * $pixelPerPoint);
+    $targetH = (defined('IMAGE_HEIGHT') ? IMAGE_HEIGHT : $imgH * $pixelPerPoint);
+
+    $target_image = ImageCreate($targetW, $targetH);
+    ImageCopyResized($target_image, $base_image, 0, 0, 0, 0,
+                     $targetW, $targetH, $imgW, $imgH);
     ImageDestroy($base_image);
     return $target_image;
 }
+

使用方式

<?php
require_once 'phpqrcode/qrlib.php';

// 定義常數 (在 include qrlib.php 之前或同一腳本頂端)
define('IMAGE_WIDTH',  500);
define('IMAGE_HEIGHT', 500);

// 產生固定 500x500 QR Code
QRcode::png('https://www.example.com/');

替代方案:不改庫原始碼,用 GD 縮放

<?php
require_once 'phpqrcode/qrlib.php';

// 1. 產生暫存檔或記憶體字串
$tmpFile = tempnam(sys_get_temp_dir(), 'qr_');
QRcode::png('https://www.example.com/', $tmpFile, QR_ECLEVEL_L, 4, 2); // 版本自動、模組 4px

// 2. GD 縮放至固定尺寸
$src = imagecreatefrompng($tmpFile);
$dst = imagescale($src, 500, 500, IMG_BICUBIC); // PHP 5.5+

// 3. 輸出
header('Content-Type: image/png');
imagepng($dst);
imagedestroy($src);
imagedestroy($dst);
unlink($tmpFile);

優點:不動庫原始碼、Composer 更新無痛。缺點:雙重編碼/解碼、略增 CPU/記憶體。

現代化替代:BaconQrCode / Endroid QrCode

套件安裝固定尺寸支援特色
bacon/bacon-qr-code`composer require bacon/bacon-qr-code``Writer::write($qrCode, $size = 500)`純 PHP、無 GD 相依 (可選)、PSR-4、積極維護
endroid/qr-code`composer require endroid/qr-code``QrCode::create($data)->setSize(500)`功能豐富 (Logo、標籤、顏色、邊距)、Symfony/Laravel 整合

總結

舊專案維護 PHP QR Code 時,Patch `qrimage.php` 定義 `IMAGE_WIDTH/HEIGHT` 常數即可快速達成固定尺寸。新專案**強烈建議改用 BaconQrCode 或 Endroid QrCode**,獲得更好維護性、型別安全、現代功能 (Logo、錯誤修正等級控制、SVG 輸出)。

copyright © 萬盛學電腦網 all rights reserved