NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2169 most downloaded on Packagist
A PHP library to create Swiss QR bills
Latest stable
v5.3.1
Last release 1 months ago
29 Sep 2026
Release timing varies
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
77 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Bugfix: Added validation to make sure only amounts with a maxium of 2 decimals places allowed by the specification are accepted (#301) – thanks to @Sa
Fixed an issue where qr bills with amounts equal to or larger than CHF/EUR 1000 invalidly contained a space as a thousands separator within the qr cod
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Got rid of deprecation notice by avoiding implicit nullable parameter (#269) – thanks to @finpension-aless
Fixed positioning of scissors in HtmlOutput (#267) – thanks to @tafel
HtmlOutput (#267) – thanks to @tafelFixed an issue where the file size of invoices created with TcPdfOutput was unnecessarily inflated (#252) – thanks to @sdespont
TcPdfOutput was unnecessarily inflated (#252) – thanks to @sdespontcomposer.lock from this library (#251) – thanks to @kohlerdominikFixed contents of qr code if there are alternativeSchemes but no billInformation (#240) – thanks to @demianh for reporting the issue.
alternativeSchemes but no billInformation (#240) – thanks to @demianh for reporting the issue.Improved return type hint in abstract class (#227) – thanks to @gregor-tb for contributing.
PHP-CS-Fixer to version supporting PHP 8.2 (#217)Removed deprecated uft8_decode usages (#211) – thanks to @codingphildotdev
allow_url_fopen (#216) – thanks to @kohlerdominikuft8_decode usages (#211) – thanks to @codingphildotdevAdded fix to retain page break setting in TcPdfOutput
TcPdfOutput (#179)Kudos!
Explicitly requires symfony/polyfill-intl-icu as a dependency
symfony/polyfill-intl-icu as a dependency (#145)Kudos!
Fixed type doc which caused static code analysis to fail
Improved handling of reference numbers with spaces
No changes. Just forcing Packagist to fetch the newest version again, after v2.17.1 for some reason could not be made available there
v2.17.1 for some reason could not be made available there (#85)Removed redundant css styles from HtmlOutput
HtmlOutput (#75)TcPdfOutput: Fixed behaviour to make sure the cell height ratio of the original document is retained
TcPdfOutput: Fixed behaviour to make sure the cell height ratio of the original document is retained (#58)Minor improvements for missing type hints and code styling
Added some CSS improvements in HtmlOutput
HtmlOutput (#41)Handle all validation of SCOR reference numbers in the corresponding 3rd-party library
Nothing published for this version
Minor improvements concerning alternative schemes
Added official Romansh translations (#293) – thanks to @gion-andri
⚠️ Warning: This version creates invalid QR codes for amounts >= CHF/EUR 1000. Use v5.2.1 or higher instead.
⚠️ Warning: This version creates invalid QR codes for amounts >= CHF/EUR 1000. Use v5.2.1 or higher instead.
⚠️ Warning: This version creates invalid QR codes for amounts >= CHF/EUR 1000. Use v5.2.1 or higher instead.
⚠️ Warning: This version creates invalid QR codes for amounts >= CHF/EUR 1000. Use v5.2.1 or higher instead.
This release removes deprecated methods and functionality. Most importantly, the `CombinedAddress` is no longer available. With v2.3 of the qr bill sp…
CombinedAddress is no longer available. With v2.3 of the qr bill specification, since November 2025, only the StructuredAddress is allowed. (#288)Fixed positioning of further information (alternative schemes) on outputs (#228) – thanks to @rsteimen for reporting the issue along with some analysi
Good to know
* Added support for PHP 8.2
Added support to use FpdfOutput in environments with allow_url_fopen = 0
FpdfOutput in environments with allow_url_fopen = 0 (#194)Kudos!
Added support to generate PDFs with `setasign/fpdi`
setasign/fpdi (#193)Kudos!
Added stricter css rules to HtmlOutput to make sure qr bill designs are not overwritten by other styles within the document
HtmlOutput to make sure qr bill designs are not overwritten by other styles within the document (#201)Good to know
Re-introduced output of country code for Liechtenstein on payment parts, as expected by the specifications (see #199)
Good to know
Kudos!
Added functionality to handle long addresses on the receipt of the payment part by omitting some address lines when needed
Kudos!
Added export-ignore rules in .gitattributes to reduce file size of package download (#281) – thanks to @iquito
export-ignore rules in .gitattributes to reduce file size of package download (#281) – thanks to @iquitoFixed ISO 3661-1 country code for Liechtenstein
Good to know
Kudos!
Improved scissors symbol in TcPdfOutput (#268) – thanks to @tafel
TcPdfOutput (#268) – thanks to @tafelQrPaymentReference does not consist exclusively of zeros (#279)Deprecated CombinedAddress as it will no longer be supported by v2.3 of the QR bill specification, valid from 21. November 2025
CombinedAddress as it will no longer be supported by v2.3 of the QR bill specification, valid from 21. November 2025 (#278)Isn't dropping support for a PHP version a BC break and should cause a major version update? No. Why not? The Doctrine project explains it nicely:
Good to know
Isn't dropping support for a PHP version a BC break and should cause a major version update? No. Why not? The Doctrine project explains it nicely:
A BC break happens when there is an incompatible change that your package manager can't handle. For example, changing a method signature in a minor version is a no-go, since the composer version constraints mentioned above assume any minor upgrade can safely be used. However, when we drop support for an older version of PHP, composer will not consider the new version if the PHP version requirement is no longer fulfilled. Thus, you won't end up with a fatal error due to a wrong method signature, you just won't get the new version.
Added Output\DisplayOptions, which allows controlling how separation information on the qr bill is handled:
Output\DisplayOptions, which allows controlling how separation information on the qr bill is handled:
See #264 for more information.
Thanks to @tafel for providing that feature and @kohlerdominik for much appreciated feedback.
Added support for endroid/qr-code v6.x
endroid/qr-code v6.x (#262)Modernized encoding conversion in FPDF (#260) – thanks to @kohlerdominik and @supercosh
Made sure only supported characters are kept within the qr code – along with a functionality to provide custom replacement characters
Added support for Symfony 7.x dependencies
Improved stylesheets in HtmlOutput to reset any relevant data set outside the qr bill (#238) – thanks to @pivica for reporting and helping with this i
HtmlOutput to reset any relevant data set outside the qr bill (#238) – thanks to @pivica for reporting and helping with this issue.Good to know
Added support for endroid/qr-code v5.x
endroid/qr-code v5.x (#232)Deprecated QrCode::writeDataUri() in favor of new QrCode::getDataUri()
QrCode::getAsString() (#176)QrCode::getDataUri() (#176)QrCode::writeDataUri() in favor of new QrCode::getDataUri() (#176)Kudos!
While there are BC breaks, no changes are required if the library was used as intended.
While there are BC breaks, no changes are required if the library was used as intended.
endroid/qr-code v4 (#151)endroid/qr-code v3 (#151)Sprain\SwissQrBill\QrCode\QrCode no longer extends Endroid\QrCode\QrCode (#151)Kudos!
Added support for Symfony 6 dependencies
Kudos!
Good to know
Isn't dropping support for a PHP version a BC break and should cause a major version update? No. Why not? The Doctrine project explains it nicely:
A BC break happens when there is an incompatible change that your package manager can't handle. For example, changing a method signature in a minor version is a no-go, since the composer version constraints mentioned above assume any minor upgrade can safely be used. However, when we drop support for an older version of PHP, composer will not consider the new version if the PHP version requirement is no longer fulfilled. Thus, you won't end up with a fatal error due to a wrong method signature, you just won't get the new version.
Adjusted behaviour of field StrdBkgInf to match specifications v2.2
StrdBkgInf to match specifications v2.2 (#146)Good to know
Many thanks go to @kohlerdominik for really pushing those changes!
Kudos!
Removed deprecated QrBill::setErrorCorrectionLevel() method.
While there are BC breaks, no changes are required if the library was already used as intended.
private. Factory methods must be used. (#101)final. (#119)@internal. (#120)QrBill::setErrorCorrectionLevel() method. (#102)Kudos!
Added translation key doNotUseForPayment
0.00 as valid amount (#48)doNotUseForPayment (#48)Added $paymentPart->setQrCodeImageFormat() functionality
$paymentPart->setQrCodeImageFormat() functionality (#40)Added support for a wider range of customer identification numbers in QrPaymentReferenceGenerator
QrPaymentReferenceGenerator (#37)Added support for Symfony 5.0 dependencies
* Added support for PHP 7.4
Added documentation on ReadTheDocs
Added support for outputting full payment parts (see #3)
Deprecated QrBill::setErrorCorrectionLevel() (see #21)
medium as default, as defined in specs.QrBill::setErrorCorrectionLevel() (see #21)Adjusted translations in French and Italian according to specifications
Good to know
Kudos!
Positioning offsets of TcPdfOutput and FpdfOutput now accept floats, for when you need to be very precise
TcPdfOutput and FpdfOutput now accept floats, for when you need to be very precise (#99)TcPdfOutput (#99)This is a maintenance release with no changes in the actual behaviour of the library.
This is a maintenance release with no changes in the actual behaviour of the library.
Good to know:
symfony/validator is now 3.4.31Kudos!
One column per quarter.