前言
在移动互联网时代，二维码已成为连接线上线下的重要桥梁。本文将手把手教你如何使用PHP快速搭建一个高性能的二维码生成API，无需复杂配置，5分钟即可上线！
如何将Base64编码的二维码转换为可访问的图片链接（完整指南）
一、技术选型
我们采用目前最稳定的方案：
- PHP (7.4+推荐)
- Endroid QR Code 开源库
- Composer 依赖管理
二、环境准备
确保服务器已安装PHP环境
安装Composer：
|
1 2 |
curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer |
三、完整实现代码
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 |
<?php header('Content-Type: application/json; charset=utf-8'); ini_set('display_errors', 0); try { $data = $_GET['data'] ?? 'https://www.uctb.cn'; $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; |
四、安装与部署
- 创建项目目录
|
1 |
mkdir qr-api && cd qr-api |
- 安装依赖
|
1 |
composer require endroid/qr-code |
- 将上述代码保存为 api.php
- 配置Web服务器（以Nginx为例）：
|
1 2 3 4 5 6 7 8 9 |
server { listen 80; server_name yourdomain.com; root /path/to/qr-api; location / { try_files $uri /api.php; } } |
五、API使用说明
请求方式
|
1 |
GET /api.php?data=内容&size=尺寸&margin=边距&level=容错级别 |
参数说明
成功响应
|
1 2 3 4 |
{ "status": "success", "data": "data:image/png;base64,..." } |
错误响应
|
1 2 3 4 |
{ "status": "error", "message": "错误信息" } |
六、实际应用示例
生成普通二维码
|
1 |
/api.php?data=https://example.com |
生成带LOGO的二维码（进阶）
|
1 2 3 4 |
$logo = imagecreatefrompng('logo.png'); $qr = imagecreatefromstring($result->getString()); |
前端调用示例
|
1 2 |
<img src="/api.php?data=HelloWorld&size=200" alt="二维码"> |
七、性能优化建议
八、常见问题解答
Q：为什么返回的是Base64而不是直接图片？
A：便于API统一返回JSON格式，前端可直接用于img标签的src属性
Q：如何提高容错率？
A：使用level=H参数，但会增大二维码尺寸
Q：支持中文内容吗？
A：完全支持，会自动进行URL编码处理
结语
通过这个不足 50 行的PHP脚本，我们实现了一个功能完备的二维码生成API。相比第三方服务，自建API具有以下优势：
- 数据完全自主可控
- 无调用次数限制
- 可深度定制功能
- 成本几乎为零
建议将此API部署在你的服务器上，为你的应用快速添加二维码生成能力！
