[TOC] #### 1. 前言 --- packagist 傳送門: [https://packagist.org/packages/endroid/qr-code](https://packagist.org/packages/endroid/qr-code) 使用該擴展前，先確認其 PHP 版本要求，endroid/qr-code 4.x 需要 PHP 版本 7.4+ 使用前需要檢查下是否啟用了 gd2 擴展，對于 endroid/qr-code 版本選擇，參考擴展包文檔對 PHP 版本的要求 #### 2. 安裝擴展 --- 執行 composer 命令安裝 endroid/qr-code 擴展 ``` composer require endroid/qr-code ``` 會生成如下目錄結構內容 ``` ├─vendor │ ├─autoload.php │ ├─ ... ├─composer.json ├─composer.lock ``` 如果當前項目架構沒有基于任何框架，只需要引入 composer 的自動加載文件即可 如果當前項目是基于 ThinkPHP，Laravel 等主流框架，這些框架都支持 composer，執行安裝擴展包命令后可以直接使用 ``` require 'vendor/autoload.php'; ``` #### 3. 生成二維碼 --- **使用 Builder 生成器:** ```php use Endroid\QrCode\Builder\Builder; use Endroid\QrCode\Encoding\Encoding; use Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelHigh; use Endroid\QrCode\Label\Alignment\LabelAlignmentCenter; use Endroid\QrCode\Label\Font\NotoSans; use Endroid\QrCode\RoundBlockSizeMode\RoundBlockSizeModeMargin; use Endroid\QrCode\Writer\PngWriter; $result = Builder::create() ->writer(new PngWriter()) ->writerOptions([]) // 二維碼文本 ->data('http://www.g-eproperties.com') // 內容編碼 ->encoding(new Encoding('UTF-8')) // 容錯等級(越高二維碼越密集) ->errorCorrectionLevel(new ErrorCorrectionLevelHigh()) // 二維碼內容區域大小 ->size(300) // 二維碼內容外邊距大小 ->margin(10) // 二維碼內容圓形塊尺寸模型 ->roundBlockSizeMode(new RoundBlockSizeModeMargin()) // 二維碼中間區域logo圖片 ->logoPath(__DIR__ . '/3.png') ->logoResizeToWidth(100) ->logoResizeToHeight(100) // 二維碼下方文字 ->labelText('長按識別二維碼') ->labelFont(new NotoSans(20)) ->labelAlignment(new LabelAlignmentCenter()) // 驗證讀取器(默認情況下禁用) ->validateResult(false) // 執行生成器 ->build(); ``` **不使用 Builder 生成器:** ```php use Endroid\QrCode\Color\Color; use Endroid\QrCode\Encoding\Encoding; use Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelLow; use Endroid\QrCode\QrCode; use Endroid\QrCode\Label\Label; use Endroid\QrCode\Logo\Logo; use Endroid\QrCode\RoundBlockSizeMode\RoundBlockSizeModeMargin; use Endroid\QrCode\Writer\PngWriter; $writer = new PngWriter(); $qrCode = QrCode::create('http://www.g-eproperties.com') // 內容編碼 ->setEncoding(new Encoding('UTF-8')) // 容錯等級 ->setErrorCorrectionLevel(new ErrorCorrectionLevelLow()) // 內容區域大小 ->setSize(300) // 內容區域外邊距 ->setMargin(10) // 內容圓形塊尺寸模型 ->setRoundBlockSizeMode(new RoundBlockSizeModeMargin()) // 內容顏色 ->setForegroundColor(new Color(0, 0, 0)) // 背景顏色 ->setBackgroundColor(new Color(255, 255, 255)); // 二維碼logo logo $logo = Logo::create(__DIR__ . '/3.png') ->setResizeToWidth(50); // 二維碼下方文字 label $label = Label::create('Label') ->setTextColor(new Color(255, 0, 0)); // 生成二維碼數據對象(后面兩個參數都是可選的) $result = $writer->write($qrCode, $logo, $label); ``` **實際開發中，使用最多的是根據一串普通文本生成字符串，所以我將代碼做了簡化，方便以后快速使用** ```php use Endroid\QrCode\QrCode; use Endroid\QrCode\Writer\PngWriter; use Endroid\QrCode\Encoding\Encoding; $qrCode = QrCode::create('http://www.g-eproperties.com') // 內容編碼 ->setEncoding(new Encoding('UTF-8')) // 內容區域大小 ->setSize(200) // 內容區域外邊距 ->setMargin(10); // 生成二維碼數據對象 $result = (new PngWriter)->write($qrCode); ``` #### 4. 輸出二維碼 --- 以下是三種輸出二維碼的方式，根據項目場景選擇合適的方式即可 ```php // 直接輸出在瀏覽器中 // ob_end_clean(); //處理在TP框架中顯示亂碼問題 // header('Content-Type: ' . $result->getMimeType()); // echo $result->getString(); // 將二維碼圖片保存到本地服務器 // $result->saveToFile(__DIR__ . '/qrcode.png'); // 返回 base64 格式的圖片 $dataUri = $result->getDataUri(); echo "<img src='{$dataUri}'>"; ```