README

PHP生成QR付款库。QR付款简化了最终用户执行付款命令的过程，因为它包含所有必要的详细信息，只需扫描即可。现在可以通过setCurrenty($currency)方法使用除CZK之外的其他货币。

该库允许

• 在<img>标签中显示图片，其中src包含QR码的数据-uri，因此不需要在服务器上存储生成的图片（$qrPlatba->getQRCodeImage()）
• 保存QR码图片（$qrPlatba->saveQRCodeImage()）
• 获取data-uri（$qrPlatba->getDataUri()）
• 获取QrCode对象实例（$qrPlatba->getQRCodeInstance()）

目前支持以下银行的QRPlatba：Air Bank，Česká spořitelna，ČSOB，Equa bank，Era，Fio banka，Komerční banka，mBank，Raiffeisenbank，ZUNO。

支持PHP 7.4至8.1。

使用Composer安装

composer require "dfridrich/qr-platba:^2"

示例

<?php

require __DIR__ . '/vendor/autoload.php';

use Defr\QRPlatba\QRPlatba;

$qrPlatba = new QRPlatba();

$qrPlatba->setAccount('12-3456789012/0100') // nastavení č. účtu
    ->setIBAN('CZ3112000000198742637541') // nastavení č. účtu
    ->setVariableSymbol('2016001234')
    ->setMessage('Toto je první QR platba.')
    ->setConstantSymbol('0308')
    ->setSpecificSymbol('1234')
    ->setAmount('1234.56')
    ->setCurrency('CZK') // Výchozí je CZK, lze zadat jakýkoli ISO kód měny
    ->setDueDate(new \DateTime());

echo $qrPlatba->getQRCodeImage(); // Zobrazí <img> tag s kódem, viz níže  

示例（请参阅test/OutputTest.php），请尝试在银行或iDoklad等应用程序中扫描它们作为QR发票

QR付款（PNG）

QR付款（EUR）（PNG）

QR付款（SVG）

QR付款和描述（PNG）

QR付款和描述（EUR）（PNG）

QR付款和描述（SVG）

QR付款+F和描述（PNG）

QR付款+F和描述（EUR）（PNG）

QR付款+F和描述（SVG）

QR发票无付款（SVG）

还可以使用更简单的语法

echo QRPlatba::create('12-3456789012/0100', 987.60)
    ->setMessage('QR platba je parádní!')
    ->getQRCodeImage();

对于IBAN，则为

echo QRPlatba::create('CZ6508000000192000145399', 987.60)
    ->setMessage('QR platba je parádní!')
    ->getQRCodeImage();

其他选项

保存到文件

// Uloží png o velikosti 100x100 px
$qrPlatba->saveQRCodeImage("qrcode.png", "png", 100);

// Uloží svg o velikosti 100x100 px
$qrPlatba->saveQRCodeImage("qrcode.svg", "svg", 100);

// Generování jen QR Faktury
$qrPlatba->setIsOnlyInvoice(true)->setLabel('QR Faktura');

当前可能的格式是

• PNG
• SVG

对于其他格式，需要编写自定义Writer

显示data-uri

// data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAUAAAAFAAQMAAAD3XjfpAAAA...
echo $qrPlatba->getDataUri();

链接

• QR付款官方网站 - http://qr-platba.cz/
• QR发票官方网站 - http://qr-faktura.cz/
• 启发我的存储库 - https://github.com/snoblucha/QRPlatba
• 我从其中添加和修改了QR发票实现的分支 - https://github.com/bonami/qr-platba
• Image by storyset on Freepik

贡献

我非常欢迎任何改进建议，无论是issue还是pull request。