endroid/qr-code 是生成 png 二维码最稳妥的 php 第三方库，需启用 gd 扩展，调用 qrcode::create() 后必须 setsiz e、setmargin 并 writestring() 输出，中文需 urlencode 或配置 font_path，svg 输出须设 image/svg+xml 头。
用 endroid/qr-code 生成 PNG 二维码最稳妥
PHP 官方没有内置二维码生成功能，必须依赖第三方库。endroid/qr-code 是目前维护活跃、API 清晰、默认输出 PNG 的首选。它不依赖 GD 扩展（可选使用 imagick），但若用默认驱动，需确保 gd 已启用：
php -m | grep gd若无输出，需在
php.ini 中取消 ;extension=gd 的注释并重启 Web 服务。
QRCode::create() 基本调用不能少这三步
生成一个可用二维码，核心是创建实例 → 设置尺寸与内容 → 输出或保存。漏掉任意一步都会报错或返回空白：
-
QRCode::create()必须传入字符串内容，空字符串或null会抛出InvalidArgumentException -
->writeString()返回的是原始 PNG 二进制数据，不是 Base64；若直接echo，需先设置header('Content-Type: image/png') -
->saveToFile()要求目标目录有写权限，且父目录必须存在，否则抛出RuntimeException
$qrcode = QRCode::create('https://example.com')
->setSize(300)
->setMargin(10);
header('Content-Type: image/png');
echo $qrcode->writeString();
中文内容乱码？关键是编码和字体双处理
直接传入中文字符串（如 '你好'）默认会失败或显示方块，因为 endroid/qr-code 默认只支持 ASCII。解决方法不是改字符集，而是启用「带 logo 或文本的复合二维码」模式，并显式指定中文字体：
JTBC CMS(5.0) 是一款基于PHP和MySQL的内容管理系统原生全栈开发框架，开源协议为AGPLv3，没有任何附加条款。系统可以通过命令行一键安装，源码方面不基于任何第三方框架，不使用任何脚手架，仅依赖一些常见的第三方类库如图表组件等，您只需要了解最基本的前端知识就能很敏捷的进行二次开发，同时我们对于常见的前端功能做了Web Component方式的封装，即便是您仅了解HTML/CSS也
- 必须使用
WriterStyle::create()->setLogoPath()或->setForegroundColour()等扩展写法时，才触发字体加载逻辑 - 实际生效的路径是
->setWriterOptions(['font_path' => '/path/to/simhei.ttf'])，字体文件需为 TrueType 格式（.ttf），且 PHP 进程有读取权限 - 若仅需扫码识别中文内容（非显示中文），应先
urlencode()再传入，如QRCode::create(rawurlencode('你好'))，扫码后客户端自行解码
生成 SVG 二维码要注意 MIME 类型和浏览器兼容性
用 QrCode::create(...)->setWriter(new SvgWriter()) 可输出矢量格式，但不能直接用 writeString() 返回 HTML 片段 —— 它返回的是纯 XML 字符串，缺少 <?xml ...?> 声明和命名空间，部分浏览器（如旧版 Safari）会拒绝渲染：
立即学习“PHP免费学习笔记（深入）”；
- 务必手动添加响应头：
header('Content-Type: image/svg+xml') - 不要嵌入到 HTML 中再用
<img src="data:image/svg+xml,...>%EF%BC%8CBase64%20%E7%BC%96%E7%A0%81%20SVG%20%E6%98%93%E5%87%BA%E9%94%99%EF%BC%9B%E6%8E%A8%E8%8D%90%E7%94%A8%E7%8B%AC%E7%AB%8B%20URL%20%E6%8F%90%E4%BE%9B%20SVG %0A - %E8%8B%A5%E9%9C%80%E5%9C%A8%E7%BD%91%E9%A1%B5%E5%86%85%E8%81%94%E6%98%BE%E7%A4%BA%EF%BC%8C%E7%94%A8%20
echo%20%24qrcode->writeString()%20%E8%BE%93%E5%87%BA%E5%8E%9F%E5%A7%8B%20SVG%20%E5%AD%97%E7%AC%A6%E4%B8%B2%EF%BC%8C%E5%B9%B6%E5%8C%85%E8%A3%B9%E5%9C%A8%20<div>%20%E4%B8%AD%EF%BC%88%E6%B3%A8%E6%84%8F%EF%BC%9ASVG%20%E4%B8%8D%E6%94%AF%E6%8C%81%20<img>%20%E5%8A%A0%E8%BD%BD%E8%87%AA%E8%BA%AB%EF%BC%89 %0A
%E5%A4%8D%E6%9D%82%E7%82%B9%E5%9C%A8%E4%BA%8E%EF%BC%9A%E4%BA%8C%E7%BB%B4%E7%A0%81%E5%AE%B9%E9%94%99%E7%AD%89%E7%BA%A7%E3%80%81%E8%BE%B9%E6%A1%86%E7%95%99%E7%99%BD%E3%80%81%E9%A2%9C%E8%89%B2%E5%AE%9A%E5%88%B6%E8%BF%99%E4%BA%9B%E5%8F%82%E6%95%B0%E8%99%BD%E7%81%B5%E6%B4%BB%EF%BC%8C%E4%BD%86%E4%B8%80%E6%97%A6%E6%B7%B7%E7%94%A8%20setWriter()%20%E5%92%8C%20setWriterOptions()%EF%BC%8C%E5%AE%B9%E6%98%93%E5%9B%A0%E9%A9%B1%E5%8A%A8%E5%B7%AE%E5%BC%82%E5%AF%BC%E8%87%B4%E9%9D%99%E9%BB%98%E5%A4%B1%E8%B4%A5%E3%80%82%E5%BB%BA%E8%AE%AE%E5%A7%8B%E7%BB%88%E7%94%A8%E6%9C%80%E6%96%B0%E7%A8%B3%E5%AE%9A%E7%89%88%EF%BC%88v4+%EF%BC%89%EF%BC%8C%E5%B9%B6%E4%BC%98%E5%85%88%E8%B5%B0%20PNG%20+%20GD%20%E8%B7%AF%E5%BE%84%EF%BC%8C%E9%99%A4%E9%9D%9E%E6%98%8E%E7%A1%AE%E9%9C%80%E8%A6%81%E7%BC%A9%E6%94%BE%E4%B8%8D%E5%A4%B1%E7%9C%9F%E3%80%82
