PHP生成二维码_使用endroid/qr-code库生成二维码【解答】-php教程-PHP中文网

应选用 endroid/qr-code v3.5.2 版本，因其稳定、兼容 PHP 7.2+、API 简单；v4+ 移除 save() 和 get() 方法，需手动配置渲染器、处理二进制输出及中文编码问题。

php生成二维码_使用endroid/qr-code库生成二维码【解答】

直接用 endroid/qr-code 生成二维码没问题，但 v4+ 版本移除了内置响应输出和文件保存的快捷方法，不注意会卡在“生成了但看不到图”或“报错找不到 save()”。

v4.x（当前默认）要求 PHP ≥ 8.0，且不再自带 imagick 或 gd 的自动 fallback。如果服务器只有 GD 扩展，又没显式配置渲染器，会抛出 UnsupportedRendererException。

推荐直接装 v3.5.2（稳定、PHP 7.2+ 兼容、API 简单）：composer require endroid/qr-code:^3.5
若坚持用 v4+，需额外装渲染器，例如：composer require endroid/qr-code endroid/qrcode-bundle（仅 Symfony）或手动引入 endroid/qr-code-renderer-gd
检查 GD 是否启用：php -m | grep gd；若无，需开启 extension=gd 并重启 PHP

v3 中 get() 返回 PNG 二进制数据，v4 中改用 render()，且返回值类型变了——它返回的是 string（原始 PNG 数据），不是 Response 对象，更不是可直接输出的 HTML 标签。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

正确输出到浏览器：

header('Content-Type: image/png');
echo $qrCode->render();

保存为文件（v3/v4 均可用）：$qrCode->writeFile('qrcode.png'); —— 注意路径需有写权限
嵌入 HTML 的常见错误：直接 <img src="<?php%20echo%20%24qrCode->render();%20?>"> 会失败，因为 render() 返回的是二进制，不是 base64 或 URL；应先存文件或用 data URI：data:image/png;base64,<?php echo base64_encode($qrCode->render()); ?>

endroid/qr-code 底层调用的是 QR code 标准编码（ISO-8859-1），直接传中文字符串会导致解码失败或显示方块。它不自动转码，也不检测字符集。

安全做法：用 urlencode() 包裹中文内容，再生成：QrCode::create(urlencode('你好世界'))，扫码后需前端 decodeURIComponent()
更通用方案：改用 BYTE 模式并手动指定 ECI（Extended Channel Interpretation），但 v3 不支持，v4 需配合 setEncoding('UTF-8')（仅部分渲染器生效，GD 不支持）
简单绕过：把中文转成短链接再编码，避免编码问题本身

最易被忽略的是：v4 默认不带 writeFile() 方法，很多人照着旧文档写会报 Call to undefined method；而 v3 的 get() 在 v4 已废弃。版本混用是第一大坑。