最稳妥的通用二维码方案是 endroid/qr-code，需按 PHP 版本选 ^4.0（PHP 8.1+）或 ^3.9（PHP 7.4），用 QrCode 类 writeFile 写入绝对路径；小程序码须调用微信 getWXACodeUnlimit，access_token 必须全局缓存并加锁防并发刷新；EasyWeChat v6+ 推荐用 app_code->get() 并显式设 width≥600、auto_color=true；加水印请用 yii\imagine\Image，避免手写 GD，且二维码尺寸勿低于 400px。
用 endroid/qr-code 生成普通二维码，别碰 phpqrcode
Yii 项目里最稳妥的通用二维码方案是 endroid/qr-code，不是老掉牙的 phpqrcode。后者依赖 GD 扩展、不支持 PSR 标准、没 Composer 自动加载，容易在 PHP 8+ 环境下报 Deprecated: iconv_set_encoding() 或直接白屏。
正确做法是：
- 执行
composer require endroid/qr-code:^4.0（注意：^4.0 支持 PHP 8.1+；若用 PHP 7.4，请锁死^3.9） - 生成时用
Endroid\QrCode\QrCode类，不需手动引入或改命名空间 - 输出 PNG 最简写法：
$qrCode = new QrCode('https://example.com?uid=123');<br>$qrCode->writeFile(\Yii::getAlias('@webroot/qrcodes/test.png')); - 注意路径必须是绝对物理路径，
@webroot要提前 resolve，不能传@web/qrcodes/...
调用微信 getWXACodeUnlimit 接口前，先确认 access_token 缓存策略
小程序「无限量」码必须走微信官方 getWXACodeUnlimit 接口，它不返回图片流，而是二进制内容，且强依赖有效的 access_token。很多人卡在这一步，不是接口调不通，而是 token 过期了还在硬用。
关键点：
-
access_token有效期 2 小时，必须全局缓存（Redis / 文件 / APCu），不能每次请求都重取 - 不要在控制器里写
file_get_contents("https://api.weixin.qq.com/cgi-bin/token?...")，没做并发保护会重复刷新导致 token 被覆盖 - 建议封装成独立服务类，比如
WxAccessTokenService，用flock或 Redis SETNX 做刷新互斥 - 调用
getWXACodeUnlimit时，scene参数最大 32 字符，只允许数字、大小写字母、!、.、_、=，中文和空格会触发invalid scene错误
用 EasyWeChat 的 app_code->get() 生成小程序码，别漏掉 width 和 auto_color
如果你已接入 EasyWeChat（推荐 v6+），直接用 $miniProgram->app_code->get() 是最省事的路径，但它默认生成 430×430 黑白码，实际业务中常被吐槽“太小”或“颜色丑”。
必须显式控制的参数：
-
width：设为600或800更适合扫码场景，低于 300 在部分安卓机上识别率骤降 -
auto_color：设为true启用自适应主色，否则默认黑底白图，在深色 UI 里几乎看不见 -
line_color（v6.6+）：若要固定颜色，传['r' => 79, 'g' => 139, 'b' => 199]这种数组，不是十六进制字符串 - 返回值是
StreamResponse对象，保存时务必检查类型：if ($response instanceof \EasyWeChat\Kernel\Http\StreamResponse)，否则生产环境出错静默失败
生成后加水印或拼接头像？用 yii\imagine\Image 别手写 GD
业务要求小程序码带用户头像缩略图或品牌 Logo，千万别自己用 imagecreatefrompng() + imagecopy() 拼图——容易崩内存、不支持透明通道、无法自动适配尺寸。
Yii2 官方推荐的 yii\imagine\Image（基于 Imagine 库）更稳：
- 先用
Image::getImagine()->open($qrcodePath)加载码图 - 用
thumbnail('inset', 200, 200)缩放头像，再paste()到右下角，指定坐标避免遮挡关键信息 - 保存时加
['quality' => 95]，别用 100（文件体积翻倍，扫码无增益） - 注意：如果头像来自 URL，先
file_get_contents下来再 open，Image::getImagine()->open()不支持远程 URL
真正容易被忽略的是容错率与尺寸组合——getWXACodeUnlimit 返回的码本身容错等级固定（L 级），再叠加水印压缩，一旦把宽高压到 300px 以下，线下扫码成功率可能跌到 60%。留足 400px 以上安全边距，比调参重要得多。
