Open source
QR for Laravel
composer require roundly-consulting/qr-for-laravelPrehľad
Natívne QR kódy pre Laravel: enkodér podľa ISO/IEC 18004, jeden optimalizovaný SVG renderer a typované payloady pre odkazy, kontakty, Wi-Fi, nastavenie 2FA, SEPA úhrady (EPC069-12) a slovenské platby PAY by square. Neplatný obsah sa odmietne ešte pred vykreslením kódu a tajomstvá, ako seedy 2FA, sa nikdy necachujú. Všetko je implementované priamo v balíku — žiadna externá knižnica na QR, obrázky ani kompresiu, len Laravel a vlastné sprievodné balíky Roundly. Licencia MIT.
Čo získate
Natívny enkodér ISO/IEC 18004
QR Code Model 2, verzie 1–40, úrovne L/M/Q/H, optimálna segmentácia numeric/alphanumeric/byte/kanji a ECI 26 pre UTF-8.
Jedno optimalizované SVG
Jediná even-odd cesta s presným viewBoxom — štvorcové, zaoblené alebo bodkové moduly, zaoblené finder vzory a prístupný titulok aj popis.
Typované payloady
Text, URL, e-mail, telefón, SMS, Wi-Fi, vCard, geo a otpauth — overené ešte pred vykreslením kódu, bez úniku hodnoty do chybových hlásení.
SEPA a PAY by square
SEPA úhrady podľa EPC069-12 v3.1 a PAY by square 1.0.0–1.2.0 — platobné príkazy, trvalé príkazy aj inkasá, kódovanie aj dekódovanie.
Bankové identifikátory
Hodnotové objekty IBAN, BIC a referencie veriteľa podľa ISO 11649, validačné pravidlá a Eloquent cast AsIban.
Cache podľa citlivosti
Seedy 2FA a heslá k Wi-Fi sa nikdy nememoizujú, necachujú ani neservírujú cachovateľne; verejné kódy dostanú ETag a voliteľnú SVG cache.
Fasáda alebo DI, natívne v Laraveli
Volajte fasádu Qr alebo injektujte QrFactory; vráťte kód z controllera, vložte <x-qr-code> do Blade, použite data URI alebo spustite qr:make.
Dokumentácia
Inštalácia
Inštalácia cez Composer — bez migrácií a bez rout; voliteľne publikujte konfiguráciu a preklady.
Konfigurácia
Každý konfiguračný kľúč, predvolená hodnota a env premenná — korekcia chýb, verzie, SVG štýly, cache, Blade a platobné štandardy.
Fasáda Qr
Všetky metódy fasády Qr — vstupné body pre typované payloady, skratky svg/matrix/info na jedno volanie a lacná kontrola kapacity fits().
Bez fasády
Namiesto fasády Qr injektujte kontrakt QrFactory — rovnaké API ako explicitná závislosť v konštruktore, bez statických volaní.
Rýchly štart
Vykreslite QR kód v Blade, ako objekt Svg, ako data URI alebo ho vráťte priamo z routy ako obrázkovú odpoveď.
Builder a možnosti
Nemenný builder PendingQr — korekcia chýb, verzie, masky, segmentácia, štýly, formulár QrOptions a priorita nastavení.
Payloady
Typované payloady pre text, odkazy, e-mail, telefón, SMS, Wi-Fi, vCard a geo — overené ešte pred vykreslením kódu.
Vlastné payloady
Implementujte kontrakt Payload pre vlastný obsah — vstupenky, štítky — s vlastnými požiadavkami a citlivosťou.
Kódy pre 2FA
Vykreslite existujúce URI otpauth:// bez zmeny alebo vytvorte URI pre TOTP/HOTP — vždy sa s nimi zaobchádza ako s tajomstvom.
SEPA úhrada (EPC)
QR kódy pre SEPA úhradu podľa EPC069-12 v3.1 (GiroCode) — argumenty, znakové sady, pravidlá pre BIC a parsovanie naskenovaných kódov.
PAY by square
Slovenské kódy PAY by square (špecifikácia 1.0.0–1.2.0) — platobné príkazy, trvalé príkazy a inkasá, kódovanie aj dekódovanie.
Bankové identifikátory
Hodnotové objekty IBAN, BIC a referencie veriteľa podľa ISO 11649 — parsovanie, validácia, formátovanie a generovanie kontrolných číslic.
Validačné pravidlá a cast
Pravidlá formulárov pre IBAN, BIC, referenciu veriteľa a kapacitu QR kódu, plus Eloquent cast AsIban.
SVG výstup a štýly
Jedna deterministická a prístupná SVG cesta — štýly modulov a finder vzorov, farby, responzívna veľkosť a objekt Svg.
Odpovede a data URI
Vracajte kódy ako zabezpečené odpovede image/svg+xml, vynúťte stiahnutie, vkladajte data URI a img tagy a postavte bezpečnú routu.
Blade komponent
Vložte <x-qr-code> do ľubovoľného view — inline SVG alebo img tag, s povolenými atribútmi a bez kompilácie šablóny.
Citlivosť a cache
Payloady Public, Personal a Secret — čo sa memoizuje, cachuje a servíruje cachovateľne a ako to prepísať.
Nízkoúrovňový enkodér
Ovládajte enkodér ISO/IEC 18004 priamo — explicitné segmenty, kapacita, masky a objekty QrMatrix a EncodingInfo.
Chyby a preklady
Jedna hierarchia výnimiek so stabilnými kľúčmi dôvodov, preložiteľné hlásenia pre používateľov a publikovateľný súbor prekladov.
Artisan príkazy
Generujte SVG súbory alebo skontrolujte verziu, úroveň, masku a bitový rozpočet kódu z príkazového riadka cez qr:make.
Testovanie
Overujte skutočný výstup — dekódujte matice cez MatrixDecoder, kontrolujte Qr::info() a Qr::fits() a testujte hlavičky odpovedí cez HTTP.
Požiadavky
PHP 8.4+ s ext-mbstring a ext-bcmath, Laravel 12 alebo 13; ext-intl voliteľne na normalizáciu textu platieb.
Prejavte lásku k open source
Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.
Ďalšie spôsoby podpory vrátane kryptomienOdoslaním daru súhlasíte s našimi podmienkami prijímania darov.
Chcete to zabudovať do svojho produktu?
Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.