ThinkPHP 5.0.21 引入二维码生成库 phpqrcode 使用方法-ThinkPHP-PHP中文网

class not found 是因 phpqrcode.php 为纯函数库，无命名空间与类定义，不兼容 thinkphp 5.0.21 的 psr-4 自动加载；需用 require_once 显式引入并调用函数式接口（如 qrcode()），而非 qrcode::png()。

thinkphp 5.0.21 引入二维码生成库 phpqrcode 使用方法

为什么直接 require `phpqrcode.php` 会报错 Class not found

ThinkPHP 5.0.21 默认使用 PSR-4 自动加载，而原版 phpqrcode 是纯函数库，没有命名空间、没有类定义、也没有 __autoload 或 require_once 依赖管理。直接 require 后调用 QRcode::png() 必然失败——因为根本不存在 QRcode 这个类。

实操建议：

btpanel phpsite 宝塔面板PHP网站

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

下载

不要把 phpqrcode.php 放进 app/ 或 extend/ 下指望自动加载
改用 include_once 或 require_once 显式引入，并确认路径正确（推荐放在 public/static/qrcode/ 或 vendor/ 下）
引入后只能调用函数式接口，例如 QRcode::png() 不可用，但 qrCode() 函数可用（取决于你用的是哪个分支版本）

如何在控制器里安全生成二维码图片并返回 HTTP 响应

TP5 的响应类不支持直接输出二进制图像流，硬写 header("Content-type: image/png") + echo $data 容易被框架的输出缓冲干扰，导致图片损坏或空白。

实操建议：

先用 QRcode::png()（如果类存在）或 QRcode::text() + ob_get_contents() 捕获输出，再用 TP5 的 response() 包装
更稳妥的做法：生成临时文件，再用 return response()->file($filepath)
务必设置 ob_end_clean() 清除前置输出，避免 BOM 或空格污染 PNG 流

示例关键代码：

ob_start();
QRcode::png('https://example.com', false, QR_ECLEVEL_L, 4, 2);
$imageData = ob_get_contents();
ob_end_clean();
return response($imageData)->contentType('image/png');

`QR_ECLEVEL_L` 等常量未定义怎么办

原版 phpqrcode 把常量定义在 qrconst.php 中，但很多精简版包（比如某些 Composer 版本）漏掉了这个文件，导致 QR_ECLEVEL_L、QR_FORMAT_PNG 等直接报错 undefined constant。

实操建议：

检查是否完整引入了 qrconst.php 和 qrtools.php，缺一不可
若用的是 GitHub 上的 phpqrcode/phpqrcode Composer 包（非官方），它已重写为命名空间类，应改用 endroid\qr-code 替代
临时补救：手动定义缺失常量，例如 defined('QR_ECLEVEL_L') || define('QR_ECLEVEL_L', 0);
注意：不同版本的容错等级数值可能不同，QR_ECLEVEL_H 在老版中是 3，新版可能是 2 —— 查源码比硬记更可靠