简介这是一份PHP二维码在线生成工具本地版v1.0源码包面向需要快速搭建二维码服务的PHP开发者、个人站长及内容运营者。核心逻辑基于当前时间与随机数组合生成PNG图片路径从机制上避免图片重复生成的图片保存于根目录单张体积约1K~4K可随文字量自动调整尺寸实测支持200个汉字足以应对日常文本与链接。资源整体仅25KB包含7个文件2个PHP文件入口index.php与核心phpqrcode.php、2个文本说明、2个网址快捷方式及1张示例PNG图片上传至PHP网站空间即可在首页展示生成界面支持子目录部署不显臃肿。已有280人学习下载这套源码既可直接用于活动二维码、商品码或文章配图也能够作为学习PHP路径处理、图片输出与二维码原理的轻量范例。整体结构清晰部署简单适合二次开发和阅读学习。 前阵子手头有个需求给内部系统临时生成一批二维码内容涉及链接、编号、文本还得能在内网环境跑不让数据经过外部接口。翻了一圈在线工具要么次数限制要么付费要么传数据到别人的服务器心里不踏实。干脆基于PHP写了一个本地版二维码在线生成工具v1.0部署在一台闲置的服务器上访问一个地址就能生成、预览、下载全程不走外网。说白了这个工具就是用PHP代码在服务端把文本内容转成二维码图片本地部署后就是一个自用的生成器不依赖任何第三方在线API。对需要做后台管理、批量码牌、活动码印刷、物料标签的PHP开发者来说都很实用。下面我从设计选型、核心实现到踩坑记录完整讲一遍代码不多但逻辑和细节值得捋一捋。1. 项目背景与整体设计思路1.1 为什么不做在线API版本很多人会问现在二维码生成接口那么多直接调用不就行了我最早也这么想但实际一测问题就出来了。首先是数据隐私公司内部的扫码跳转地址、设备编号、人员工号这些信息如果发给第三方接口心里始终不踏实。其次是可用性问题在线接口偶发超时、限次、参数被墙尤其在局域网环境下根本调不通。再有就是定制能力别人的接口只能给你固定尺寸、固定容错级别想调边距、加Logo、批量输出文件名处处受限。所以我的结论是工具类功能能本地就本地。二维码生成本身不是什么高深算法PHP生态里现成类库一大把不需要专门搭服务一段代码就够用。这个v1.0版本把成本压到最低一个PHP文件加一个类库就能跑对部署环境的要求几乎为零。1.2 技术选型原生PHP还是ThinkPHP这个工具最初是想直接集成到公司现有的ThinkPHP 3.2.3项目里的毕竟那套老框架还在服役。但后来考虑到工具本身要独立部署、独立升级就拆成了原生PHP版本不戴框架的帽子放哪个环境都能跑。如果以后要融合进ThinkPHP项目核心逻辑只需要把类库require进去控制器里调用同一个方法即可迁移成本很低。二维码生成类库我选的是PHP QR Code老牌、轻量、单文件、无依赖在PHP 5.6到PHP 8.x上都能跑。它生成的二维码兼容性不错微信、支付宝、微信自带扫一扫都能认。endroid/qr-code那个库功能更强支持SVG和更多样式但依赖Composer部署稍微重一点。v1.0阶段我优先保底用PHP QR Code先把功能跑通。1.3 这个工具解决了什么问题这个工具解决的核心问题有三个快速生成、统一参数、批量处理。快速生成指访问页面后输入文本点一下按钮就能得到图片统一参数指所有二维码的容错级别、尺寸、边距、格式都由一个配置决定保证批量打印时风格一致批量处理指通过一个文本列表循环生成多个二维码避免手工一个个点。这三个需求覆盖了大多数内部工具场景也是我做v1.0时划定的功能边界。2. 二维码生成原理与核心参数详解2.1 二维码是怎么把一段文字变成图案的二维码本质上是一个棋盘格矩阵黑色模块和白色模块按照特定规则排列。生成过程大概分四步第一步把文本转成二进制数据流第二步加上纠错码第三步把数据按规则填入矩阵第四步做掩码处理并绘制成图。这里面纠错码是二维码能“破了还能扫”的关键它是通过里德-所罗门算法算出来的冗余数据即使图案部分被遮挡或污损扫码时仍然能还原出原始内容。我对原理的理解是二维码不怕丑只怕没信息。容错级别越高冗余数据越多图案越能抗遮挡但矩阵也会更密集。实际使用中如果二维码要印在小包装盒上容易被折痕或反光干扰建议直接选最高容错级别H。如果只是屏幕展示、不会磨损选L就够。2.2 关键参数容错等级、尺寸、边距、格式用PHP QR Code的png方法时有四个核心参数容错级别、尺寸倍数、边距、文件名。容错级别可选L、M、Q、HL最低H最高。尺寸倍数不是像素值而是每个模块的放大倍数倍数越大图片越清晰但扫出来的有效区域也越大。边距是二维码四周留白的大小推荐不少于2个模块宽度印刷时静区不够会直接导致无法识别。还有一个容易被忽略的点用像素值判断打印尺寸是错的。一张300x300像素的二维码在屏幕上看起来很清晰但印刷到纸张上如果按72dpi算就是10厘米见方按300dpi算只有2.5厘米见方。所以给印刷厂出图时要么直接指定物理尺寸要么用矢量格式。PHP QR Code默认输出PNG但如果你有更高要求可以改成SVG输出原样缩放都不会糊。2.3 中文内容与特殊字符的处理二维码内容里包含中文时最容易踩的坑是编码不一致。PHP QR Code默认按UTF-8处理字符串如果你从GBK编码的数据库里取数据直接传给类库生成的二维码扫出来就是乱码。解决办法是在传给类库前统一转成UTF-8用iconv或mb_convert_encoding都行。特殊字符方面链接中带有参数时建议直接用原始URL不要先做urlencode。二维码内容本身就是一个字符串扫码枪或手机扫码后会按内容类型自动处理如果你把问号、等号都编码了反而可能导致跳转路径错误。实测下来最稳妥的做法是链接原样传入文本内容转UTF-8后传入数字和英文不需要额外处理。3. 本地版工具实现过程与核心代码3.1 环境准备与目录结构本地搭建一个PHP运行环境Windows可以用PHPStudyLinux直接用apt或yum安装PHP即可需要确保开启GD扩展。PHP QR Code的绘制依赖GD库没有装GD的话生成时会直接报错。你可以开一个phpinfo页面确认gd扩展是否存在。我的目录结构很简洁qr-tool/ ├── index.php // 前端页面 ├── qr.php // 生成接口 ├── lib/ │ └── phpqrcode.php // PHP QR Code类库 └── cache/ // 生成文件缓存目录lib目录里放的是类库源码cache目录用来存放生成的二维码图片需要给写权限。v1.0不在前端放多余框架一个页面一个接口逻辑清晰后续改起来也方便。3.2 引入PHP QR Code类库并完成第一个生成在qr.php里引入类库然后调用静态方法QRcode::png()。最简单的调用方式?php require_once lib/phpqrcode.php; $text https://example.com/product/123; QRcode::png($text, false, L, 6, 2);这段代码会直接把PNG图片输出到浏览器qrcode里的参数意思分别是内容、文件路径false表示直接输出、容错级别、尺寸倍数、边距。第一次跑通时看到浏览器里出现一个二维码那种感觉还是很踏实的。但如果要多场景复用这个裸调用不够用。我马上在qr.php里加了一套参数解析逻辑让它能接收来自前端或接口的参数。3.3 生成接口设计与动态参数解析我设计的qr.php接口接收以下几个参数text表示二维码内容level表示容错级别size表示尺寸倍数margin表示边距download表示是否触发下载。代码中先做参数校验避免空内容和非法参数?php require_once lib/phpqrcode.php; $text isset($_GET[text]) ? $_GET[text] : ; $level isset($_GET[level]) ? strtoupper($_GET[level]) : L; $size isset($_GET[size]) ? intval($_GET[size]) : 6; $margin isset($_GET[margin]) ? intval($_GET[margin]) : 2; if ($text ) { http_response_code(400); exit(参数错误text不能为空); } if (!in_array($level, [L, M, Q, H], true)) { $level L; } $size max(1, min(20, $size)); $margin max(0, min(10, $margin)); if (mb_detect_encoding($text, UTF-8, true) false) { $text mb_convert_encoding($text, UTF-8, GBK); } if (isset($_GET[download])) { header(Content-Disposition: attachment; filenameqrcode_ . time() . .png); } QRcode::png($text, false, $level, $size, $margin);这里有个细节如果希望生成后保存到文件而不仅是浏览器输出可以把第二个参数当文件路径传入$filePath cache/ . md5($text . $level . $size . $margin) . .png; QRcode::png($text, $filePath, $level, $size, $margin); echo $filePath;用md5做文件名同一个内容只生成一次下次直接复用这在批量场景下能省不少资源。批量生成时我是在一个循环里传入不同文本每个文本生成一个文件最后统一打包成zip也可以用遍历结果直接拼一个图片列表给前端展示。3.4 前端页面与下载交互index.php里做了一个最简单的表单文本域输入内容下拉框选容错级别滑块调尺寸点击生成后如果是嵌入图片的方式就直接把img标签的src指向qr.php并带上参数。这里避免使用表单提交刷新页面而是用fetch方式拉取blob数据这样体验更好async function generateQr() { const text document.getElementById(text).value; const level document.getElementById(level).value; const size document.getElementById(size).value; const url qr.php?text${encodeURIComponent(text)}level${level}size${size}download1; const resp await fetch(url); const blob await resp.blob(); const link document.createElement(a); link.href URL.createObjectURL(blob); link.download qrcode_${Date.now()}.png; link.click(); }这里注意一下fetch请求时一定要encodeURIComponent对text做URL编码否则中文和特殊符号会丢失。下载文件名用时间戳保证唯一。如果只是预览则不需要download参数直接在img的src上写url即可。另外有朋友问过“jquery怎么把二维码拖到一张图上调整大小再保存”这个本质上是前端canvas合成。二维码生成接口不变前端加载一张背景图把二维码图片拖到指定位置用canvas绘制合成后再导出为PNG。这类应用在制作带二维码的海报、邀请函时很常见v1.0里我留了这个接口后续可以扩展。4. 常见问题与排查技巧实录4.1 二维码生成出来是空白或直接报错这种情况90%是GD扩展没开。可以用php -m命令查看模块列表或者临时写一个phpinfo()页面确认。还有一种情况是PHP QR Code类库版本和PHP版本不兼容PHP 8.0以上版本如果用了老类库有时会出现“Function ereg() is deprecated”之类的提示建议下载最新版类库或改用endroid/qr-code配合Composer管理依赖。如果页面一片空白且没有任何输出先打开PHP错误显示ini_set(display_errors, 1); error_reporting(E_ALL);这一步能快速定位到具体是哪个函数报错。生产环境记得关掉display_errors改记日志。4.2 中文内容扫码乱码中文乱码问题的根源几乎都是编码不一致。从MySQL取数据时要用utf8mb4连接字符集从Excel导入的文本可能本身是GBK编码从URL参数传入的内容如果前端没做encodeURIComponent后端拿到手就已经乱掉了。我的处理办法是后端统一入口用mb_check_encoding先判断不是UTF-8就转成UTF-8这样无论来源是什么到类库手里时都是统一的UTF-8。还有一个小细节用微信扫描二维码时如果内容不是以http开头微信会当成纯文本展示这逻辑没问题。但如果内容是JSON或者带换行符的字符串建议生成前对换行做转义或替换成空格否则部分扫码应用会解析混乱。4.3 打印出来扫码识别不了屏幕裁剪后能扫打印出来却扫不动这个我最有发言权。原因主要有三个尺寸太小、容错级别太低、静区不足。扫码枪和手机摄像头对模糊图案的容错能力有限二维码本身是一个个像素块组成的打印后如果被打印机缩小到小于2厘米见方模块就被压成小白点基本废了。我的建议是容错级别直接上H尺寸倍数至少10边距至少3这样印刷时即使存在套色偏差也不会影响识别。还有网友遇到“二维码缺口怎么调整机器”这类问题说白了就是打印头或墨量导致图案缺块。在软件层面你能做的就是提高容错级别让二维码自带修复能力硬件层面就需要清洁打印头、校准走纸了。二维码生成工具只能保证图案本身正确物理世界的磨损问题只能靠冗余数据去扛。4.4 批量生成时的性能与超时问题循环生成几百个二维码时脚本默认的max_execution_time可能只有30秒生成到一半就超时中断了。解决办法是在脚本开头加set_time_limit(0)同时用ob_implicit_flush()让内容实时输出用户能看到生成进度而不是白屏等待。内存也是一个大坑PHP QR Code在生成大尺寸二维码时会分配不小内存如果一次生成几百张建议每生成完一张用unset释放变量。批量场景的另一招是复用文件缓存。前面提到用md5(text level size margin)作为文件名如果文件已存在就直接返回路径不再重新生成。这个方案实测下效率提升非常明显尤其当大量二维码的内容有重复前缀时。批量输出可以做成循环展示图片列表或者最后用ZipArchive打包成一个压缩包下载。4.5 开发调试工具建议有热词提到“如何用netbeans写php”和“phpstorm怎么运行php项目”这里顺带说一句。我用PHPStorm比较多配置好本地PHP解释器和Xdebug后可以直接断点调试QRcode::png方法的参数。NetBeans同样支持PHP开发配置更简单适合初学者。调试二维码工具时最常用的验证手段是浏览器调用摄像头扫码可以用html5-qrcode这个前端库手机和电脑都能扫不用装App。我一般会开两个页面一个生成二维码一个打开扫码预览改一次参数扫一次效率很高。5. 实际部署中的经验与后续扩展方向5.1 部署到服务器时要注意的细节v1.0完成之后我把它部署到一台内网服务器上遇到几个和本地开发不一样的问题。首先是cache目录权限Web服务器用户必须对cache目录有写权限否则保存文件时会报Permission denied。其次是安全设置既然工具暴露在Web目录下最好限制访问IP或加上简单的Basic认证防止内网其他人滥用生成大量文件。缓存目录建议加一个默认入口文件或者配置Nginx禁止访问.php以外的可执行文件。还有一个容易踩的是PHP版本差异。本地用PHP 7.4服务器是PHP 5.6PHP QR Code老版本在PHP 5.6下没问题但如果你用了新语法比如[]数组简写就会直接语法错误。所以部署前最好确认目标版本的语法兼容性或者直接把类库和代码都跑一遍自测脚本。5.2 后续还能怎么扩展v1.0只是打底后续可扩展的方向其实很多。比如支持批量生成并导出为PDF用TCPDF或FPDF把多个二维码排在一张A4纸上适合做资产标签比如支持自动嵌入Logo二维码中间放一个圆形Logo既能提升辨识度又方便内部识别再比如对接外部系统把生成接口做成REST API用PHP的curl或Guzzle调用让其他系统直接拿到二维码图片的URL。很多人问怎么用uniapp生成二维码那本质上是前端canvas绘制方案和PHP服务端生成不是一回事。但如果你的小程序需要在线拉取二维码完全可以把这个工具的接口做成API小程序端传参后拿图片后端负责生成和缓存前端不背性能包袱。另外如果要对破损二维码做修复或识别可以配合OpenCV或C二维码识别库做二次开发将来说不定能做出一个自动化巡检工具。5.3 一点个人体会做这个小工具最大的收获是不要把简单的事情复杂化。二维码生成本身是个成熟得不能再成熟的技术真正花时间的是设计一个好用的接口和一套可靠的参数默认值。我一开始总是纠结要不要上框架、要不要支持多种格式、要不要做用户系统后来砍到只剩一个生成接口加一个前端页面反而用起来最顺手。工具类项目快速、稳定、可控才是王道。如果再让我重做一次我可能会把参数校验和错误返回逻辑做得更规范用JSON格式返回错误信息这样对接API的同事用起来也更舒服。不过那个已经是v1.1的事了这次先到这儿。本文还有配套的精品资源点击获取
基于PHP的二维码生成工具：本地部署与实现详解
简介这是一份PHP二维码在线生成工具本地版v1.0源码包面向需要快速搭建二维码服务的PHP开发者、个人站长及内容运营者。核心逻辑基于当前时间与随机数组合生成PNG图片路径从机制上避免图片重复生成的图片保存于根目录单张体积约1K~4K可随文字量自动调整尺寸实测支持200个汉字足以应对日常文本与链接。资源整体仅25KB包含7个文件2个PHP文件入口index.php与核心phpqrcode.php、2个文本说明、2个网址快捷方式及1张示例PNG图片上传至PHP网站空间即可在首页展示生成界面支持子目录部署不显臃肿。已有280人学习下载这套源码既可直接用于活动二维码、商品码或文章配图也能够作为学习PHP路径处理、图片输出与二维码原理的轻量范例。整体结构清晰部署简单适合二次开发和阅读学习。 前阵子手头有个需求给内部系统临时生成一批二维码内容涉及链接、编号、文本还得能在内网环境跑不让数据经过外部接口。翻了一圈在线工具要么次数限制要么付费要么传数据到别人的服务器心里不踏实。干脆基于PHP写了一个本地版二维码在线生成工具v1.0部署在一台闲置的服务器上访问一个地址就能生成、预览、下载全程不走外网。说白了这个工具就是用PHP代码在服务端把文本内容转成二维码图片本地部署后就是一个自用的生成器不依赖任何第三方在线API。对需要做后台管理、批量码牌、活动码印刷、物料标签的PHP开发者来说都很实用。下面我从设计选型、核心实现到踩坑记录完整讲一遍代码不多但逻辑和细节值得捋一捋。1. 项目背景与整体设计思路1.1 为什么不做在线API版本很多人会问现在二维码生成接口那么多直接调用不就行了我最早也这么想但实际一测问题就出来了。首先是数据隐私公司内部的扫码跳转地址、设备编号、人员工号这些信息如果发给第三方接口心里始终不踏实。其次是可用性问题在线接口偶发超时、限次、参数被墙尤其在局域网环境下根本调不通。再有就是定制能力别人的接口只能给你固定尺寸、固定容错级别想调边距、加Logo、批量输出文件名处处受限。所以我的结论是工具类功能能本地就本地。二维码生成本身不是什么高深算法PHP生态里现成类库一大把不需要专门搭服务一段代码就够用。这个v1.0版本把成本压到最低一个PHP文件加一个类库就能跑对部署环境的要求几乎为零。1.2 技术选型原生PHP还是ThinkPHP这个工具最初是想直接集成到公司现有的ThinkPHP 3.2.3项目里的毕竟那套老框架还在服役。但后来考虑到工具本身要独立部署、独立升级就拆成了原生PHP版本不戴框架的帽子放哪个环境都能跑。如果以后要融合进ThinkPHP项目核心逻辑只需要把类库require进去控制器里调用同一个方法即可迁移成本很低。二维码生成类库我选的是PHP QR Code老牌、轻量、单文件、无依赖在PHP 5.6到PHP 8.x上都能跑。它生成的二维码兼容性不错微信、支付宝、微信自带扫一扫都能认。endroid/qr-code那个库功能更强支持SVG和更多样式但依赖Composer部署稍微重一点。v1.0阶段我优先保底用PHP QR Code先把功能跑通。1.3 这个工具解决了什么问题这个工具解决的核心问题有三个快速生成、统一参数、批量处理。快速生成指访问页面后输入文本点一下按钮就能得到图片统一参数指所有二维码的容错级别、尺寸、边距、格式都由一个配置决定保证批量打印时风格一致批量处理指通过一个文本列表循环生成多个二维码避免手工一个个点。这三个需求覆盖了大多数内部工具场景也是我做v1.0时划定的功能边界。2. 二维码生成原理与核心参数详解2.1 二维码是怎么把一段文字变成图案的二维码本质上是一个棋盘格矩阵黑色模块和白色模块按照特定规则排列。生成过程大概分四步第一步把文本转成二进制数据流第二步加上纠错码第三步把数据按规则填入矩阵第四步做掩码处理并绘制成图。这里面纠错码是二维码能“破了还能扫”的关键它是通过里德-所罗门算法算出来的冗余数据即使图案部分被遮挡或污损扫码时仍然能还原出原始内容。我对原理的理解是二维码不怕丑只怕没信息。容错级别越高冗余数据越多图案越能抗遮挡但矩阵也会更密集。实际使用中如果二维码要印在小包装盒上容易被折痕或反光干扰建议直接选最高容错级别H。如果只是屏幕展示、不会磨损选L就够。2.2 关键参数容错等级、尺寸、边距、格式用PHP QR Code的png方法时有四个核心参数容错级别、尺寸倍数、边距、文件名。容错级别可选L、M、Q、HL最低H最高。尺寸倍数不是像素值而是每个模块的放大倍数倍数越大图片越清晰但扫出来的有效区域也越大。边距是二维码四周留白的大小推荐不少于2个模块宽度印刷时静区不够会直接导致无法识别。还有一个容易被忽略的点用像素值判断打印尺寸是错的。一张300x300像素的二维码在屏幕上看起来很清晰但印刷到纸张上如果按72dpi算就是10厘米见方按300dpi算只有2.5厘米见方。所以给印刷厂出图时要么直接指定物理尺寸要么用矢量格式。PHP QR Code默认输出PNG但如果你有更高要求可以改成SVG输出原样缩放都不会糊。2.3 中文内容与特殊字符的处理二维码内容里包含中文时最容易踩的坑是编码不一致。PHP QR Code默认按UTF-8处理字符串如果你从GBK编码的数据库里取数据直接传给类库生成的二维码扫出来就是乱码。解决办法是在传给类库前统一转成UTF-8用iconv或mb_convert_encoding都行。特殊字符方面链接中带有参数时建议直接用原始URL不要先做urlencode。二维码内容本身就是一个字符串扫码枪或手机扫码后会按内容类型自动处理如果你把问号、等号都编码了反而可能导致跳转路径错误。实测下来最稳妥的做法是链接原样传入文本内容转UTF-8后传入数字和英文不需要额外处理。3. 本地版工具实现过程与核心代码3.1 环境准备与目录结构本地搭建一个PHP运行环境Windows可以用PHPStudyLinux直接用apt或yum安装PHP即可需要确保开启GD扩展。PHP QR Code的绘制依赖GD库没有装GD的话生成时会直接报错。你可以开一个phpinfo页面确认gd扩展是否存在。我的目录结构很简洁qr-tool/ ├── index.php // 前端页面 ├── qr.php // 生成接口 ├── lib/ │ └── phpqrcode.php // PHP QR Code类库 └── cache/ // 生成文件缓存目录lib目录里放的是类库源码cache目录用来存放生成的二维码图片需要给写权限。v1.0不在前端放多余框架一个页面一个接口逻辑清晰后续改起来也方便。3.2 引入PHP QR Code类库并完成第一个生成在qr.php里引入类库然后调用静态方法QRcode::png()。最简单的调用方式?php require_once lib/phpqrcode.php; $text https://example.com/product/123; QRcode::png($text, false, L, 6, 2);这段代码会直接把PNG图片输出到浏览器qrcode里的参数意思分别是内容、文件路径false表示直接输出、容错级别、尺寸倍数、边距。第一次跑通时看到浏览器里出现一个二维码那种感觉还是很踏实的。但如果要多场景复用这个裸调用不够用。我马上在qr.php里加了一套参数解析逻辑让它能接收来自前端或接口的参数。3.3 生成接口设计与动态参数解析我设计的qr.php接口接收以下几个参数text表示二维码内容level表示容错级别size表示尺寸倍数margin表示边距download表示是否触发下载。代码中先做参数校验避免空内容和非法参数?php require_once lib/phpqrcode.php; $text isset($_GET[text]) ? $_GET[text] : ; $level isset($_GET[level]) ? strtoupper($_GET[level]) : L; $size isset($_GET[size]) ? intval($_GET[size]) : 6; $margin isset($_GET[margin]) ? intval($_GET[margin]) : 2; if ($text ) { http_response_code(400); exit(参数错误text不能为空); } if (!in_array($level, [L, M, Q, H], true)) { $level L; } $size max(1, min(20, $size)); $margin max(0, min(10, $margin)); if (mb_detect_encoding($text, UTF-8, true) false) { $text mb_convert_encoding($text, UTF-8, GBK); } if (isset($_GET[download])) { header(Content-Disposition: attachment; filenameqrcode_ . time() . .png); } QRcode::png($text, false, $level, $size, $margin);这里有个细节如果希望生成后保存到文件而不仅是浏览器输出可以把第二个参数当文件路径传入$filePath cache/ . md5($text . $level . $size . $margin) . .png; QRcode::png($text, $filePath, $level, $size, $margin); echo $filePath;用md5做文件名同一个内容只生成一次下次直接复用这在批量场景下能省不少资源。批量生成时我是在一个循环里传入不同文本每个文本生成一个文件最后统一打包成zip也可以用遍历结果直接拼一个图片列表给前端展示。3.4 前端页面与下载交互index.php里做了一个最简单的表单文本域输入内容下拉框选容错级别滑块调尺寸点击生成后如果是嵌入图片的方式就直接把img标签的src指向qr.php并带上参数。这里避免使用表单提交刷新页面而是用fetch方式拉取blob数据这样体验更好async function generateQr() { const text document.getElementById(text).value; const level document.getElementById(level).value; const size document.getElementById(size).value; const url qr.php?text${encodeURIComponent(text)}level${level}size${size}download1; const resp await fetch(url); const blob await resp.blob(); const link document.createElement(a); link.href URL.createObjectURL(blob); link.download qrcode_${Date.now()}.png; link.click(); }这里注意一下fetch请求时一定要encodeURIComponent对text做URL编码否则中文和特殊符号会丢失。下载文件名用时间戳保证唯一。如果只是预览则不需要download参数直接在img的src上写url即可。另外有朋友问过“jquery怎么把二维码拖到一张图上调整大小再保存”这个本质上是前端canvas合成。二维码生成接口不变前端加载一张背景图把二维码图片拖到指定位置用canvas绘制合成后再导出为PNG。这类应用在制作带二维码的海报、邀请函时很常见v1.0里我留了这个接口后续可以扩展。4. 常见问题与排查技巧实录4.1 二维码生成出来是空白或直接报错这种情况90%是GD扩展没开。可以用php -m命令查看模块列表或者临时写一个phpinfo()页面确认。还有一种情况是PHP QR Code类库版本和PHP版本不兼容PHP 8.0以上版本如果用了老类库有时会出现“Function ereg() is deprecated”之类的提示建议下载最新版类库或改用endroid/qr-code配合Composer管理依赖。如果页面一片空白且没有任何输出先打开PHP错误显示ini_set(display_errors, 1); error_reporting(E_ALL);这一步能快速定位到具体是哪个函数报错。生产环境记得关掉display_errors改记日志。4.2 中文内容扫码乱码中文乱码问题的根源几乎都是编码不一致。从MySQL取数据时要用utf8mb4连接字符集从Excel导入的文本可能本身是GBK编码从URL参数传入的内容如果前端没做encodeURIComponent后端拿到手就已经乱掉了。我的处理办法是后端统一入口用mb_check_encoding先判断不是UTF-8就转成UTF-8这样无论来源是什么到类库手里时都是统一的UTF-8。还有一个小细节用微信扫描二维码时如果内容不是以http开头微信会当成纯文本展示这逻辑没问题。但如果内容是JSON或者带换行符的字符串建议生成前对换行做转义或替换成空格否则部分扫码应用会解析混乱。4.3 打印出来扫码识别不了屏幕裁剪后能扫打印出来却扫不动这个我最有发言权。原因主要有三个尺寸太小、容错级别太低、静区不足。扫码枪和手机摄像头对模糊图案的容错能力有限二维码本身是一个个像素块组成的打印后如果被打印机缩小到小于2厘米见方模块就被压成小白点基本废了。我的建议是容错级别直接上H尺寸倍数至少10边距至少3这样印刷时即使存在套色偏差也不会影响识别。还有网友遇到“二维码缺口怎么调整机器”这类问题说白了就是打印头或墨量导致图案缺块。在软件层面你能做的就是提高容错级别让二维码自带修复能力硬件层面就需要清洁打印头、校准走纸了。二维码生成工具只能保证图案本身正确物理世界的磨损问题只能靠冗余数据去扛。4.4 批量生成时的性能与超时问题循环生成几百个二维码时脚本默认的max_execution_time可能只有30秒生成到一半就超时中断了。解决办法是在脚本开头加set_time_limit(0)同时用ob_implicit_flush()让内容实时输出用户能看到生成进度而不是白屏等待。内存也是一个大坑PHP QR Code在生成大尺寸二维码时会分配不小内存如果一次生成几百张建议每生成完一张用unset释放变量。批量场景的另一招是复用文件缓存。前面提到用md5(text level size margin)作为文件名如果文件已存在就直接返回路径不再重新生成。这个方案实测下效率提升非常明显尤其当大量二维码的内容有重复前缀时。批量输出可以做成循环展示图片列表或者最后用ZipArchive打包成一个压缩包下载。4.5 开发调试工具建议有热词提到“如何用netbeans写php”和“phpstorm怎么运行php项目”这里顺带说一句。我用PHPStorm比较多配置好本地PHP解释器和Xdebug后可以直接断点调试QRcode::png方法的参数。NetBeans同样支持PHP开发配置更简单适合初学者。调试二维码工具时最常用的验证手段是浏览器调用摄像头扫码可以用html5-qrcode这个前端库手机和电脑都能扫不用装App。我一般会开两个页面一个生成二维码一个打开扫码预览改一次参数扫一次效率很高。5. 实际部署中的经验与后续扩展方向5.1 部署到服务器时要注意的细节v1.0完成之后我把它部署到一台内网服务器上遇到几个和本地开发不一样的问题。首先是cache目录权限Web服务器用户必须对cache目录有写权限否则保存文件时会报Permission denied。其次是安全设置既然工具暴露在Web目录下最好限制访问IP或加上简单的Basic认证防止内网其他人滥用生成大量文件。缓存目录建议加一个默认入口文件或者配置Nginx禁止访问.php以外的可执行文件。还有一个容易踩的是PHP版本差异。本地用PHP 7.4服务器是PHP 5.6PHP QR Code老版本在PHP 5.6下没问题但如果你用了新语法比如[]数组简写就会直接语法错误。所以部署前最好确认目标版本的语法兼容性或者直接把类库和代码都跑一遍自测脚本。5.2 后续还能怎么扩展v1.0只是打底后续可扩展的方向其实很多。比如支持批量生成并导出为PDF用TCPDF或FPDF把多个二维码排在一张A4纸上适合做资产标签比如支持自动嵌入Logo二维码中间放一个圆形Logo既能提升辨识度又方便内部识别再比如对接外部系统把生成接口做成REST API用PHP的curl或Guzzle调用让其他系统直接拿到二维码图片的URL。很多人问怎么用uniapp生成二维码那本质上是前端canvas绘制方案和PHP服务端生成不是一回事。但如果你的小程序需要在线拉取二维码完全可以把这个工具的接口做成API小程序端传参后拿图片后端负责生成和缓存前端不背性能包袱。另外如果要对破损二维码做修复或识别可以配合OpenCV或C二维码识别库做二次开发将来说不定能做出一个自动化巡检工具。5.3 一点个人体会做这个小工具最大的收获是不要把简单的事情复杂化。二维码生成本身是个成熟得不能再成熟的技术真正花时间的是设计一个好用的接口和一套可靠的参数默认值。我一开始总是纠结要不要上框架、要不要支持多种格式、要不要做用户系统后来砍到只剩一个生成接口加一个前端页面反而用起来最顺手。工具类项目快速、稳定、可控才是王道。如果再让我重做一次我可能会把参数校验和错误返回逻辑做得更规范用JSON格式返回错误信息这样对接API的同事用起来也更舒服。不过那个已经是v1.1的事了这次先到这儿。本文还有配套的精品资源点击获取
