<?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 請求增加頁面加載時間、無法做二次處理 (水印、裁剪)
<?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;
<?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="頭像">
q1.qlogo.cn、q2.qlogo.cn、q3.qlogo.cn 為多節點,可隨機輪詢s:40、100、140、640,超出範圍返回默認大小簡單項目用方案一直鏈最省事;用戶系統用方案二代理+本地緩存平衡隱私與性能;需要統一風格 (圓角、邊框、水印) 用方案三 GD 處理。無論哪種,**本地緩存 7-30 天是硬性要求**,既保護用戶隱私又減少外部依賴風險。