简介PHP二维码在线生成工具本地版v1.0是一份基于PHP源码的二维码生成方案主要面向需要在自己网站空间或本地环境生成二维码的开发者解决线上生成服务依赖外部接口、无法自定义部署的问题。程序采用当前时间与随机数组合的方式生成PNG图片路径可有效避免文件重复生成的图片保存在根目录单张体积约1K4K图片宽高会随文字数量自动变化实测生成包含200个汉字的二维码也能正常运行整体逻辑简洁适合内网环境、临时工具站或教学演示场景也便于按需修改样式或扩展功能。压缩包共7个文件以两个PHP核心脚本为主配以txt使用说明与URL参考链接另有png示例图包体仅25KB部署非常轻量上传至PHP网站空间后通过首页index.php即可使用子目录部署同样支持。目前已有280人学习下载适合具备基础PHP环境、希望快速搭建本地二维码生成功能的开发者参考。 做这个工具的直接原因很简单我给客户做小程序后台时每天要给几十个商品生成带渠道参数的二维码原来一直用在线二维码网站但用着用着问题就来了。最让我没法忍的是商品编号、渠道码这些内部数据都要先传到别人的服务器免费版还有各种限制一不注意就弹广告。后来我干脆自己用 PHP 写了一个本地版二维码在线生成工具v1.0 从开发到现在稳定跑了两个多月今天把完整实现思路、核心代码和踩坑记录都整理出来给同样需要本地生成二维码的朋友参考。这里的“在线”指的是浏览器访问本地服务实时生成不是 SaaS 服务。1. 为什么我弃用在线二维码网站自己写了个本地版1.1 在线生成器的四个痛点用在线网站生成二维码表面上省事实际用起来难受的地方不少。先说数据安全问题这是最核心的。我在给客户做商品渠道追踪时二维码内容里通常带着商品编号、内部物料编码、渠道参数有时候还有客户手机号这些东西一旦提交到第三方网站数据就脱离你控制了。虽然大多数网站声称不做存储但你没法验证出了问题就是自己的锅。第二个痛点是功能限制。免费版在线生成器基本只能改改内容、尺寸容错级别固定想加 logo、改颜色、批量生成全部要付费。我曾经为了一个项目连续开了三个月会员一个月几十块钱不算多但用起来总觉得亏。第三个痛点是稳定性不可控。在线服务哪天改版、域名变更、图片 CDN 挂了你历史生成的二维码图片就可能失效。二维码一旦打印出去用户扫码直接就打不开这种问题在线工具厂家不会替你负责。第四个痛点是效率。一次要生成一两百个二维码时用在线工具要么手动复制粘贴到网页要么一个个点下载效率非常低。有时还有验证码、登录、等待队列之类的东西批量场景下根本没法用。1.2 本地版的核心价值数据安全、离线可用、可二次开发自己写本地版之后以上四个问题基本都消失了。数据全程在本地 PHP 进程里处理不经过任何第三方服务器商品信息、渠道参数这些敏感数据可以放心用。服务跑在内网或者本机断网也能正常生成不用看别人脸色。另外最重要的是可二次开发。我后来把生成接口接进了内部商品管理后台商品入库时自动生成带渠道参数的二维码文件名按商品编码命名直接归档到服务器。在线工具根本做不到这种深度集成。1.3 v1.0 的功能边界与技术选型v1.0 我规划了这几个功能单张二维码生成、批量生成、自定义容错级别、自定义尺寸和留白、logo 合成、前端实时预览、批量打包下载。技术栈没有追新用了原生 PHP jQuery phpqrcode。phpqrcode 是网上很老牌的单文件 PHP 二维码库不需要 Composer适合本地小工具。如果你项目里用的是 ThinkPHP 3.2.3 这类老框架也可以直接把 qrlib.php 引入改成控制器方法即可代码思路完全一致。2. 二维码生成原理与 PHP 库选型2.1 黑白格子背后的数据编码与容错级别写生成工具之前我建议先花十分钟理解二维码的基本原理不然遇到“扫不出来”的问题会很被动。二维码本质上是一个二维矩阵把字符串按一定规则转成二进制再通过 Reed-Solomon 纠错算法加上冗余数据最终分布到矩阵的黑色和白色模块里。识别端扫码时先通过三个角上的回字定位图形确定方向和坐标系再读取矩阵里的数据反向还原出原始字符串。这里最需要关注的是容错级别。二维码分 L、M、Q、H 四个级别分别能容忍大约 7%、15%、25%、30% 的污损或遮挡。容错级别越高二维码图案越密识别越稳。给商品打码这种场景我默认用 M 级既能保证一定的抗污损能力图案密度也适中。如果要在二维码中间贴 logo就得用 Q 或者 H 级不然中央遮挡区域容易导致扫码失败。2.2 phpqrcode 与 endroid/qr-code 怎么选PHP 生成二维码的库主流就是 phpqrcode 和 endroid/qr-code 两个。我当时的选型对比是这样的对比项phpqrcodeendroid/qr-code安装方式手动 require 单文件Composer 安装PHP 版本要求PHP 5.6 即可要求 PHP 7.2部分版本更高依赖扩展GD 库GD、fileinfo 等输出格式PNG、SVGPNG、SVG、EPS、PDF 等Logo 合成需要自己用 GD 处理官方支持自带接口维护状态多年未更新功能稳定持续维护上手成本极低需要熟悉 Composer最终我选了 phpqrcode原因有三个一是本地服务器是 Windows 环境跑着老项目PHP 版本还停留在 5.6endroid 新版本直接装不上二是这个工具不需要复杂导出格式PNG 就够用三是 phpqrcode 单文件引入代码逻辑一目了然出问题好排查。2.3 本地环境准备PHP 版本、GD 扩展、目录权限开始前先确认环境。Windows 上我建议用 phpstudy 或 XAMPPLinux 直接用包管理器安装 php-gd。打开命令行输入php -m如果输出列表里没有 gd就需要安装或开启扩展。php -m | grep gd如果没有输出说明 GD 扩展没装好。我在 Windows 的 phpstudy 里遇到过一次原因很简单php.ini 里没有去掉extensiongd2前面的分号。如果你用 Docker 拉官方镜像比如php:7.4-apache也需要自己执行docker-php-ext-install gd安装扩展。另外要注意 output 目录的写权限。批量生成二维码时要写文件apache 或 php-fpm 运行用户必须对目标目录有写权限不然会报 “failed to open stream: Permission denied”。3. 核心实现单张生成、批量导出、Logo 合成、前端预览3.1 单张二维码接口20 行代码搞定phpqrcode 的核心方法只有一行QRcode::png()但直接调用会遇到一个输出问题这个方法默认把图片数据直接打印到浏览器不方便作为接口返回。我用输出缓冲把它截获再统一返回图片流。单张生成接口的完整代码?php require_once __DIR__ . /lib/phpqrcode/qrlib.php; $data $_GET[data] ?? hello; $size max(1, min((int)($_GET[size] ?? 10), 20)); $margin (int)($_GET[margin] ?? 2); $ec in_array($_GET[ec] ?? M, [L, M, Q, H]) ? $_GET[ec] : M; ob_start(); QRcode::png($data, false, $ec, $size, $margin); $png ob_get_clean(); header(Content-Type: image/png); header(Content-Length: . strlen($png)); echo $png;这段代码里几个参数要注意size 是每个模块的像素数取值范围在 1 到 20 之间实际图片边长大约是size * 模块数 2 * margin并不是说 size 越大内容越多。margin 是二维码四周白边的像素宽度这个值不能设成 0扫码器需要靠白边来确认边界一般保持 2 以上。3.2 批量生成一次导入几百条并打包下载批量生成是本地工具相对在线网站最明显的优势。我的实现是从 textarea 里读文本一行一条内容然后循环调用QRcode::png输出到指定目录最后用 ZipArchive 打包下载。核心代码?php require_once __DIR__ . /lib/phpqrcode/qrlib.php; $raw $_POST[data] ?? ; $lines explode(\n, $raw); $outDir __DIR__ . /output/ . date(YmdHis); if (!is_dir($outDir)) { mkdir($outDir, 0755, true); } foreach ($lines as $i $line) { $text trim($line); if ($text ) { continue; } $filename $outDir . / . $i . _ . md5($text) . .png; QRcode::png($text, $filename, QR_ECLEVEL_M, 10, 2); } $zip new ZipArchive(); $zipFile $outDir . .zip; $zip-open($zipFile, ZipArchive::CREATE | ZipArchive::OVERWRITE); foreach (glob($outDir . /*.png) as $file) { $zip-addFile($file, basename($file)); } $zip-close();这里我踩过一个坑如果直接用序号$i做文件名有两个内容不同的二维码在循环里都会生成同样名称的文件后生成的文件会覆盖先前的。后来加了md5($text)做指纹再加上序号前缀基本不会冲突。批量导出时如果一次几万条建议用set_time_limit(0)避免执行超时同时每处理完一个 unset 释放内存。3.3 Logo 与彩色二维码扫得出来才是关键默认生成的二维码是黑白的放在产品包装上比较丑所以 v1.0 加了 logo 合成和颜色自定义。logo 合成的原理很简单先生成二维码 PNG再用 GD 库把 logo 图片缩放后贴到二维码中央。?php $qr imagecreatefrompng($qrFile); $logo imagecreatefrompng($logoFile); $qrW imagesx($qr); $logoW (int)($qrW * 0.25); // logo边长控制在二维码的25% $logoH (int)(imagesy($logo) * $logoW / imagesx($logo)); $dstX (int)(($qrW - $logoW) / 2); $dstY (int)(($qrW - $logoH) / 2); imagecopyresampled($qr, $logo, $dstX, $dstY, 0, 0, $logoW, $logoH, imagesx($logo), imagesy($logo)); imagepng($qr, $qrFile);logo 大小一定要控制好边长不要超过二维码总尺寸的 30%。二维码的容错机制能容忍中央区域被遮挡但也有限度我实测过logo 如果超过 30%手机扫码时识别率会明显下降尤其是环境光线不好时基本就是报废状态。彩色二维码我最初想直接改 phpqrcode 源码后来发现不值得。phpqrcode 的QRcode::png()本身就支持$saveToFile参数但不支持自定义前景色。简单做法是生成灰度二维码后再用 GD 遍历像素替换颜色但性能一般。经验是二维码的三个定位角尽量保持深色不要做反色处理。很多人做“反色二维码”觉得酷把黑底白格或者用亮色当前景结果就是扫码器识别不了日常使用千万别这么干。3.4 前端不刷新页面实时出码v1.0 的前端用 jQuery 做实时预览绑定 input 的 input 事件防抖后请求 3.1 里的接口拿回 base64 图片直接替换 img 标签。这里关键是防抖不然用户每敲一个字符就请求一次本地服务压力不大但浏览器网络请求会乱掉。另外分享一个扩展场景有人想在背景图上拖拽二维码、调整大小后保存成一张新图片。这个需求本质上已经不是生成二维码而是图片合成。前端用 html2canvas 可以把 DOM 截图但高清输出比较麻烦字号和图片清晰度都不稳定。我更推荐的做法是后端接收坐标、尺寸、背景图参数用 GD 成图这样图片质量可控还能保存高清版本。v1.0 我把这个功能留到 v1.1 再做成独立模块。4. 完整实操把 v1.0 跑起来并集成到业务系统4.1 目录结构与部署步骤我最终的目录结构是这样的qr_tool/ ├── index.php ├── api.php ├── lib/ │ └── phpqrcode/ │ ├── qrlib.php │ └── ... ├── assets/ │ └── jquery.min.js └── output/部署步骤很简单把整个目录放到本地 Web 服务的站点根目录比如 phpstudy 的 www 目录或 Nginx 的 html 目录然后访问http://localhost/qr_tool/index.php。output 目录需要提前建好并确保有写权限。4.2 核心代码逐段解析index.php 核心是表单和实时预览我贴一段关键代码div classform-item label二维码内容/label input typetext idqr-data valuehttps://example.com / /div div classform-item label容错级别/label select idqr-ec option valueLL7%/option option valueM selectedM15%/option option valueQQ25%/option option valueHH30%/option /select /div img idqr-preview src alt二维码预览 / script var timer null; $(#qr-data, #qr-ec, #qr-size).on(input change, function () { clearTimeout(timer); timer setTimeout(loadQr, 300); }); function loadQr() { var data $(#qr-data).val(); var ec $(#qr-ec).val(); var size $(#qr-size).val(); $(#qr-preview).attr(src, api.php?data encodeURIComponent(data) ec ec size size); } /script几个细节内容输入框一定要用encodeURIComponent编码如果内容里带了、?这样的参数不编码会导致请求参数断裂。容错级别下拉框选中后立刻触发预览用户交互会比较顺手。4.3 性能测试与内存调优记录我本地压过一次生成一张纯文本二维码接口响应约 10ms肉眼感知就是瞬间。批量生成 100 张普通二维码写入文件方式总耗时大概 0.8 秒这个速度完全满足日常需求。批量场景下内存增长比较明显主要出现在 logo 合成阶段因为imagecreatefrompng会把整张图片载入内存如果大量并发内存很容易顶满。我的处理办法是每处理完一张就imagedestroy()释放资源。生成大量文件时建议分批处理比如每 500 张打包一个 zip避免单个 zip 文件过大导致下载超时。5. 常见问题与排查技巧实录5.1 扫不出来从容错级别、颜色对比度、白边三个方面排查这个问题的出现频率最高。我整理了一个排查顺序从概率高的原因开始现象原因解决方案时好时坏尤其在光线差时识别失败容错级别太低至少用 M 级有遮挡用 Q/H 级深色背景、亮色模块或反色二维码扫描器对反色支持差尽量采用深色模块浅色背景二维码四周白边太小扫码器无法确认边界margin 参数加到 2 以上打印出来扫码失败打印分辨率不足或纸张纹路干扰提高打印分辨率至少 300dpi屏幕显示时扫不出来屏幕亮度、反射调亮屏幕并减少环境光反射还有一个“二维码缺口怎么调整”的问题其实是打印场景里经常遇到的。生成时数据没错但打印后出现白色断点或黑点这不是二维码本身的 bug而是打印机脏了或纸张受潮。可以先打一张测试页确认打印机状态。如果边缘锯齿明显检查打印设置里的图片缩放不要勾选“适应页面”否则会改变长宽比例。5.2 中文和特殊字符乱码怎么处理PHP 生成二维码时内容字符串必须是 UTF-8 编码否则生成出来的东西扫码会显示乱码。我在 Windows 下踩过坑PHP 文件本身有时是 GBK 编码字符串拼接出来直接就是 GBK二维码扫出来就是乱码。解决办法是编辑器统一把 PHP 文件保存为 UTF-8 无 BOM 格式。如果内容是 URL 地址建议生成前用urlencode处理参数部分。比如https://example.com/?uid1001fromqr直接把整段内容放进二维码扫码是能识别的但有些扫码器会忽略部分参数稳妥的做法是对参数值做 URL 编码或者把参数内容编码成短链再生成二维码。5.3 批量生成时超时和内存耗尽批量生成几百张还好超过 1000 张时我遇到过Maximum execution time of 30 seconds exceeded和Allowed memory size exhausted。原因和解决办法都很明确一是 PHP 默认执行时间太短在脚本开头加set_time_limit(0)二是 GD 图像资源没有及时释放循环里加imagedestroy($qr)。另外批量提交数据时max_input_vars默认只有 1000 个变量如果你用多个 input 字段提交一批数据很容易被这个限制截断。我的方案是用 textarea 一次提交全部内容换行分隔完美避开这个坑。5.4 PHP 环境报错速查表报错信息原因解决Call to undefined function imagecreate()GD 扩展未安装/未启用开启 php.ini 里的extensiongd2或重新编译安装QRcode::png(): Argument #4 ($size) must be ...size 参数类型不合法确保传入整数且范围在 1 到 20 之间mbstring is already loadedphp.ini 中重复加载模块检查 php.ini 和命令行配置是否重复保留一处mkdir(): Permission denied输出目录无写权限给目录配置写入权限程序内用is_dir()检查后创建最后再分享一个我自己一直在用的小技巧批量导出的文件名里加上日期、时间戳和内容哈希比如20260503_123000_1f3872a.png这样既能避免覆盖又方便追溯到是哪一批生成的数据。管理内部物料码时这个习惯能省不少事。做这个工具最大的体会是本地工具真正的价值不是省那几十块钱会员费而是数据安全可控、逻辑随时能改还能和内部系统无缝对接。现在这个 v1.0 已经从工具升级成了我内部系统里的一个模块商品录入时自动调用生成完直接归档。后面如果有时间我打算把前端摄像头扫码识别也加进去让生成和验证形成闭环。本文还有配套的精品资源点击获取
PHP本地二维码生成工具开发实战：从原理到批量导出
简介PHP二维码在线生成工具本地版v1.0是一份基于PHP源码的二维码生成方案主要面向需要在自己网站空间或本地环境生成二维码的开发者解决线上生成服务依赖外部接口、无法自定义部署的问题。程序采用当前时间与随机数组合的方式生成PNG图片路径可有效避免文件重复生成的图片保存在根目录单张体积约1K4K图片宽高会随文字数量自动变化实测生成包含200个汉字的二维码也能正常运行整体逻辑简洁适合内网环境、临时工具站或教学演示场景也便于按需修改样式或扩展功能。压缩包共7个文件以两个PHP核心脚本为主配以txt使用说明与URL参考链接另有png示例图包体仅25KB部署非常轻量上传至PHP网站空间后通过首页index.php即可使用子目录部署同样支持。目前已有280人学习下载适合具备基础PHP环境、希望快速搭建本地二维码生成功能的开发者参考。 做这个工具的直接原因很简单我给客户做小程序后台时每天要给几十个商品生成带渠道参数的二维码原来一直用在线二维码网站但用着用着问题就来了。最让我没法忍的是商品编号、渠道码这些内部数据都要先传到别人的服务器免费版还有各种限制一不注意就弹广告。后来我干脆自己用 PHP 写了一个本地版二维码在线生成工具v1.0 从开发到现在稳定跑了两个多月今天把完整实现思路、核心代码和踩坑记录都整理出来给同样需要本地生成二维码的朋友参考。这里的“在线”指的是浏览器访问本地服务实时生成不是 SaaS 服务。1. 为什么我弃用在线二维码网站自己写了个本地版1.1 在线生成器的四个痛点用在线网站生成二维码表面上省事实际用起来难受的地方不少。先说数据安全问题这是最核心的。我在给客户做商品渠道追踪时二维码内容里通常带着商品编号、内部物料编码、渠道参数有时候还有客户手机号这些东西一旦提交到第三方网站数据就脱离你控制了。虽然大多数网站声称不做存储但你没法验证出了问题就是自己的锅。第二个痛点是功能限制。免费版在线生成器基本只能改改内容、尺寸容错级别固定想加 logo、改颜色、批量生成全部要付费。我曾经为了一个项目连续开了三个月会员一个月几十块钱不算多但用起来总觉得亏。第三个痛点是稳定性不可控。在线服务哪天改版、域名变更、图片 CDN 挂了你历史生成的二维码图片就可能失效。二维码一旦打印出去用户扫码直接就打不开这种问题在线工具厂家不会替你负责。第四个痛点是效率。一次要生成一两百个二维码时用在线工具要么手动复制粘贴到网页要么一个个点下载效率非常低。有时还有验证码、登录、等待队列之类的东西批量场景下根本没法用。1.2 本地版的核心价值数据安全、离线可用、可二次开发自己写本地版之后以上四个问题基本都消失了。数据全程在本地 PHP 进程里处理不经过任何第三方服务器商品信息、渠道参数这些敏感数据可以放心用。服务跑在内网或者本机断网也能正常生成不用看别人脸色。另外最重要的是可二次开发。我后来把生成接口接进了内部商品管理后台商品入库时自动生成带渠道参数的二维码文件名按商品编码命名直接归档到服务器。在线工具根本做不到这种深度集成。1.3 v1.0 的功能边界与技术选型v1.0 我规划了这几个功能单张二维码生成、批量生成、自定义容错级别、自定义尺寸和留白、logo 合成、前端实时预览、批量打包下载。技术栈没有追新用了原生 PHP jQuery phpqrcode。phpqrcode 是网上很老牌的单文件 PHP 二维码库不需要 Composer适合本地小工具。如果你项目里用的是 ThinkPHP 3.2.3 这类老框架也可以直接把 qrlib.php 引入改成控制器方法即可代码思路完全一致。2. 二维码生成原理与 PHP 库选型2.1 黑白格子背后的数据编码与容错级别写生成工具之前我建议先花十分钟理解二维码的基本原理不然遇到“扫不出来”的问题会很被动。二维码本质上是一个二维矩阵把字符串按一定规则转成二进制再通过 Reed-Solomon 纠错算法加上冗余数据最终分布到矩阵的黑色和白色模块里。识别端扫码时先通过三个角上的回字定位图形确定方向和坐标系再读取矩阵里的数据反向还原出原始字符串。这里最需要关注的是容错级别。二维码分 L、M、Q、H 四个级别分别能容忍大约 7%、15%、25%、30% 的污损或遮挡。容错级别越高二维码图案越密识别越稳。给商品打码这种场景我默认用 M 级既能保证一定的抗污损能力图案密度也适中。如果要在二维码中间贴 logo就得用 Q 或者 H 级不然中央遮挡区域容易导致扫码失败。2.2 phpqrcode 与 endroid/qr-code 怎么选PHP 生成二维码的库主流就是 phpqrcode 和 endroid/qr-code 两个。我当时的选型对比是这样的对比项phpqrcodeendroid/qr-code安装方式手动 require 单文件Composer 安装PHP 版本要求PHP 5.6 即可要求 PHP 7.2部分版本更高依赖扩展GD 库GD、fileinfo 等输出格式PNG、SVGPNG、SVG、EPS、PDF 等Logo 合成需要自己用 GD 处理官方支持自带接口维护状态多年未更新功能稳定持续维护上手成本极低需要熟悉 Composer最终我选了 phpqrcode原因有三个一是本地服务器是 Windows 环境跑着老项目PHP 版本还停留在 5.6endroid 新版本直接装不上二是这个工具不需要复杂导出格式PNG 就够用三是 phpqrcode 单文件引入代码逻辑一目了然出问题好排查。2.3 本地环境准备PHP 版本、GD 扩展、目录权限开始前先确认环境。Windows 上我建议用 phpstudy 或 XAMPPLinux 直接用包管理器安装 php-gd。打开命令行输入php -m如果输出列表里没有 gd就需要安装或开启扩展。php -m | grep gd如果没有输出说明 GD 扩展没装好。我在 Windows 的 phpstudy 里遇到过一次原因很简单php.ini 里没有去掉extensiongd2前面的分号。如果你用 Docker 拉官方镜像比如php:7.4-apache也需要自己执行docker-php-ext-install gd安装扩展。另外要注意 output 目录的写权限。批量生成二维码时要写文件apache 或 php-fpm 运行用户必须对目标目录有写权限不然会报 “failed to open stream: Permission denied”。3. 核心实现单张生成、批量导出、Logo 合成、前端预览3.1 单张二维码接口20 行代码搞定phpqrcode 的核心方法只有一行QRcode::png()但直接调用会遇到一个输出问题这个方法默认把图片数据直接打印到浏览器不方便作为接口返回。我用输出缓冲把它截获再统一返回图片流。单张生成接口的完整代码?php require_once __DIR__ . /lib/phpqrcode/qrlib.php; $data $_GET[data] ?? hello; $size max(1, min((int)($_GET[size] ?? 10), 20)); $margin (int)($_GET[margin] ?? 2); $ec in_array($_GET[ec] ?? M, [L, M, Q, H]) ? $_GET[ec] : M; ob_start(); QRcode::png($data, false, $ec, $size, $margin); $png ob_get_clean(); header(Content-Type: image/png); header(Content-Length: . strlen($png)); echo $png;这段代码里几个参数要注意size 是每个模块的像素数取值范围在 1 到 20 之间实际图片边长大约是size * 模块数 2 * margin并不是说 size 越大内容越多。margin 是二维码四周白边的像素宽度这个值不能设成 0扫码器需要靠白边来确认边界一般保持 2 以上。3.2 批量生成一次导入几百条并打包下载批量生成是本地工具相对在线网站最明显的优势。我的实现是从 textarea 里读文本一行一条内容然后循环调用QRcode::png输出到指定目录最后用 ZipArchive 打包下载。核心代码?php require_once __DIR__ . /lib/phpqrcode/qrlib.php; $raw $_POST[data] ?? ; $lines explode(\n, $raw); $outDir __DIR__ . /output/ . date(YmdHis); if (!is_dir($outDir)) { mkdir($outDir, 0755, true); } foreach ($lines as $i $line) { $text trim($line); if ($text ) { continue; } $filename $outDir . / . $i . _ . md5($text) . .png; QRcode::png($text, $filename, QR_ECLEVEL_M, 10, 2); } $zip new ZipArchive(); $zipFile $outDir . .zip; $zip-open($zipFile, ZipArchive::CREATE | ZipArchive::OVERWRITE); foreach (glob($outDir . /*.png) as $file) { $zip-addFile($file, basename($file)); } $zip-close();这里我踩过一个坑如果直接用序号$i做文件名有两个内容不同的二维码在循环里都会生成同样名称的文件后生成的文件会覆盖先前的。后来加了md5($text)做指纹再加上序号前缀基本不会冲突。批量导出时如果一次几万条建议用set_time_limit(0)避免执行超时同时每处理完一个 unset 释放内存。3.3 Logo 与彩色二维码扫得出来才是关键默认生成的二维码是黑白的放在产品包装上比较丑所以 v1.0 加了 logo 合成和颜色自定义。logo 合成的原理很简单先生成二维码 PNG再用 GD 库把 logo 图片缩放后贴到二维码中央。?php $qr imagecreatefrompng($qrFile); $logo imagecreatefrompng($logoFile); $qrW imagesx($qr); $logoW (int)($qrW * 0.25); // logo边长控制在二维码的25% $logoH (int)(imagesy($logo) * $logoW / imagesx($logo)); $dstX (int)(($qrW - $logoW) / 2); $dstY (int)(($qrW - $logoH) / 2); imagecopyresampled($qr, $logo, $dstX, $dstY, 0, 0, $logoW, $logoH, imagesx($logo), imagesy($logo)); imagepng($qr, $qrFile);logo 大小一定要控制好边长不要超过二维码总尺寸的 30%。二维码的容错机制能容忍中央区域被遮挡但也有限度我实测过logo 如果超过 30%手机扫码时识别率会明显下降尤其是环境光线不好时基本就是报废状态。彩色二维码我最初想直接改 phpqrcode 源码后来发现不值得。phpqrcode 的QRcode::png()本身就支持$saveToFile参数但不支持自定义前景色。简单做法是生成灰度二维码后再用 GD 遍历像素替换颜色但性能一般。经验是二维码的三个定位角尽量保持深色不要做反色处理。很多人做“反色二维码”觉得酷把黑底白格或者用亮色当前景结果就是扫码器识别不了日常使用千万别这么干。3.4 前端不刷新页面实时出码v1.0 的前端用 jQuery 做实时预览绑定 input 的 input 事件防抖后请求 3.1 里的接口拿回 base64 图片直接替换 img 标签。这里关键是防抖不然用户每敲一个字符就请求一次本地服务压力不大但浏览器网络请求会乱掉。另外分享一个扩展场景有人想在背景图上拖拽二维码、调整大小后保存成一张新图片。这个需求本质上已经不是生成二维码而是图片合成。前端用 html2canvas 可以把 DOM 截图但高清输出比较麻烦字号和图片清晰度都不稳定。我更推荐的做法是后端接收坐标、尺寸、背景图参数用 GD 成图这样图片质量可控还能保存高清版本。v1.0 我把这个功能留到 v1.1 再做成独立模块。4. 完整实操把 v1.0 跑起来并集成到业务系统4.1 目录结构与部署步骤我最终的目录结构是这样的qr_tool/ ├── index.php ├── api.php ├── lib/ │ └── phpqrcode/ │ ├── qrlib.php │ └── ... ├── assets/ │ └── jquery.min.js └── output/部署步骤很简单把整个目录放到本地 Web 服务的站点根目录比如 phpstudy 的 www 目录或 Nginx 的 html 目录然后访问http://localhost/qr_tool/index.php。output 目录需要提前建好并确保有写权限。4.2 核心代码逐段解析index.php 核心是表单和实时预览我贴一段关键代码div classform-item label二维码内容/label input typetext idqr-data valuehttps://example.com / /div div classform-item label容错级别/label select idqr-ec option valueLL7%/option option valueM selectedM15%/option option valueQQ25%/option option valueHH30%/option /select /div img idqr-preview src alt二维码预览 / script var timer null; $(#qr-data, #qr-ec, #qr-size).on(input change, function () { clearTimeout(timer); timer setTimeout(loadQr, 300); }); function loadQr() { var data $(#qr-data).val(); var ec $(#qr-ec).val(); var size $(#qr-size).val(); $(#qr-preview).attr(src, api.php?data encodeURIComponent(data) ec ec size size); } /script几个细节内容输入框一定要用encodeURIComponent编码如果内容里带了、?这样的参数不编码会导致请求参数断裂。容错级别下拉框选中后立刻触发预览用户交互会比较顺手。4.3 性能测试与内存调优记录我本地压过一次生成一张纯文本二维码接口响应约 10ms肉眼感知就是瞬间。批量生成 100 张普通二维码写入文件方式总耗时大概 0.8 秒这个速度完全满足日常需求。批量场景下内存增长比较明显主要出现在 logo 合成阶段因为imagecreatefrompng会把整张图片载入内存如果大量并发内存很容易顶满。我的处理办法是每处理完一张就imagedestroy()释放资源。生成大量文件时建议分批处理比如每 500 张打包一个 zip避免单个 zip 文件过大导致下载超时。5. 常见问题与排查技巧实录5.1 扫不出来从容错级别、颜色对比度、白边三个方面排查这个问题的出现频率最高。我整理了一个排查顺序从概率高的原因开始现象原因解决方案时好时坏尤其在光线差时识别失败容错级别太低至少用 M 级有遮挡用 Q/H 级深色背景、亮色模块或反色二维码扫描器对反色支持差尽量采用深色模块浅色背景二维码四周白边太小扫码器无法确认边界margin 参数加到 2 以上打印出来扫码失败打印分辨率不足或纸张纹路干扰提高打印分辨率至少 300dpi屏幕显示时扫不出来屏幕亮度、反射调亮屏幕并减少环境光反射还有一个“二维码缺口怎么调整”的问题其实是打印场景里经常遇到的。生成时数据没错但打印后出现白色断点或黑点这不是二维码本身的 bug而是打印机脏了或纸张受潮。可以先打一张测试页确认打印机状态。如果边缘锯齿明显检查打印设置里的图片缩放不要勾选“适应页面”否则会改变长宽比例。5.2 中文和特殊字符乱码怎么处理PHP 生成二维码时内容字符串必须是 UTF-8 编码否则生成出来的东西扫码会显示乱码。我在 Windows 下踩过坑PHP 文件本身有时是 GBK 编码字符串拼接出来直接就是 GBK二维码扫出来就是乱码。解决办法是编辑器统一把 PHP 文件保存为 UTF-8 无 BOM 格式。如果内容是 URL 地址建议生成前用urlencode处理参数部分。比如https://example.com/?uid1001fromqr直接把整段内容放进二维码扫码是能识别的但有些扫码器会忽略部分参数稳妥的做法是对参数值做 URL 编码或者把参数内容编码成短链再生成二维码。5.3 批量生成时超时和内存耗尽批量生成几百张还好超过 1000 张时我遇到过Maximum execution time of 30 seconds exceeded和Allowed memory size exhausted。原因和解决办法都很明确一是 PHP 默认执行时间太短在脚本开头加set_time_limit(0)二是 GD 图像资源没有及时释放循环里加imagedestroy($qr)。另外批量提交数据时max_input_vars默认只有 1000 个变量如果你用多个 input 字段提交一批数据很容易被这个限制截断。我的方案是用 textarea 一次提交全部内容换行分隔完美避开这个坑。5.4 PHP 环境报错速查表报错信息原因解决Call to undefined function imagecreate()GD 扩展未安装/未启用开启 php.ini 里的extensiongd2或重新编译安装QRcode::png(): Argument #4 ($size) must be ...size 参数类型不合法确保传入整数且范围在 1 到 20 之间mbstring is already loadedphp.ini 中重复加载模块检查 php.ini 和命令行配置是否重复保留一处mkdir(): Permission denied输出目录无写权限给目录配置写入权限程序内用is_dir()检查后创建最后再分享一个我自己一直在用的小技巧批量导出的文件名里加上日期、时间戳和内容哈希比如20260503_123000_1f3872a.png这样既能避免覆盖又方便追溯到是哪一批生成的数据。管理内部物料码时这个习惯能省不少事。做这个工具最大的体会是本地工具真正的价值不是省那几十块钱会员费而是数据安全可控、逻辑随时能改还能和内部系统无缝对接。现在这个 v1.0 已经从工具升级成了我内部系统里的一个模块商品录入时自动调用生成完直接归档。后面如果有时间我打算把前端摄像头扫码识别也加进去让生成和验证形成闭环。本文还有配套的精品资源点击获取
