动态二维码生成器PHP Dynamic QRcode

什么是 PHP Dynamic QRcode ?

PHP Dynamic QRcode 是一个允许生成和保存动态和静态二维码(QR码)的应用。它具有简洁、响应灵敏且用户友好的设计。其中包含您网站中可能需要的一般功能,如:记录管理(CRUD)、安全身份验证、分页、过滤器。

什么是 Dynamic Qr codes ?

Dynamic Qr codes 具有可修改的目的地 URL。动态二维码的目的地是可以随时更改——即使您的营销材料已经打印出来。这将节省重印成本和精力,并使您能够尽快对活动中的任何更改做出响应。

什么是 Static Qr codes ?

Static Qr codes 有一个固定的目标 URL。静态二维码中编码的信息是固定的。目的地/数据直接存储在二维码图形中(因此,如果要存储更多数据,二维码也会越来越大,并形成更复杂的模式)。因此,无法更改存储的目的地/数据。与任何其他打印材料一样,已经打印的二维码中的任何拼写错误都无法更改。通过本应用,您可以创建 13种不同类型的静态二维码。

这个项目老苏很早就关注了,刚开始没有 Docker 版本,老苏尝试过自己构建镜像,但是在数据库设置完成后有报错。最近看了一下,官方已经提供了 Dockerfile ,但是必须本地编译,而不能从 docker hub 下载。这对大部分人来说,不是一件容易的事情

虽然官方有计划,但是都快过去半年了,还是没有可供下载的镜像,所以只能自己动手,来丰衣足食了。不过老苏水平有限,毕竟不是程序员,一些异常没有代码的配合也不知道如何处理,只能严格按顺序操作了,如果出错了就删了重来吧

结果并不重要,重要的是我们动手折腾了 😂

构建镜像

如果你不想自己构建,可以跳过,直接阅读下一章节

Dockerfile

官方提供了 Dockerfile ,但需要我们自己编。

1、为了加快构建速度,在 RUN apt-get update 之前,插入了下面👇这段,将默认源改为了阿里源

