Falsehoods about IBANs
A PHP library for parsing, validating, generating, and error-correcting IBAN and IIBAN bank account information.
What is Falsehoods about IBANs?
php-iban is a PHP library for generating, parsing, validating, and error-correcting International Bank Account Numbers (IBAN) and Internet IBANs (IIBAN). It solves the problem of handling bank account information across 116 countries by providing a reliable, up-to-date implementation based on the official SWIFT registry.
PHP developers building financial applications, payment gateways, or banking integrations that require IBAN validation, generation, or parsing. It's also suitable for projects needing SEPA compliance or support for unofficial IBAN countries.
Developers choose php-iban for its comprehensive feature set, including IIBAN support, mistranscription error correction, and national checksum validation. It's dependency-free, LGPL-licensed for commercial use, and maintains a manually corrected registry that addresses errors in official specifications.
Overview
Generate, parse, validate, error-correct and present IBAN (and IIBAN) bank account information in PHP.
Use Cases
Best For
- Validating IBANs in payment processing systems
- Generating correct IBANs for bank account creation
- Parsing IBAN components for financial reporting
- Correcting user-input IBANs with mistranscription errors
- Checking SEPA membership for euro payments
- Integrating IIBAN support for cryptocurrency exchanges
Not Ideal For
- Projects requiring immediate updates to the latest SWIFT registry releases, as the library relies on manual updates and may lag behind new specifications.
- Teams using Symfony or Laravel validation components who prefer framework-native solutions over integrating a standalone library.
- Applications needing only basic IBAN format validation without advanced features like mistranscription correction or IIBAN support.
Pros & Cons
Pros
Supports full IBAN parsing, validation, generation, and error correction for 116 countries, including IIBAN for decentralized finance and national checksums, as detailed in the feature comparison table.
Has no external dependencies, making it lightweight and easy to integrate into any PHP project without bloating the codebase, as emphasized in the philosophy section.
Licensed under LGPL, allowing free commercial use and fostering open-source contributions, which is highlighted in the licensing note.
Uses an error-corrected, open-source registry derived from SWIFT specifications, with documented fixes for official errors, as seen in the 'COMEDY-OF-ERRORS' file.
Cons
The README admits that the library may not be immediately up-to-date with new SWIFT releases, relying on manual updates that can delay support for recent changes.
National checksum support is patchy, with noted issues like Luxembourg's uncertain system and missing documentation for countries like Faroe Islands, as mentioned in the 'Your Help Wanted' section.
Major version updates, such as the move to namespacing in version 4.0.0, have required code adjustments, indicating that future releases might introduce compatibility breaks.
Frequently Asked Questions
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.