应弃用已归档的2amigos/yii2-qrcode-helper，直接使用endroid/qr-code v5：它原生支持PHP 8.2+、PSR-17/18、可插拔Writer（如PngWriter）、明确错误纠正常量，且避免strlen(null)警告、base64嵌入破坏缓存等问题。
直接用 endroid/qr-code，别碰 2amigos/yii2-qrcode-helper —— 后者已多年未维护，PHP 8.2+ 下会报 Deprecated: strlen(): Passing null to parameter #1 ($string) of type string is deprecated 类错误，且不支持现代错误纠正级别命名、无 Writer 抽象层，调试困难。
为什么推荐 endroid/qr-code 而不是 2amigos 系列
它原生支持 PSR-17/18，Writer 可插拔（PngWriter / SvgWriter / StringWriter），错误纠正等级用常量 ErrorCorrectionLevel::HIGH 明确可读，生成带 logo 的二维码只需调 ->addLogo() 一行。而 2amigos/qrcode-library 的 Enum::QR_ECLEVEL_H 是字符串魔术值，容易拼错；其 writeDataUri() 返回 base64 字符串，强制塞进 HTML 会破坏缓存和邮件兼容性。
-
endroid/qr-codev4.x（2025 年最新稳定版）已全面适配 PHP 8.2–8.4，Composer 安装后开箱即用 -
2amigos/yii2-qrcode-helper最后一次 commit 是 2020 年，依赖的2amigos/qrcode-libraryv3.x 在 PHP 8.2 中触发大量strlen(null)和count(null)警告 - 若项目已用
2amigos，不要强行升级其子库——v4 不兼容 v3 接口，重写成本高于迁移至endroid
endroid/qr-code 在 Yii2 中的最小可行 action
不需要注册 component，不改 config/web.php，纯函数式调用更可控。重点：必须设 FORMAT_RAW + 正确 Content-Type，否则浏览器下载文件而非渲染图片。
- 在控制器中写 action：
use Endroid\QrCode\QrCode; use Endroid\QrCode\Writer\PngWriter; public function actionQr() { $text = Yii::$app->request->get('text', ''); // 强制过滤空值和控制字符 if (!$text || preg_match('/[\x00-\x08\x0B\x0C\x0E-\x1F]/', $text)) { throw new BadRequestHttpException('Invalid text'); } $qrCode = QrCode::create($text) ->setSize(300) ->setMargin(10) ->setEncoding('UTF-8'); $writer = new PngWriter(); $result = $writer->write($qrCode); Yii::$app->response->format = \yii\web\Response::FORMAT_RAW; Yii::$app->response->headers->add('Content-Type', 'image/png'); return $result->getString(); } - 视图中引用：
<img src="=%20%5Cyii%5Chelpers%5CUrl::to(['site/qr',%20'text'%20=>%20'https://example.com'])%20?>"> - 注意：URL 参数不需
urlencode()外层再套htmlspecialchars()——urlencode()已保证 URL 安全，多套反而导致解码失败
生成带 logo 的二维码时必须绕开的坑
很多人直接传 ->addLogo('logo.png')，结果报 Unable to load image: logo.png 或生成空白。根本原因是 endroid/qr-code 的 logo 路径是服务端文件系统路径，不是 Web 可访问 URL。
- 正确做法：用
__DIR__ . '/../../web/images/logo.png'这类绝对路径，或通过Yii::getAlias('@webroot/images/logo.png') - logo 图片尺寸建议 ≤ 二维码尺寸的 25%，否则遮挡关键定位点，扫码失败率陡增
- 必须调
->validateResult(false)关闭内置校验（默认开启），否则带 logo 后因像素微变触发校验失败，返回空内容 - 示例片段：
$qrCode = QrCode::create($text) ->setSize(300) ->setMargin(10) ->addLogo(Yii::getAlias('@webroot/images/logo-small.png'), [ 'size' => 60, 'padding' => 5, ]) ->validateResult(false); // 关键！
生产环境必须加的缓存头和防盗链
二维码图片是静态资源，但由 PHP 动态生成，默认无缓存，每次请求都走 PHP-FPM，QPS 上不去。更麻烦的是，微信内嵌浏览器对无 Cache-Control 的图片经常拒绝渲染。
- 在 action 末尾加：
Yii::$app->response->headers->add('Cache-Control', 'public, max-age=86400'); Yii::$app->response->headers->add('Vary', 'Accept-Encoding'); - 如需防盗链，检查
$_SERVER['HTTP_REFERER']是否在白名单域名内，不匹配则返回 403 —— 注意：部分微信客户端不带 Referer，测试时用真机扫码验证 - 避免用
file_put_contents()预生成并存盘：并发写入可能冲突，且文件清理逻辑易遗漏，不如靠 HTTP 缓存
最易被忽略的一点：所有二维码 action 必须做输入长度限制。URL 超过 2000 字符时，endroid/qr-code 不报错但生成无效码——它静默截断，扫码后跳转地址丢失参数。上线前务必用长 URL 测试边界情况。
