如何用PHP快速搭建二维码生成API（完整教程）-阿南达文事网

如何用PHP快速搭建二维码生成API（完整教程）

前言

在移动互联网时代，二维码已成为连接线上线下的重要桥梁。本文将手把手教你如何使用PHP快速搭建一个高性能的二维码生成API，无需复杂配置，5分钟即可上线！

如何将Base64编码的二维码转换为可访问的图片链接（完整指南）

一、技术选型

我们采用目前最稳定的方案：

PHP (7.4+推荐)
Endroid QR Code 开源库
Composer 依赖管理

二、环境准备

确保服务器已安装PHP环境安装Composer：

代码语言：javascript代码运行次数：0运行复制

curl -sS  | php
mv composer.phar /usr/local/bin/composer

三、完整实现代码

代码语言：javascript代码运行次数：0运行复制

<?php
header('Content-Type: application/json; charset=utf-8');
ini_set('display_errors', 0);

try {
    // 接收参数
    $data = $_GET['data'] ?? '';
    $size = min(1000, intval($_GET['size'] ?? 300));
    $margin = intval($_GET['margin'] ?? 4);
    $level = strtoupper($_GET['level'] ?? 'L');
    
    // 验证依赖
    if (!file_exists(__DIR__.'/vendor/autoload.php')) {
        throw new Exception('请先运行 composer install');
    }

    require __DIR__.'/vendor/autoload.php';
    
    // 错误校正级别映射
    $levelMap = [
        'L' => new Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelLow(),
        'M' => new Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelMedium(),
        'Q' => new Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelQuartile(),
        'H' => new Endroid\QrCode\ErrorCorrectionLevel\ErrorCorrectionLevelHigh()
    ];

    if (!isset($levelMap[$level])) {
        throw new Exception('容错级别仅支持 L/M/Q/H');
    }

    // 生成二维码
    $qrCode = new Endroid\QrCode\QrCode($data);
    $qrCode->setSize($size);
    $qrCode->setMargin($margin);
    $qrCode->setErrorCorrectionLevel($levelMap[$level]);

    $writer = new Endroid\QrCode\Writer\PngWriter();
    $result = $writer->write($qrCode);

    // 返回结果
    echo json_encode([
        'status' => 'success',
        'data' => 'data:image/png;base64,'.base64_encode($result->getString())
    ]);

} catch (Exception $e) {
    echo json_encode([
        'status' => 'error',
        'message' => $e->getMessage()
    ]);
}
exit;

四、安装与部署

代码语言：javascript代码运行次数：0运行复制

mkdir qr-api && cd qr-api

安装依赖

代码语言：javascript代码运行次数：0运行复制

composer require endroid/qr-code

将上述代码保存为 api.php
配置Web服务器（以Nginx为例）：

代码语言：javascript代码运行次数：0运行复制

server {
    listen 80;
    server_name yourdomain;
    root /path/to/qr-api;
    
    location / {
        try_files $uri /api.php;
    }
}

五、API使用说明

请求方式

代码语言：javascript代码运行次数：0运行复制

GET /api.php?data=内容&size=尺寸&margin=边距&level=容错级别

参数说明

参数	必填	说明
data	否	编码内容（默认：）
size	否	图片尺寸px（默认300，最大1000）
margin	否	边距px（默认4）
level	否	容错级别L/M/Q/H（默认L）

成功响应

代码语言：javascript代码运行次数：0运行复制

{
    "status": "success",
    "data": "data:image/png;base64,..."
}

错误响应

代码语言：javascript代码运行次数：0运行复制

{
    "status": "error",
    "message": "错误信息"
}

六、实际应用示例

生成普通二维码

代码语言：javascript代码运行次数：0运行复制

/api.php?data=

生成带LOGO的二维码（进阶）

代码语言：javascript代码运行次数：0运行复制

// 在生成代码后添加：
$logo = imagecreatefrompng('logo.png');
$qr = imagecreatefromstring($result->getString());
// ...合并图片逻辑...

前端调用示例

代码语言：javascript代码运行次数：0运行复制

<img src="/api.php?data=HelloWorld&size=200" 
  alt="二维码">

七、性能优化建议

缓存机制：对相同参数请求缓存结果
CDN加速：配置CDN缓存静态资源
限制频率：防止API被滥用
异步生成：高并发时考虑队列处理

八、常见问题解答

Q：为什么返回的是Base64而不是直接图片？ A：便于API统一返回JSON格式，前端可直接用于img标签的src属性

Q：如何提高容错率？ A：使用level=H参数，但会增大二维码尺寸

Q：支持中文内容吗？ A：完全支持，会自动进行URL编码处理

结语

通过这个不足 50 行的PHP脚本，我们实现了一个功能完备的二维码生成API。相比第三方服务，自建API具有以下优势：

数据完全自主可控
无调用次数限制
可深度定制功能
成本几乎为零

建议将此API部署在你的服务器上，为你的应用快速添加二维码生成能力！

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。原始发表：2025年04月04日，如有侵权请联系 cloudcommunity@tencent 删除教程配置phpapi二维码

如何用PHP快速搭建二维码生成API（完整教程）