qrcode::png()是tp5最常用也最易出错的二维码生成入口，它不返回数据而是直接输出或写入文件；需确保$text为完整url、$outfile路径可写且存在、$level用大写字符串、$size为模块大小1–10，并注意php版本兼容性及输出缓冲干扰。
QRcode::png() 是 TP5 里最常用、也最容易出问题的二维码生成入口，它不返回图片数据，而是直接输出或写入文件。你调用后页面空白、图片不显示、路径报错，基本都卡在这一步。
别急着封装函数或加 logo，先确认基础链路通不通：
-
$text必须是完整 URL（含http://或https://），纯域名或相对路径扫出来打不开 -
$outfile路径必须可写，且目录存在；若传false，则需手动设置header('Content-Type: image/png')并exit -
$level只接受字符串'L'、'M'、'Q'、'H'，传数字或小写会静默失败 -
$size是模块大小（1–10），不是像素尺寸；想控制最终图片宽高，得靠$margin和后续缩放，别指望它直接输出 300×300
常见错误现象：Warning: Cannot modify header information —— 说明你在 QRcode::png() 前已输出过内容（比如 echo、空格、BOM）；failed to open stream: No such file or directory —— $outfile 的父目录没创建，mkdir() 没加递归参数。
TP5 中引入 phpqrcode 的两种方式怎么选
用 composer require aferrandini/phpqrcode 是最省心的，类自动注册，use \PHPQRCode\QRcode; 就能用。但注意：这个包在 PHP 8.1+ 有兼容问题，imageantialias() 已废弃，会报 Deprecated 警告（不影响生成，但日志刷屏）。
如果项目跑在 PHP 8.x，建议改用 composer require endroid/qrcode，它更现代、支持 SVG、颜色/边框/标签全可控，且无废弃函数警告。但要注意两点：
- 它的
writeString()返回的是原始二进制 PNG 数据，必须配header('Content-Type: image/png')才能直接浏览器显示 - 中文标签默认乱码，必须显式指定中文字体路径（如
public/fonts/simhei.ttf），不能只设字体大小
别图省事用 require_once 手动引 phpqrcode.php —— TP5 自动加载机制下，这种写法容易因路径错位导致类找不到，而且无法被 IDE 正确识别。
二维码内容带动态参数时 URL 怎么拼才安全
很多开发者把会员 ID 直接拼进 $text，比如 "https://xxx.com/vip?id=" . $uid，结果扫码跳转后参数丢失或乱码。根本原因是没做 URL 编码。
正确做法是：
- 所有 GET 参数值必须用
urlencode()包裹，尤其是中文、特殊符号、空格 - 整个 URL 建议再套一层
rawurlencode()（尤其当参数本身含&或=） - 避免在二维码里塞敏感信息（如 token、session_id），一旦泄露无法撤回；优先用短链服务或后端跳转中间页
示例：
$uid = 12345;
$name = '张三';
$text = 'https://xxx.com/vip?uid=' . urlencode($uid) . '&name=' . urlencode($name);
\QRcode::png($text, false, 'L', 4, 2); // 注意：false 表示不存文件，直接输出
header('Content-Type: image/png');
exit;
生成后怎么快速调试和验证
别依赖“扫一下看行不行”——网络延迟、微信缓存、手机光线都会干扰判断。真要快速验证，分三步：
- 用
file_exists($filename)+filesize($filename) > 0确认文件真实生成成功 - 把生成的 PNG 文件用
base64_encode(file_get_contents($filename))转成 Data URL，贴进 HTML<img src="data:image/png;base64,...">直接预览 - 用在线二维码解析工具（如 https://cli.im/deqr）上传生成图，看解出的 URL 是否和你传入的
$text完全一致（包括大小写、斜杠、编码）
最容易被忽略的一点：TP5 默认开启 output_buffering，而 QRcode::png() 内部用了 ob_start()。如果你在控制器里提前调用了 ob_flush() 或 ob_end_flush()，会导致二维码输出被截断，图片损坏。检查你的公共函数或中间件是否无意中操作了输出缓冲。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
