ThinkPHP6需引入第三方库生成二维码：选simplesoftwareio/simple-qrcode可快速实现基础功能，而endroid/qr-code支持带Logo、调色等高级定制；关键在正确安装、配置服务提供者与门面、确保GD扩展启用，并规范URL生成与文件写入路径。
用 simplesoftwareio/simple-qrcode 在 TP6 中快速跑通
这个包轻量、API 简单，适合只要基础二维码的场景，且对 TP6 的 PHP 7.4+ 兼容稳定。
常见错误现象：Class 'QrCode' not found 或 Call to undefined method QrCode::size()
- 执行
composer require simplesoftwareio/simple-qrcode:^4.2（别写qrcode——没这个包） - 手动在
config/app.php的providers数组末尾加一行：SimpleSoftwareIO\QrCode\QrCodeServiceProvider::class - 同样在
config/app.php的aliases里加：'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class - TP6.3+ 若启用了门面自动发现，可跳过 alias 配置，但 provider 仍需手动加
用 endroid/qr-code 实现带 Logo 和调色的定制二维码
需要加图标、改前景色、设边距、输出 PNG 流——endroid/qr-code 是更可控的选择，但版本和环境要求更严。
常见错误现象：Your requirements could not be resolved、Call to undefined function imagecreatefromstring()、Logo 模糊或边缘发灰
立即学习“PHP免费学习笔记（深入）”；
- TP6 + PHP 7.4：用
composer require endroid/qr-code:^3.9；PHP 8.0+ 才能用 ^4.x - 确认 GD 扩展已启用：
php -m | grep gd，Windows 用户检查php.ini中extension=gd是否取消注释 - 加 Logo 前必须设足够 margin：
$qr->setMargin(40)，否则 Logo 会压到纠错区导致扫码失败 - Logo 文件要用
file_get_contents($logoPath)读取后传入setLogo()，别直接传路径 - 前景色避开缩写如
#333，用#000000或#ffffff，否则 Alpha 通道混色会导致边缘泛灰
生成含参数的动态链接二维码（如用户专属页）
二维码内容本质是字符串，重点不在“画图”，而在“拼出安全、可路由、可部署的 URL”。
常见错误现象：扫码跳转 404、参数丢失、中文乱码、部署子目录后路径错位
- 永远用
url('route_name', ['id' => $uid, 'token' => $token])生成地址，不要手拼/user/profile?id=... - 若项目部署在子目录（如
https://a.com/app/），提前在app.url配置完整域名前缀，否则url()返回相对路径 -
url()已自动urlencode，无需再套一层urlencode()，否则空格变%2520 - 敏感参数（如
session_id、数据库字段值）禁止直塞进二维码 URL；应走后端映射（例如用短链 ID 查用户）
保存二维码到文件而非实时输出
海报、订单、推广页等场景需要复用，每次请求都生成 PNG 流既慢又浪费资源。
常见错误现象：图片无法访问、权限拒绝、并发写入冲突、路径 404
- 写入路径必须在 Web 可访问目录下，推荐：
public/static/qrcode/ - 用
public_path() . '/static/qrcode/' . $filename拼路径，别用ROOT_PATH或硬编码绝对路径 - 文件名建议含内容哈希：
$filename = 'qrcode_' . md5($content) . '.png'，避免重复生成 - 写入前确保目录存在且有写权限：
is_dir($dir) || mkdir($dir, 0755, true) - 高并发场景下，
md5($content . time())比纯md5($content)更防覆盖，但需配合清理逻辑
