ThinkPHP+phpqrcode怎么生成二維碼

# ThinkPHP+phpqrcode怎么生成二維碼

二維碼在現代Web開發中應用廣泛，從支付鏈接到信息分享都離不開它。本文將詳細介紹如何在ThinkPHP框架中集成phpqrcode庫實現二維碼生成功能。

## 一、環境準備

### 1. 基礎環境要求
- PHP 5.6+ 環境（建議7.4+）
- ThinkPHP 5.x/6.x 框架
- 已安裝Composer依賴管理工具

### 2. 安裝phpqrcode庫
通過Composer安裝最新穩定版：
```bash
composer require endroid/qr-code

或下載傳統phpqrcode類庫（適用于無Composer環境）：

// 手動下載地址：https://sourceforge.net/projects/phpqrcode/

二、兩種集成方式詳解

方法1：使用Composer安裝的endroid/qr-code

1. 創建二維碼生成服務

在app/service目錄下創建QrCodeService.php：

<?php
namespace app\service;

use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;

class QrCodeService
{
    public static function generate($content, $size = 200)
    {
        $qrCode = new QrCode($content);
        $qrCode->setSize($size);
        
        $writer = new PngWriter();
        return $writer->write($qrCode)->getString();
    }
}

2. 控制器調用示例

public function createQrcode()
{
    $content = 'https://example.com'; // 二維碼內容
    $qrImage = QrCodeService::generate($content);
    
    // 直接輸出到瀏覽器
    header('Content-Type: image/png');
    echo $qrImage;
    exit;
}

方法2：使用傳統phpqrcode類庫

1. 部署類庫文件

將下載的phpqrcode.php文件放入：

extend/phpqrcode/phpqrcode.php

2. 創建助手函數

在app/helper.php中添加：

function generate_qrcode($text, $outfile = false, $level = 'L', $size = 6, $margin = 2)
{
    require_once '../extend/phpqrcode/phpqrcode.php';
    return QRcode::png($text, $outfile, $level, $size, $margin);
}

3. 控制器中使用

public function share()
{
    $url = url('product/detail', ['id'=>100], true, true);
    
    // 保存到本地
    $savePath = 'public/uploads/qrcodes/'.date('Ym').'/';
    if(!is_dir($savePath)){
        mkdir($savePath, 0755, true);
    }
    $filename = md5($url).'.png';
    generate_qrcode($url, $savePath.$filename);
    
    return json([
        'qrcode_url' => '/'.str_replace('public/','',$savePath).$filename
    ]);
}

三、高級功能實現

1. 帶LOGO的二維碼

public function generateWithLogo($content, $logoPath)
{
    $qrCode = new QrCode($content);
    $qrCode->setLogoPath($logoPath);
    $qrCode->setLogoSize(80, 80);
    
    return (new PngWriter())->write($qrCode);
}

2. 自定義顏色樣式

$qrCode->setForegroundColor(['r' => 0, 'g' => 0, 'b' => 0, 'a' => 0]);
$qrCode->setBackgroundColor(['r' => 255, 'g' => 255, 'b' => 255, 'a' => 0]);

3. 響應式輸出（瀏覽器/下載）

public function output($content, $download = false)
{
    $qrCode = /* 生成代碼 */;
    
    header('Content-Type: '.$qrCode->getContentType());
    if($download){
        header('Content-Disposition: attachment; filename="qrcode.png"');
    }
    echo $qrCode->writeString();
    exit;
}

四、常見問題解決方案

1. 亂碼問題處理

// 轉換中文內容
$content = mb_convert_encoding($text, "UTF-8");

2. 路徑權限問題

// 自動創建目錄
if (!file_exists($savePath)) {
    mkdir($savePath, 0744, true);
}

3. 性能優化建議

• 對相同內容二維碼進行緩存
• 使用ob_start()進行輸出緩沖
• 調整糾錯級別（L/M/Q/H）

五、實際應用場景

1. 用戶名片分享

   $userInfo = [
      'name' => $this->user->name,
      'mobile' => substr_replace($this->user->mobile, '****', 3, 4)
   ];
   generate_qrcode(json_encode($userInfo));
   

2. 支付二維碼生成

   $paymentUrl = PaymentService::createWechatPayUrl($orderId);
   $this->output($paymentUrl);
   

3. 設備綁定二維碼

   $deviceCode = EncryptionService::encrypt($deviceId);
   return view('bind', ['qrcode' => base64_encode(generate_qrcode($deviceCode))]);
   

結語

通過本文介紹的兩種方法，開發者可以靈活選擇適合自己項目的二維碼生成方案。ThinkPHP的優雅架構配合phpqrcode的強大功能，能夠滿足絕大多數業務場景需求。建議在實際開發中： 1. 對高頻訪問的二維碼做文件緩存 2. 重要二維碼添加失效時間控制 3. 敏感內容應先加密再生成二維碼 “`