ThinkPHP二维码生成_Qrcode类库动态生成与保存【教程】-ThinkPHP-PHP中文网

qrcode::png() 报“常量已定义”错误主因是循环中重复加载 qrlib.php 导致常量重复定义；应全局只加载一次，推荐用 dh2y/think-qrcode 扩展，注意路径为绝对路径、容错级别传字符串、提前创建目录并确保权限，颜色需传 16 进制整数。

thinkphp二维码生成_qrcode类库动态生成与保存【教程】

QRcode::png() 是 ThinkPHP 项目中生成二维码最常用的入口，但直接调用它容易出错——比如白屏、报错 Constant QR_MODE_NUL already defined，或生成的图片颜色反了、尺寸不对、保存失败。核心问题不在 ThinkPHP，而在你如何加载和复用 QRcode 类。

为什么 `QRcode::png()` 会报“常量已定义”？

这个错误几乎只发生在批量生成场景（比如循环写入多个二维码文件）中。根本原因是：每次 new 或 require 一次 phpqrcode 的主文件（如 qrlib.php），它都会尝试 define 一遍所有 QR_* 常量。如果在循环里反复 include 或重复加载类文件，就会触发 PHP 的“不能重复定义常量”限制。

错误写法：foreach ($list as $item) { include 'qrlib.php'; QRcode::png(...); }
正确做法：确保 qrlib.php 全局只加载一次；用 Composer 方式引入（如 dh2y/think-qrcode）可自动规避此问题
若必须手动引入，把 include 或 vendor() 放到控制器构造函数或公共方法顶部，绝不要塞进循环体

`dh2y/think-qrcode` 在 ThinkPHP 6 中的可靠用法

这是目前 TP6 生态中最轻量、最稳定的选择，不依赖全局常量，且封装了路径自动处理逻辑。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

安装命令：composer require dh2y/think-qrcode，完成后 vendor/dh2y/qrcode 目录即就位
生成并保存文件时，$src 必须是绝对路径（不是相对路径或 URL），例如：runtime/qrcode/123.png 要补全为 app()->getRuntimePath() . 'qrcode/123.png'
容错级别参数传字符串更安全：'L'、'M'、'Q'、'H'，而不是 QR_ECLEVEL_L 这类常量（后者需额外引入定义）
注意：该库的 png() 方法第 4 个参数是 $margin（白边），不是 $size；$size 是第 3 个参数

保存二维码失败的三个常见原因

生成后 file_exists($src) 返回 false，并不等于 png() 出错了——它可能已经写入，只是路径不可写或目录不存在。

目标目录未创建：mkdir(dirname($src), 0755, true) 必须在 png() 调用前执行
路径权限不足：Linux 下检查 www-data 或 nginx 用户是否对 runtime 目录有写权限；Windows 下留意杀毒软件拦截
输出被提前发送：如果在 png() 前已有 echo、var_dump 或 BOM 字符，会导致图像头部污染，保存看似成功但实际是空文件

自定义颜色与 logo 的硬约束

原生 phpqrcode 的 png() 不支持 logo 合成，只能靠后期用 GD 手动叠加。但颜色控制是可行的，前提是传对格式：

背景色和前景色必须是 16 进制整数，如 0xFFFFFF（白）、0x000000（黑），不能写成 '#ffffff' 或 'white'
若传错格式（比如字符串），png() 会静默失败，返回空白 PNG，且无任何 warning
想加 logo？得自己用 imagecreatefrompng() + imagecopyresized() 拼接，注意 logo 尺寸别超过二维码主体的 30%，否则扫码率暴跌

真正卡住人的从来不是“怎么生成”，而是“为什么生成了却看不到”“为什么批量就崩”“为什么颜色不对还查不出错”。这些细节没对齐，再多的 QRcode::png() 调用也只会产出一堆无法落地的 PNG 文件。