PHP项目中如何生成二维码？

wen PHP项目 2026-06-18 3

本文目录导读：

PHP项目中如何生成二维码？

使用第三方库（推荐）
使用在线API服务
纯PHP实现（不依赖外部库）
带有Logo的二维码
在PHP框架中使用
生成带中文的二维码
推荐方案
完整示例（使用phpqrcode）

在PHP项目中生成二维码,主要有以下几种常用方法：

使用第三方库（推荐）

phpqrcode（最常用）

// 1. 通过Composer安装
composer require phpqrcode/phpqrcode
// 2. 生成二维码
require_once 'vendor/autoload.php';
use Phpqrcode\QRcode;
// 简单生成
QRcode::png('https://example.com');
// 带参数的生成
$text = 'https://example.com';
$outfile = 'qrcode.png'; // 保存文件路径
$level = QR_ECLEVEL_L;    // 纠错等级
$size = 10;              // 大小
$margin = 4;             // 边距
QRcode::png($text, $outfile, $level, $size, $margin);

Endroid QR Code（功能更丰富）

// 1. 安装
composer require endroid/qr-code
// 2. 使用
use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;
$qrCode = QrCode::create('https://example.com')
    ->setSize(300)
    ->setMargin(10)
    ->setForegroundColor(new \Endroid\QrCode\Color\Color(0, 0, 0))
    ->setBackgroundColor(new \Endroid\QrCode\Color\Color(255, 255, 255));
$writer = new PngWriter();
$result = $writer->write($qrCode);
// 输出到浏览器
header('Content-Type: ' . $result->getMimeType());
echo $result->getString();
// 或者保存到文件
$result->saveToFile('qrcode.png');

使用在线API服务

// 例：使用api.qrserver.com
$url = 'https://api.qrserver.com/v1/create-qr-code/';
$params = [
    'size' => '200x200',
    'data' => 'https://example.com',
    'format' => 'png'
];
$qrcode_url = $url . '?' . http_build_query($params);
echo '<img src="' . $qrcode_url . '" alt="QR Code">';

纯PHP实现（不依赖外部库）

// 简单的QR码生成类
class QRGenerator {
    public static function generate($text, $size = 200) {
        // 使用Google Chart API
        $url = 'https://chart.googleapis.com/chart';
        $params = [
            'cht' => 'qr',
            'chs' => $size . 'x' . $size,
            'chl' => urlencode($text),
            'choe' => 'UTF-8',
            'chld' => 'L|0'
        ];
        return $url . '?' . http_build_query($params);
    }
}
// 使用
$qr_url = QRGenerator::generate('https://example.com', 300);
echo '<img src="' . $qr_url . '" alt="QR Code">';

带有Logo的二维码

use Endroid\QrCode\QrCode;
use Endroid\QrCode\Writer\PngWriter;
use Endroid\QrCode\Logo\Logo;
$qrCode = QrCode::create('https://example.com')
    ->setSize(400);
$logo = Logo::create('path/to/logo.png')
    ->setResizeToWidth(60);
$writer = new PngWriter();
$result = $writer->write($qrCode, $logo);
$result->saveToFile('qrcode-with-logo.png');

在PHP框架中使用

Laravel

// 使用laravel-qr-code包
composer require simplesoftwareio/simple-qrcode
// 在控制器中
use SimpleSoftwareIO\QrCode\Facades\QrCode;
// 生成并显示
return QrCode::size(250)->generate('https://example.com');
// 带颜色的二维码
return QrCode::size(250)
    ->backgroundColor(255, 255, 255)
    ->color(0, 0, 0)
    ->generate('https://example.com');

ThinkPHP

// 安装扩展
composer require dh2y/think-qrcode
// 使用
use dh2y\qrcode\QRcode;
$qr = new QRcode();
$qr->png('https://example.com');

生成带中文的二维码

// 确保使用UTF-8编码
$text = '你好，世界！';
$text = urlencode($text); // 一些库需要URL编码
// 使用Endroid库
$qrCode = QrCode::create('你好，世界！')
    ->setEncoding('UTF-8')
    ->setSize(300);
// 使用phpqrcode
QRcode::png('你好，世界！', false, QR_ECLEVEL_L, 10);

完整示例（使用phpqrcode）

<?php
require_once 'vendor/autoload.php';
use Phpqrcode\QRcode;
class QRCodeGenerator {
    /**
     * 生成并输出二维码
     * @param string $text 二维码内容
     * @param int $size 图片大小
     */
    public static function output($text, $size = 200) {
        header('Content-Type: image/png');
        QRcode::png($text, false, QR_ECLEVEL_L, $size, 2);
    }
    /**
     * 保存二维码到文件
     * @param string $text 二维码内容
     * @param string $filename 文件名
     * @param int $size 图片大小
     */
    public static function save($text, $filename, $size = 200) {
        QRcode::png($text, $filename, QR_ECLEVEL_L, $size, 2);
    }
    /**
     * 生成base64编码的二维码
     * @param string $text 二维码内容
     * @param int $size 图片大小
     * @return string base64数据
     */
    public static function toBase64($text, $size = 200) {
        ob_start();
        QRcode::png($text, false, QR_ECLEVEL_L, $size, 2);
        $imageData = ob_get_contents();
        ob_end_clean();
        return 'data:image/png;base64,' . base64_encode($imageData);
    }
}
// 使用示例
$text = 'https://example.com';
// 直接输出到浏览器
QRCodeGenerator::output($text);
// 保存到文件
QRCodeGenerator::save($text, 'qrcode.png');
// 生成base64
$base64 = QRCodeGenerator::toBase64($text);
echo '<img src="' . $base64 . '">';
?>

选择合适的方案取决于你的项目需求、复杂程度和可维护性要求。