1
2
3
4
# 改阿里源    
RUN sed -i "s@http://deb.debian.org@http://mirrors.aliyun.com@g" /etc/apt/sources.list
RUN cat /etc/apt/sources.list
RUN rm -Rf /var/lib/apt/lists/*

2、另外给 github 的源码地址前挂了 ghproxy,目的都是为了加快构建的速度,对本身功能没有任何影响

3、修改了对外暴露的端口,从 80 改为了 3080,不改的话会遇到 (13)Permission denied: AH00072: make_sock: could not bind to address 0.0.0.0:80 错误

4、因为新增了 ports.confservername 文件,所以要新增两行

1
2
COPY ./config/ports.conf /etc/apache2/ports.conf  
COPY ./config/servername.conf /etc/apache2/conf-available/servername.conf

5、 启用了 docker-entrypoint.sh 文件

6、源码中 read.php 在根目录,原 Dockerfile 处理漏了,会出现错误

因此需要单独处理

1
&& cp -r /app/read.php /var/www/html \

7、 config/environment.php.example 需命名为 config/environment.php

修改后的 Dockerfile 及相关文件,都放在了 https://github.com/wbsu2003/Dockerfile/blob/main/PHP-Dynamic-Qr-code

vhost.conf

监听的端口要做相应的调整

config/vhost.conf 中,将 <VirtualHost *:80> 端口改为 <VirtualHost *:3080>

ports.conf

这个文件只要一行就可以

1
Listen 3080

servername.conf

这个文件也只要一行就可以

1
ServerName localhost

但是实际上可能并未生效,因为镜像中还是有警告,但不影响使用

1
AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.4. Set the 'ServerName' directive globally to suppress this message

docker-entrypoint.sh

修改成下面这样,目的是:

  1. 替换 servername.conf 中的 localhost 为环境变量 WEB_URL 传入的值,就像我前面说的,可能未生效,主要还是不了解 apache
  2. 替换 read.php 中的 include 路径,从 qrcode/config/config.php 改为 config/config.php
1
2
3
4
5
6
7
#!/bin/bash  

find '/etc/apache2' -name '*.conf' -exec sed -i -e 's,localhost,'"$WEB_URL"',g' {} \;

find '/var/www/html' -name 'read.php' -exec sed -i -e 's,qrcode/config,config,g' {} \;

exec apache2-foreground

构建流程

构建服务端镜像的基本命令如下👇

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
# 直接下载代码
git clone https://github.com/giandonatoinverso/PHP-Dynamic-Qr-code.git

# 通过代理下载原代码
git clone https://ghproxy.com/github.com/giandonatoinverso/PHP-Dynamic-Qr-code.git

# 进入目录
cd PHP-Dynamic-Qr-code/docker

# 构建镜像
docker build -t wbsu2003/qrcode:v1 .

# 生成容器
docker run -d \
--name=qrcode \
-p 3470:3080 \
-v $(pwd)/saved_qrcode:/var/www/html/saved_qrcode \
-e DOCKER_CID=docker \
-e WEB_URL=192.168.0.197 \
-e DATABASE_HOST=192.168.0.197 \
-e DATABASE_PORT=3307 \
-e DATABASE_NAME=qrcode \
-e DATABASE_USER=qrcode \
-e DATABASE_PASSWORD=123456 \
-e DATABASE_PREFIX=qr_ \
wbsu2003/qrcode:v1

安装

在群晖上以 Docker 方式安装。

建数据库

直接使用群晖自带的 Mariadb 10

phpMyAdmin 中创建了名为 qrcode 的空数据库。

为便于说明,假设数据库密码为 123456

所以根据上面的设置,最后得到的数据库相关的参数如下:

  • 数据库主机:192.168.0.197,与群晖主机 IP 一致;
  • 数据库端口:3307
  • 数据库用户:qrcode
  • 数据库密码:123456
  • 数据库库名:qrcode,因为勾选了与用户同名;

镜像下载

  1. 如果注册表能用,在注册表中搜索 wbsu2003/qrcode ,版本选择 latest

  1. 如果注册表用不了,但是可以下载,用 SSH 客户端登录到群晖,在命令行中直接输入
1
docker pull wbsu2003/qrcode:latest
  1. 如果既不能搜索,也不能下载,就去 https://dockerproxy.com 试试吧

命令行安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 新建文件夹 qrcode 和 子目录
mkdir -p /volume1/docker/qrcode/saved_qrcode

# 进入 qrcode 目录
cd /volume1/docker/qrcode

# 修改目录权限
chmod 777 saved_qrcode

# 运行容器
docker run -d \
--restart unless-stopped \
--name qrcode \
-p 3470:3080 \
-v $(pwd)/saved_qrcode:/var/www/html/saved_qrcode \
-e DOCKER_CID=docker \
-e WEB_URL=192.168.0.197 \
-e DATABASE_HOST=192.168.0.197 \
-e DATABASE_PORT=3307 \
-e DATABASE_NAME=qrcode \
-e DATABASE_USER=qrcode \
-e DATABASE_PASSWORD=123456 \
-e DATABASE_PREFIX=qr_ \
wbsu2003/qrcode
可变
DOCKER_CID 设为 docker
WEB_URL 服务地址,应该没起作用
DATABASE_HOST 数据库主机
DATABASE_PORT 数据库端口
DATABASE_NAME 数据库库名
DATABASE_USER 数据库用户
DATABASE_PASSWORD 数据库密码
DATABASE_PREFIX 设为 qr_

config/environment.php 中看,只要 DOCKER_CID 是字符串就会读取环境变量中的数据库设置

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
version: '3'

services:
qrcode:
image: wbsu2003/qrcode
container_name: qrcode
restart: unless-stopped
ports:
- 3470:3080
volumes:
- ./saved_qrcode:/var/www/html/saved_qrcode
environment:
DOCKER_CID: "docker"
WEB_URL: "192.168.0.197"
DATABASE_HOST: "192.168.0.197"
DATABASE_PORT: "3307"
DATABASE_NAME: "qrcode"
DATABASE_USER: "qrcode"
DATABASE_PASSWORD: "123456"
DATABASE_PREFIX: "qr_"

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
11
12
13
# 新建文件夹 qrcode 和 子目录
mkdir -p /volume1/docker/qrcode/saved_qrcode

# 进入 qrcode 目录
cd /volume1/docker/qrcode

# 修改目录权限
chmod 777 saved_qrcode

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

第一次运行,需要先进行设置

在浏览器中输入 http://群晖IP:3470/install/setup.php 就能看到设置界面

注意:这里提示了后台账号和密码,均为 superadmin

如果直接看到上面的界面,说明数据库设置正确,在 phpMyAdmin 中你会看到已经有了 3 张表

如果数据库设置不正确,会显示 The database could not be created, please check your database credentials!

Log in 按钮,跳转到登录界面

账号: superadmin,密码:superadmin

登录成功后的主界面

新建动态二维码

https://laosu.ml 为例

用微信扫出来是这样的

如果要印在名片或者彩页上,需用域名或者公网 IP

下载的二维码保存在 saved_qrcode 目录中

静态二维码的种类比较多

存在的问题

1、默认内置的 demo 数据的二维码,不管是动态还是静态,都不显示

2、除了 logout 外,ProfileSettings 都没链接,不知道是代码问题,还是 Docker 构建的问题

等官方放出正式的 docker 版本吧

参考文档

giandonatoinverso/PHP-Dynamic-Qr-code: PHP Dynamic Qr code is a script that allows the generation and saving of dynamic and static QR codes
地址:https://github.com/giandonatoinverso/PHP-Dynamic-Qr-code

PHP-Dynamic-Qr-code/docker at master · giandonatoinverso/PHP-Dynamic-Qr-code · GitHub
地址:https://github.com/giandonatoinverso/PHP-Dynamic-Qr-code/tree/master/docker

PHP Qr Code Generator- Documentation
地址:https://giandonatoinverso.it/documentation/