QRcode::png() 不支持嵌入 Logo,因其仅输出位图流而不返回 GD 资源,且无图像叠加能力;必须改用 QRcode::text() 获取矩阵并用 GD 手动绘制与合成 Logo。

QRcode::png() 本身不支持嵌入 Logo,直接调用会生成纯二维码图像;要在 CodeIgniter 中实现带 Logo 的二维码,必须手动加载、缩放、居中绘制 Logo 图像,且需严格控制 Logo 尺寸与容错等级匹配。
为什么不能直接用 QRcode::png() 加 Logo
该函数出自第三方库 phpqrcode.php,仅封装了 ZXing 的基础编码逻辑,输出的是位图数据流,无图像叠加能力。试图在它之后用 imagecopy() 操作 PNG 资源会失败——因为 QRcode::png() 默认直接输出(header + echo),不返回 GD 资源句柄。
- 调用时若传入
$outfile参数,它会保存文件但不返回资源,后续无法imagecreatefrompng()——除非你额外加ob_start()拦截输出再解码,极不健壮 - Logo 若超过二维码容错区域(如 L 级仅容许 7% 遮挡),扫描成功率断崖式下降
- CI 的
image_lib不支持像素级矩阵操作,无法用于二维码合成
必须用 GD 手动合成:从 QRcode::png() 切换到 QRcode::text() + GD 绘制
核心思路是绕过 PNG 直出,改用 QRcode::text() 获取字符矩阵(0/1 字符串),再用 GD 创建画布、逐点绘黑块,最后叠加 Logo。这样全程可控。
-
QRcode::text($content, $errorCorrectionLevel, $matrixPointSize)返回换行分隔的 0/1 字符串,例如"010\n111\n010" - 用
imagecreatetruecolor()创建目标尺寸画布(建议 ≥ 300×300 像素) - 遍历字符串,对每个
'1'调用imagefilledrectangle()绘制一个色块(非单像素,避免模糊) - 用
imagecreatefrompng()加载 Logo,imagesx()/imagesy()获取尺寸,按比例缩放到 ≤ 二维码宽度的 25%(H 级容错建议 ≤ 30%,L 级务必 ≤ 15%) - 计算居中坐标:
$x = ($qr_width - $logo_width) / 2,$y = ($qr_height - $logo_height) / 2,再用imagecopy()合成
关键参数与容错等级的实际影响
容错等级不是“越高越好”——它直接影响可安全覆盖的 Logo 面积上限,也影响二维码密度和扫描兼容性。
-
'L'(默认):仅容许 7% 遮挡 → Logo 宽高比建议 ≤ 1:1 且面积 ≤ 10% 二维码画布 -
'M':15% 遮挡 → Logo 可放大至 20%,多数手机扫码稳定 -
'Q':25% → 可用至 25%,但部分老旧扫码器可能失败 -
'H':30% → Logo 最大可用面积,但生成矩阵更稀疏,小尺寸下易糊,务必保证输出 ≥ 400×400 像素
实际项目中,$matrixPointSize = 6 对应约 250px 宽二维码,此时选 'M' + Logo 宽 60px 是较稳妥组合。
CI 中路径与权限的硬坑
CodeIgniter 的 FCPATH 是绝对路径起点,但 phpqrcode 内部用相对路径写文件,容易因工作目录偏移导致保存失败或 404。
- 生成前必须确保目录可写:
mkdir(FCPATH . 'uploads/qrcode/', 0755, true),不能只靠is_dir()判断 - Logo 文件路径必须是服务器本地真实路径(非 URL),
imagecreatefrompng('/var/www/html/uploads/logo.png'),不能写http://... - GD 库必须启用 PNG 支持:
php -m | grep gd查看,若无png字样,需重编译 GD 或换主机环境
最易被忽略的一点:GD 绘制时未调用 imageantialias($img, false),会导致矩形边缘模糊,二维码扫描率下降 20% 以上。


















