honzito/qr-platba

在PHP中生成QR付款和QR发票。

dev-main 2023-05-05 10:10 UTC

This package is auto-updated.

Last update: 2024-09-05 13:02:56 UTC


README

Latest Stable Version Total Downloads Build Status Coverage Status

QR Platba 2

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

该库允许

  • <img>标签中显示图像,该图像包含数据-uri格式的QR码,因此不需要在服务器上存储生成的图像($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();

链接

贡献

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