PHP如何实现二维码生成_二维码生成代码编写详解

蓮花仙者

发布时间：2025-09-21 14:45:01

961人浏览过

来源于php中文网

原创

推荐使用endroid/qr-code库，因其功能全面、支持高纠错级别、自定义颜色与Logo嵌入，并确保足够对比度与尺寸以保障扫描成功率。

php如何实现二维码生成_二维码生成代码编写详解

PHP实现二维码生成的核心在于利用成熟的第三方库，这些库将我们提供的文本或URL数据，通过特定的编码算法转换成点阵图，最终以图像格式（如PNG、JPG、SVG）输出。这省去了我们从零开始理解二维码编码标准（如ISO/IEC 18004）的复杂性，让开发者能快速集成此功能。

解决方案

在PHP生态中，生成二维码最常用且推荐的库是

endroid/qr-code

。它功能全面，支持多种输出格式、自定义样式，并且易于使用。

1. 安装

endroid/qr-code

通过 Composer 是最便捷的安装方式。在你的项目根目录执行：

立即学习“PHP免费学习笔记（深入）”；

composer require endroid/qr-code

2. 基本用法

以下是一个生成最基础PNG格式二维码的例子：

setErrorCorrectionLevel(ErrorCorrectionLevel::High) // 设置纠错级别，这里是高
    ->setSize(300) // 设置图片尺寸，单位像素
    ->setMargin(10); // 设置边距

// 创建写入器，这里使用PNG格式
$writer = new PngWriter();

// 输出二维码到浏览器或保存到文件
header('Content-Type: '.$qrCode->getContentType());
echo $writer->write($qrCode)->getString();

// 或者保存到文件
// $writer->write($qrCode, 'qrcode.png');

?>

这段代码首先引入了必要的类，然后创建了一个

QrCode

对象，传入了要编码的URL。

setErrorCorrectionLevel

是一个关键参数，它决定了二维码的容错能力。

setSize

和

setMargin

则控制了生成图像的尺寸和留白。最后，通过

PngWriter

将二维码数据渲染成PNG图片并直接输出到浏览器。实际操作时，你可能更倾向于将其保存为文件，或者将其嵌入到HTML页面中。

PHP生成二维码时，如何选择合适的库？

选择PHP二维码生成库，我通常会考虑几个点：功能丰富度、社区活跃度、维护状态以及与现有项目的兼容性。市面上主流的两个库是

endroid/qr-code

和

phpqrcode

。

endroid/qr-code

是我个人更倾向推荐的。它是一个现代化的库，完全遵循PSR标准，这意味着它更容易与现代PHP框架（如Laravel, Symfony）集成。它的API设计得非常灵活，支持多种输出格式（PNG, JPG, SVG, WebP），并且在自定义方面表现出色，比如可以轻松添加Logo、改变颜色、设置边框等等。社区活跃，文档清晰，遇到问题也比较容易找到解决方案。如果你追求更强的可定制性和未来可维护性，这个库无疑是首选。

phpqrcode

则是一个相对较老的库。它的优点是轻量级，核心代码简单，对于只需要生成基本二维码，不需要太多花哨功能的项目来说，可能更直接一些。但它在自定义样式方面就显得力不从心了，而且维护更新频率不如

endroid/qr-code

活跃。如果你的项目比较老旧，或者对依赖有严格限制，

phpqrcode

也是一个可以考虑的选项。

说到底，选择哪个库，还得看你的具体需求。如果只是快速生成一个黑白二维码，

phpqrcode

也能胜任；但如果需要嵌入Logo、自定义颜色、或者未来可能需要更高级的功能，那么投入

endroid/qr-code

绝对是值得的。

如何在二维码中嵌入Logo或自定义样式？

给二维码加点“个性”，比如嵌入公司Logo或者改变颜色，能让它更符合品牌形象。

endroid/qr-code

在这方面做得相当出色，几乎所有你想要的自定义都能实现。

1. 嵌入Logo

嵌入Logo是提升品牌识别度的好方法。但要记住，Logo会遮挡一部分二维码数据，所以必须提高纠错级别，以保证二维码的可扫描性。通常，Logo的面积不应超过二维码总面积的20%到30%。

data('https://your-company-website.com')
    ->encoding(new Encoding('UTF-8'))
    ->errorCorrectionLevel(ErrorCorrectionLevel::High) // 必须是高纠错级别
    ->size(300)
    ->margin(10)
    ->writer(new PngWriter())
    ->logoPath(__DIR__.'/logo.png') // 指定Logo图片路径
    ->logoResizeToWidth(80) // Logo宽度
    ->logoResizeToHeight(80) // Logo高度
    ->logoPunchoutBackground(true) // 如果Logo背景是透明的，可以打孔
    ->build();

// 输出到浏览器
header('Content-Type: '.$result->getMimeType());
echo $result->getString();

// 或者保存文件
// $result->saveToFile(__DIR__.'/qrcode_with_logo.png');
?>

这里我用了

Builder

模式，它让代码看起来更流畅。

logoPath

指定了Logo图片的位置，

logoResizeToWidth

和

logoResizeToHeight

则控制了Logo在二维码中的尺寸。

logoPunchoutBackground(true)

在Logo区域挖空背景，防止Logo与二维码模块重叠，这对于非透明背景的Logo尤其有用。

2. 自定义颜色

改变二维码的前景色和背景色也很简单：

data('https://colorful-qr.com')
    ->encoding(new Encoding('UTF-8'))
    ->errorCorrectionLevel(ErrorCorrectionLevel::Medium)
    ->size(300)
    ->margin(10)
    ->writer(new PngWriter())
    ->foregroundColor(new Color(0, 0, 255)) // 前景色：蓝色
    ->backgroundColor(new Color(255, 255, 0)) // 背景色：黄色
    ->build();

header('Content-Type: '.$result->getMimeType());
echo $result->getString();
?>

foregroundColor

和

backgroundColor

接受

Color

对象，你可以传入RGB值来定义任何颜色。需要注意的是，为了保证可扫描性，前景色和背景色之间必须有足够的对比度。高对比度（比如黑白）总是最稳妥的选择。

bee餐饮点餐外卖小程序

bee餐饮点餐外卖小程序是针对餐饮行业推出的一套完整的餐饮解决方案，实现了用户在线点餐下单、外卖、叫号排队、支付、配送等功能，完美的使餐饮行业更高效便捷！功能演示：1、桌号管理登录后台，左侧菜单 “桌号管理”，添加并管理你的桌号信息，添加以后在列表你将可以看到 ID 和密钥，这两个数据用来生成桌子的二维码2、生成桌子二维码例如上面的ID为 308，密钥为 d3PiIY，那么现在去左侧菜单微信设置

下载