php swiss qr bill

瑞士二維碼帳單

用於建立瑞士 QR 帳單支付零件 ( QR-Rechnung ) 的 PHP 庫。

入門

 composer require sprain/swiss-qr-bill

然後看一下 example/example.php。

常見問題解答

• 為什麼我的 IBAN 不起作用？
  典型的 QR 帳單（範例）需要特殊的 QR IBAN。您可以從銀行取得您的。經典 IBAN 可用於具有 SCOR 參考號碼（範例）或完全沒有參考號碼（範例）的 QR 帳單。

• 我如何識別 QR IBAN？
  在 QR IBAN 中，機構 id在第5到第 9 個字元中定義，是 30000 到 31999 範圍內的數字。如何在程式碼中檢測它，請參見#182（評論）

• 如何為國際 IBAN 建立 QR 帳單？
  你不能。根據規範，QR 法案僅支持來自瑞士和列支敦士登的 IBAN。

• 如何支持瑞士法郎或歐元以外的貨幣？
  你不能。根據規格，QR 帳單僅支援瑞士法郎和歐元。

• 如何更改翻譯以使用我自己的措辭？
  你不能。翻譯在 QR 帳單規格中定義，使用者不得更改。請參閱本文檔第 31 頁。

• 如何透過 Twint 支付我的 QR 帳單？
  參見#129

• 該庫支援哪些 PDF 庫？
  目前積極支持以下程式庫：

  • fpdf/fpdf
  • tecnickcom/tcpdf
  • setasign/fpdi （被FpdfOutput和TcPdfOutput接受）

  已知HtmlOutput的輸出可用於使用 PrinceXML、Docraptor 和 dompdf/dompdf 產生 PDF（進行一些調整，如此處所述）

• 為什麼你在大多數課程中都會使用final ？我想延長它們！
  該庫實現了QR帳單的官方規範。此實施不應進行調整，因為它可能會導致 QR 帳單損壞。因此，許多課程被標記為最終課程。如果您發現需要擴展這些最終類別之一，您可能會在這個庫中發現一個錯誤。在這種情況下，如果您在此處提供錯誤報告甚至拉取請求，將會非常有幫助。謝謝你！

尋求協助

您在使用該庫時需要更多幫助嗎？

• 搜尋現有和已解決的問題，看看是否能在那裡找到答案。
• 如果您仍然需要幫助，您可以自己創建一個問題來提出您的問題。

請注意，該庫的維護者不會透過電子郵件提供任何支援。開源軟體的美妙之處在於每個人都可以從彼此中受益。因此，問題只能公開回答。

版本控制

該庫使用語義版本控制。

此外，如果二維碼或支付部分的輸出發生任何明顯的變化，即使它可以被認為只是一個錯誤修復，也將始終發布次要版本。

PHP版本支持

該程式庫支援 PHP 版本，只要它至少佔目前安裝的 10% 左右。

依賴支持

只要舊版本的依賴項不妨礙進一步開發或占相應依賴項目前安裝的至少約 10%，則支援它們。

支援專案

• 你喜歡這個項目嗎？考慮 Github 贊助。
• 您願意貢獻嗎？查看未解決的問題。善待彼此。
• 傳播這個詞！

官方資源

該存儲庫包含該庫所基於的官方規格：

• 瑞士實施指南 QR 法案
• 有關 QR-IID 和 QR-IBAN 的技術信息
• 風格指南 QR-bill
• 驗證工具

更多官方資訊請參見

• https://www.six-group.com/en/products-services/banking-services/ payment-standardization/standards/qr-bill.html

對於這個函式庫的貢獻者

如何產生新的測試數據：

1. 在TestQrBillCreatorTrait中設定$regenerateReferenceFiles = true
2. composer update --prefer-lowest
3. vendor/bin/phpunit – 忽略testQrFile中失敗的測試
4. composer update
5. vendor/bin/phpunit – 不應該再有錯誤
6. 在TestQrBillCreatorTrait中設定$regenerateReferenceFiles = false