这是一个把链接转成二维码图片的 PHP 接口,调用方传一个 URL,服务端直接返回一张 PNG 图。

整套只有 44 个文件、3.4MB,接口本体不足 1KB,其余全是二维码库和前端模板资源。

定位不是成品网站,而是可以嵌进任何项目的二维码生成端点,img 标签直接引用就能出图。

源码简介

assets 里另有 fontawesome 全套 webfonts,五种格式各一份,占了包里大头体积。

文件结构三层,根目录一个演示页 index.html,api 目录两个 PHP,assets 目录放样式脚本与字体。

api/index.php 只有 984 字节,取 GET 参数、拼颜色数组、调库输出图片,逻辑一眼到底。

api/QRcode.php 是 107408 字节的 phpqrcode 库,版本 1.1.4,LGPL 3 协议,来自 sourceforge 的成熟开源项目。

前端模板是 HTML5 UP 的 Eventually,CCA 3.0 许可,个人与商用都免费,样式源文件 19 个 scss 完整保留。

images 目录三张 webp 约 400KB,是演示背景图,与功能本身无关。

适用场景

自己项目里要加二维码功能的,拿这个接口当参考,比装Composer包起微服务轻得多。

做短链、支付、分享落地页的,服务端出图省掉前端库,img 一挂就完事。

学习 HTTP 内容协商基础的,这个 984 字节的接口把参数校验、头声明、二进制输出讲清楚了。

功能亮点

接口收四个参数,c 二维码内容、s 每像素点数默认 7、bc 背景色、fc 前景色,颜色用 rgba 逗号分隔传入。

中文内容实测正常,URL 编码后传入你好世界直接出图,返回 311 字节 PNG。

纠错等级 QR_ECLEVEL_L 即最低档 7%,换取同尺寸下最大容量,1200 字符的长链接照样出图。

库自带字节级缓存与 mask 评分选择,phpqrcode 十年间被大量项目验证过,边界情况稳。

相关源码推荐

需要图形化批量生成与识别的,看站内的 QRStudio 二维码生成器源码。

扫码场景应用侧的例子是 扫码挪车工具 Nodejs 源码。

要带权限管理的后台集成,可以搭配 TLAdmin 中后台管理框架源码。

技术架构与部署指南

技术栈与运行环境

纯原生 PHP,无框架、无 Composer 依赖、无数据库,phpqrcode 只需要 GD 扩展或 imagick 出图。

PHP 5.4 以上的任何版本都能跑,虚拟主机、宝塔、Docker 均直接部署。

前端零构建,scss 源文件只是留着,运行的是编译好的 main.css 与两个 js。

安装与部署提示

把整个目录丢进任何能解析 PHP 的站点根,api 端点即位于 /api/?c=链接,浏览器直接访问就能出图。

本地验证用 php -S 127.0.0.1:8888 加目录参数即可,实测接口返回真 PNG、IEND 结尾完整。

引用的字体是 Google Fonts 的 Roboto,境内访问建议把 main.css 里那行 import 改掉或本地化。

不需要 writeable 目录,phpqrcode 的临时文件走系统 tmp,权限保持默认即可。

截图与演示说明

PHP二维码生成接口源码 轻量QRCode工具源码

演示页是一个居中的输入框加生成按钮,输入 URL 点生成,下方挂出 200 宽的二维码图。

图片直接来自 api/?c=编码后的URL,浏览器把接口响应当 img 源渲染,没有任何中间页。

接口本质是内容协商示例,实测响应头声明与真实字节类型不一致,细节见下文风险提示。

三张 webp 演示图在背景轮播里展示,删掉不影响接口功能。

常见问题

问:二维码能存手机浏览器收藏直接当工具用吗?

可以,页面与接口都是静态逻辑,部署后收藏即用,无账号无状态。

问:想改默认大小和颜色怎么办?

s、bc、fc 走 URL 参数即可,不动代码;要改默认值就编辑 api/index.php 顶部三个赋值行。

问:为什么不传参数也出图?

源码里 c 缺省兜底是一个第三方网址,属于作者留的引流默认值,二开时建议改成报错或自己的地址。

问:商用要付费吗?

phpqrcode 是 LGPL 3 不用付费但要保留版权声明,模板 CCA 3.0 也允许商用,保留原始署名即可。

安全风险提示

c 参数没有长度上限,实测 1200 字符出 3301 字节图,恶意灌超长内容会放大 CPU 与带宽开销,公网部署建议在前面加一层长度与 QPS 限制。

bc 传非法值(如 abc)接口静默按默认处理不报错,颜色数组越界同样被库吞掉,生产环境要么显式校验要么接受这个行为。

源码注释声明响应头是 image/jpg,实际返回 image/png,浏览器能出图但严格的内容校验方可能判类型不符,部署后建议把这行 header 改成与真实字节一致。

不传 c 时默认内容是第三方引流域名 www.365ym.com,页脚还有 yuanmakezhan.com 外链,拿到源码先替换这两处。

接口可把任意 URL 转成二维码,被用于钓鱼链接包装是这类工具的通用风险,公开部署需自担内容责任。

main.css 远程 import Google Fonts,境内环境会拖慢首屏且有请求出境问题,建议本地化字体文件。

二维码生成加默认跳转的组合是灰产活码的标准特征,实测本包在百度网盘生成分享后会被内容复审撤销,属平台风控拦截,二开改掉默认兜底后可自行重试分享。

下载说明

本源码仅供学习研究与技术参考,请勿用于商业售卖或二次转售。

phpqrcode 遵循 LGPL 3,模板遵循 CCA 3.0,二次分发请保留两份原始版权声明。

因使用本接口生成的内容引发的纠纷,由部署方自行承担。

下载与部署前,请再次阅读上文的安全风险提示。