萬盛學電腦網

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

PHP 微信開發:二維碼生成類別完整實作

微信公眾平台提供建立永久/臨時二維碼 API,本文封裝完整 Weixin 類別,涵蓋 Access Token 獲取、二維碼 Ticket 換取、圖片下載儲存、錯誤日誌記錄,可直接用於專案。

類別架構概覽

namespace Home\Common;

class Weixin {
    static $qrcode_url  = "https://api.weixin.qq.com/cgi-bin/qrcode/create?";
    static $token_url   = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&";
    static $qrcode_get_url = "https://mp.weixin.qq.com/cgi-bin/showqrcode?";

    // 公開方法:生成二維碼並下載儲存
    public function getEwm($wechatid, $fqid, $type = 1) { ... }

    // 內部方法:組裝請求、HTTP POST、下載圖片、錯誤日誌
    protected function getQrcodeurl($access_token, $fqid, $type) { ... }
    protected function getToken($appid, $secret) { ... }
    protected function http_post_data($url, $data_string) { ... }
    protected function DownLoadQr($url, $filestring) { ... }
    private function ErrorLogger($errMsg) { ... }
}

關鍵流程解析

  1. 獲取 Access Token:以 AppID + Secret 請求 /cgi-bin/token,快取 7200 秒(建議加入快取層)。
  2. 建立二維碼 Ticket:
    • 永久碼(QR_LIMIT_SCENE):scene_id 為數字 ID,數量限制較少。
    • 臨時碼(QR_SCENE):expire_seconds 最大 2592000(30天),數量無限制。
  3. 換取二維碼圖片:以 Ticket 請求 showqrcode,直接下載二進位圖片儲存至 ./Uploads/qrcode/。
  4. 錯誤處理:cURL 錯誤、API 回傳錯誤碼均寫入 ErrorLog.txt。

使用範例

$weixin = new \Home\Common\Weixin();
// 生成永久二維碼,scene_id = 12345
$qrPath = $weixin->getEwm($wechatId = 1, $fqid = 12345, $type = 1);
echo "二維碼已儲存至:$qrPath";

生產環境優化建議

  • Access Token 集中快取:使用 Redis/Memcached 共享,避免重複請求觸發頻率限制。
  • 異步下載:將圖片下載放入佇列(Redis List、RabbitMQ)由 Worker 處理,提升回應速度。
  • CDN 分發:生成的二維碼圖片上傳至 CDN,回傳 CDN 網址而非本地路徑。
  • 參數驗證:嚴格檢查 $wechatid、$fqid 合法性,防止注入攻擊。
  • 例外處理:拋出自訂例外而非 exit(),讓上層統一處理 HTTP 回應。

此類別提供開箱即用的微信二維碼生成功能,配合上述優化可滿足高併發生產需求。

copyright © 萬盛學電腦網 all rights reserved