honzito / qr-platba
在PHP中生成QR付款和QR发票。
dev-main
2023-05-05 10:10 UTC
Requires
- php: >=7.4.0
- ext-mbstring: *
- honzito/bacon-qr-code-basis: >=2023.208.1
- honzito/iban-validation: @dev
This package is auto-updated.
Last update: 2024-09-05 13:02:56 UTC
README
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发票的示例
还可以使用更简单的语法
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 Faktura实现的反向分支 - https://github.com/bonami/qr-platba
- Image by storyset on Freepik
贡献
我非常欢迎任何改进建议,无论是通过issue还是pull request。