当前位置：首页 > article >正文

wordpress开发之实现使用第三方库qrcode-generator生成二维码并上传和展示

article 2025/1/7 19:40:03

文章目录

- 一、需求
- 二、技术实现 - 利用qrcode-generator库
- 三、代码实现

一、需求

客户的需求是能将特定的url生成二维码，以便将二维码分享或贴到合同纸上给他的客户扫描查看信息。

这个url包含的内容类似于如下格式：

https://www.example.com/contract?bhid=HXDB-L-2024121503&bhcode=Swf3

效果如下：

二维码效果

二、技术实现 - 利用qrcode-generator库

我用的是wordpress，基于PHP，而且需要将二维码上传到服务器，并且写入到数据库中。所以最好的方式就是直接用PHP来写功能，而不是JS来实现。

能生成二维码的库不少，其中有一个不错，简单易用：qrcode-generator（https://github.com/kazuhikoarase/qrcode-generator）。

它可以用你最喜欢的编程语言来生成二维码，JS，java，PHP等都可以生成，案例地址：https://kazuhikoarase.github.io/qrcode-generator/js/demo/.

那么如何生成呢，我的思路就是，在保存保函的时候，通过wp的保存文章的钩子函数save_post调用二维码生成函数，生成二维码后，存储图片到服务器中，返回url写入到对应保函记录中。

三、代码实现

在wp的主题下，有个function.php，它允许开发者为主题添加功能、修改默认行为以及注册新的功能或功能模块等。比如我刚刚说的保函即为一种自定义文章类型，在该类型下，来生成保函信息和二维码的查询url等。

如果你还不了解wp的function.php的作用，可以看这篇文章：https://blog.csdn.net/imqdcn/article/details/144529634

完成生成二维码图片，上传到服务器，并返回图片url的核心代码如下：

1、到qrcode-generator 的github仓库中下载 qrcode.php库，并且放在主题的inc文件夹下（你也可以放在主题根目录下）

然后在funnction.php中导入：

require_once get_template_directory() . '/inc/qrcode.php';

2、实现保存文章的钩子函数

function generate_qr_on_save($post_id) {
    // 检查是否是自动保存，防止重复执行
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }
    // 检查是否是特定的文章类型（可选）
    if (get_post_type($post_id) == 'baohan') {
        // echo '正在生成二维码...';
        // 获取文章的 bhid 和 bhcode 元数据
        $bhid = get_post_meta($post_id, 'bhid', true);
        $bhcode = get_post_meta($post_id, 'bhcode', true);
        // 确保必要数据存在
        if (empty($bhid) || empty($bhcode)) {
            return;
        }
        // 拼接要生成二维码的url
        $url =  home_url() . '/baohan';
        $search = "bhid={$bhid}&bhcode={$bhcode}";
        $qr_content = $url . '?' . $search;
        // 生成二维码图像
        $qr = QRCode::getMinimumQRCode($qr_content, QR_ERROR_CORRECT_LEVEL_L);
        $im = $qr->createImage(4, 4);

        // 保存二维码到文件
        $upload_dir = wp_upload_dir();
        $file_path = $upload_dir['path'] . '/qr_' . $post_id . '.gif'; // 文件名以文章ID命名避免冲突
        imagegif($im, $file_path);
        imagedestroy($im);

        // 检查文件是否保存成功
        if (file_exists($file_path)) {
            // 构建二维码的 URL
            $qr_url = $upload_dir['url'] . '/qr_' . $post_id . '.gif';
            // 保存二维码 URL 到文章的 qrCode 元数据
            update_post_meta($post_id, 'qrCode', $qr_url);
        } else {
            error_log("Failed to save QR code for Post ID $post_id.");
        }
    }
}
add_action('save_post', 'generate_qr_on_save');

这样就可以保存二维码到wp的上传目录，且写入该二维码的url到当前文章的qrCode字段了。

因为我不需要在媒体库中管理，所以，并没有调用上传到媒体库的钩子函数，无法在后台的媒体库中看到。

3、如何显示到wp的管理后台（如图一效果）

只需要在遍历列表时，添加如下判断：

$qr_url = get_post_meta( $post->ID, 'qrCode', true );
if($qr_url){
    echo "<img src='{$qr_url}' width='100' height='100' />";
}else{
    echo "编辑或新建后保存一次，二维码才会生成";
}