推荐使用Endroid\QrCode库生成二维码,支持自定义样式与缓存优化。通过Composer安装后,可创建二维码对象并设置大小、边距,使用PngWriter输出至浏览器或保存为文件;支持嵌入Logo提升美观性,需注意Logo尺寸避免影响扫描;对高频访问场景,可采用文件或Redis缓存已生成图片路径,减少重复生成开销,提升性能。

PHP生成二维码图片在实际开发中很常见,比如用于微信扫码登录、支付、分享链接等场景。实现方式主要是借助成熟的开源库,将文本内容(如URL)转换为二维码图像。下面介绍常用的PHP二维码生成库及其使用方法。
常用PHP二维码生成库推荐
目前社区广泛使用的库有以下几种:
- Endroid\QrCode:基于Symfony组件,功能全面,支持颜色、logo嵌入、大小调整等,适合现代PHP项目。
- chillerlan/php-qrcode:轻量高效,支持多种输出格式,性能好,适合对速度要求高的场景。
- BaconQrCode:由Bacon团队开发,纯PHP实现,兼容性好,但功能相对基础。
推荐使用 Endroid\QrCode,文档完善,易于扩展,适合大多数业务需求。
Endroid\QrCode 使用示例
通过 Composer 安装库:
立即学习“PHP免费学习笔记(深入)”;
composer require endroid/qr-code生成二维码并直接输出到浏览器:
require_once 'vendor/autoload.php';use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;
// 创建二维码对象
$qrCode = new QrCode('https://example.com');
// 设置基本属性
$qrCode->setSize(300);
$qrCode->setMargin(10);
// 使用PNG写入器
$writer = new PngWriter();
$result = $writer->write($qrCode);
// 输出到浏览器
header('Content-Type: '.$result->getMimeType());
echo $result->getString();
如果想保存到服务器文件:
$result->saveToFile(__DIR__.'/qrcode.png');
添加Logo和自定义样式
Endroid\QrCode 支持在二维码中心嵌入小图标,提升识别度和美观性。
use Endroid\QrCode\Logo\Logo;$logo = Logo::create(__DIR__.'/logo.png')
->setResizeToWidth(80);
$result = $writer->write($qrCode, null, $logo);
$result->saveToFile(__DIR__.'/qrcode_with_logo.png');
注意:Logo不宜过大,避免遮挡关键区域影响扫描。
设置缓存避免重复生成
对于访问频繁的二维码,可结合文件或Redis缓存已生成的图片路径,减少重复计算。
简单文件缓存逻辑示例:
$cacheFile = __DIR__.'/qrcodes/'.md5($text).'.png';if (!file_exists($cacheFile)) {
// 生成并保存
$qrCode = new QrCode($text);
$result = $writer->write($qrCode);
$result->saveToFile($cacheFile);
}
// 直接输出缓存文件
readfile($cacheFile);
基本上就这些。选择合适的库,再根据业务需求调整样式和缓存策略,就能稳定地在PHP项目中集成二维码生成功能。











