php swiss qr bill

其他类别 2025-08-21

瑞士QR法案

一个PHP库来创建瑞士QR账单支付零件( QR-Rechnung )。

入门

 composer require sprain/swiss-qr-bill

然后查看示例/示例.php。

常见问题解答

  • 为什么我的伊班不起作用?
    典型的QR法案(例如)需要特殊的QR IBAN。您可以从您的银行获得您的。经典的IBAN可以用于带有SCOR参考的QR账单(示例)或根本没有参考号(示例)。

  • 我如何识别Qr iban?
    在QR IBAN中,在第5至9个字符中定义的Institute ID在30000至31999的范围内。(示例:CH44 3199 9 123 0008 8901 2)。有关如何在代码中检测到的,请参见#182(注释)

  • 如何为国际ibans创建QR账单?
    你不能。 QR法案规格仅支持来自瑞士和列支敦士登的Ibans。

  • 我如何支持除CHF或EUR以外的其他货币?
    你不能。规格规格的QR账单仅支持CHF和EUR。

  • 如何更改翻译以使用自己的措辞?
    你不能。这些翻译是在QR账单规范中定义的,并不是要由用户更改。请参阅此文档,第31页。

  • 如何使TWINT应付QR账单?
    参见#129

  • 该库支持哪些PDF库?
    目前积极支持以下库:

    • FPDF/FPDF
    • tecnickcom/tcpdf
    • setAsign/fpdi(由FpdfOutputTcPdfOutput接受)

    已知HtmlOutput的输出用于生成使用PrinceXML,DoCraptor和DOMPDF/DOMPDF的PDF(此处减少了一些调整)

  • 为什么在大多数课程上都使用final ?我想扩展它们!
    该图书馆实施了QR法案的官方规范。该实现不应进行调整,因为它可能导致QR账单损坏。因此,许多课程被标记为最终。如果您发现需要扩展其中一个最终课程,则可能在此库中找到了一个错误。在这种情况下,如果您在此处提供错误报告甚至是拉动请求,这将非常有帮助。谢谢你!

得到帮助

使用此库需要更多帮助吗?

  • 搜索现有和封闭的问题,以查看您是否在那里找到答案。
  • 如果您仍然需要帮助,则可以自己创建一个问题来提出问题。

请注意,该库的维护者将不会通过电子邮件提供任何支持。开源软件的美丽在于每个人都可以彼此受益。因此,只有在公开场合回答问题。

版本控制

语义版本控制用于此库。

此外,如果QR码的输出或付款部件发生任何可见的更改,即使可以被认为是错误的文件,也将始终发布次要版本。

PHP版本支持

该库支持PHP版本,只要占当前安装的大约10%。

DEPDENDENCY支持

只要较旧版本的依赖项不阻碍进一步的发展或至少占相应依赖性当前安装的约10%。

支持该项目

  • 你喜欢这个项目吗?考虑GitHub赞助。
  • 您想贡献吗?看看空旷的问题。彼此友善。
  • 传播!

官方资源

存储库包含图书馆基于的官方规格:

  • 瑞士实施指南QR-BILL
  • 有关QR-IID和QR-IBAN的技术信息
  • 样式指南QR-bill
  • 验证工具

有关更多官方信息,请参见

  • https://www.six*-*grou*p.com/en/products-services/banking-services/payment-andardardization/standards/qr-bill.html

对于这个图书馆的贡献者

如何生成新的测试数据:

  1. 设置$regenerateReferenceFiles = true TraitValidQrBillsProvider
  2. composer update --prefer-lowest
  3. vendor/bin/phpunit - 忽略testQrFile中的失败测试
  4. composer update
  5. vendor/bin/phpunit - 不应有更多错误
  6. 设置$regenerateReferenceFiles = false TraitValidQrBillsProvider中的false
下载源码

通过命令行克隆项目:

git clone https://github.com/sprain/php-swiss-qr-bill.git