萬盛學電腦網

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

PHP 獲取並顯示 QQ 頭像:兩種方案對比與最佳實踐

方案一:直接輸出圖片 URL (最簡單、支持動圖)

<?php
$qq = '123456789';
// s=100: 100px 尺寸 (可選 40/100/140/640)
// t=時間戳: 防緩存
echo '<img src="https://q1.qlogo.cn/g?b=qq&nk=' . $qq . '&s=100&t=' . time() . '" alt="QQ頭像">';

優點:代碼極簡、支持動態 GIF 頭像、無服務器帶寬壓力 (直連騰訊 CDN)

缺點:依賴外部服務可用性、HTTP 請求增加頁面加載時間、無法做二次處理 (水印、裁剪)

方案二:服務器端代理獲取並輸出 (可控性強、隱藏 QQ 號)

<?php
$qq = '552452006';
$src = "https://q1.qlogo.cn/g?b=qq&nk={$qq}&s=100";

// 獲取圖片二進制數據
$imageData = @file_get_contents($src);
if ($imageData === false) {
    // 降級:默認頭像
    $imageData = file_get_contents(__DIR__ . '/default_avatar.png');
    header('Content-Type: image/png');
    echo $imageData;
    exit;
}

// 輸出圖片
header('Content-Type: image/png');  // 或根據實際格式動態設置
echo $imageData;

方案三:GD 處理後輸出 (支持縮放、水印、格式統一)

<?php
function getQQAvatar(string $qq, int $size = 100): string {
    $url = "https://q1.qlogo.cn/g?b=qq&nk={$qq}&s={$size}";
    $data = @file_get_contents($url);
    
    if ($data === false) {
        return __DIR__ . '/default_avatar.png';
    }
    
    // 從字符串創建 GD 資源
    $srcImg = imagecreatefromstring($data);
    if (!$srcImg) return __DIR__ . '/default_avatar.png';
    
    // 創建目標畫布 (正方形)
    $dstImg = imagecreatetruecolor($size, $size);
    
    // 保持透明度 (針對 PNG)
    imagealphablending($dstImg, false);
    imagesavealpha($dstImg, true);
    $transparent = imagecolorallocatealpha($dstImg, 0, 0, 0, 127);
    imagefill($dstImg, 0, 0, $transparent);
    
    // 等比縮放居中 (簡化:直接拉伸填滿)
    imagecopyresampled($dstImg, $srcImg, 0, 0, 0, 0, $size, $size,
        imagesx($srcImg), imagesy($srcImg));
    
    // 保存到臨時文件或直接輸出
    $tempFile = sys_get_temp_dir() . "/qq_avatar_{$qq}_{$size}.png";
    imagepng($dstImg, $tempFile);
    
    imagedestroy($srcImg);
    imagedestroy($dstImg);
    
    return $tempFile;
}

// 使用
$avatarPath = getQQAvatar('123456789', 200);
header('Content-Type: image/png');
readfile($avatarPath);

方案對比表

維度方案一: 直鏈方案二: 代理輸出方案三: GD 處理
代碼複雜度極低低中
動圖支持✓ 原生支持✓ 透傳✗ 只輸出靜態幀
隱私保護✗ 暴露 QQ 號✓ 隱藏 QQ 號✓ 隱藏 QQ 號
可用性依賴騰訊 CDN依賴騰訊 CDN可本地緩存
二次處理✗✗✓ (水印、裁剪、圓角)
服務器帶寬無消耗雙倍消耗雙倍 + CPU
緩存控制靠瀏覽器可控完全可控

生產環境最佳實踐

<?php
class QQAvatar {
    private const API_URL = 'https://q1.qlogo.cn/g';
    private const CACHE_DIR = '/var/www/cache/avatar/';
    private const CACHE_TTL = 86400 * 7; // 7天
    
    public static function getUrl(string $qq, int $size = 100): string {
        return self::API_URL . "?b=qq&nk={$qq}&s={$size}";
    }
    
    public static function getLocalPath(string $qq, int $size = 100): string {
        $file = self::CACHE_DIR . "qq_{$qq}_{$size}.png";
        
        // 緩存有效直接返回
        if (file_exists($file) && time() - filemtime($file) < self::CACHE_TTL) {
            return $file;
        }
        
        // 獲取並緩存
        $url = self::getUrl($qq, $size);
        $data = @file_get_contents($url);
        if ($data !== false) {
            @file_put_contents($file, $data);
            return $file;
        }
        
        return __DIR__ . '/default.png';
    }
}

// 模板中使用
// <img src="<?= QQAvatar::getLocalPath($user->qq, 100) ?>" alt="頭像">

注意事項

  • QQ 頭像 API 非官方公開接口,可能隨時失效或限制頻率
  • q1.qlogo.cn、q2.qlogo.cn、q3.qlogo.cn 為多節點,可隨機輪詢
  • 尺寸參數 s:40、100、140、640,超出範圍返回默認大小
  • 生產環境**必須本地緩存**,避免每次頁面加載都請求騰訊服務器
  • 遵守《用戶隱私保護規範》,不濫發、不存儲 QQ 號關聯數據

總結

簡單項目用方案一直鏈最省事;用戶系統用方案二代理+本地緩存平衡隱私與性能;需要統一風格 (圓角、邊框、水印) 用方案三 GD 處理。無論哪種,**本地緩存 7-30 天是硬性要求**,既保護用戶隱私又減少外部依賴風險。

copyright © 萬盛學電腦網 all rights reserved