Konfigurácia

Žiadna konfigurácia nie je potrebná. Publikovaný config/qr.php celý:

return [
    'error_correction' => env('QR_ERROR_CORRECTION', 'M'),
    'boost_error_correction' => env('QR_BOOST_ERROR_CORRECTION', true),
    'versions' => ['min' => 1, 'max' => 40],
    'mask' => null,
    'eci' => env('QR_ECI', 'auto'),
    'kanji' => false,

    'svg' => [
        'size' => 256,
        'margin' => 4,
        'foreground' => '#000000',
        'background' => '#ffffff',
        'module_style' => 'square',
        'module_radius' => 0.5,
        'finder_style' => 'square',
        'finder_color' => null,
        'xml_declaration' => false,
    ],

    'response' => ['max_age' => 86400, 'immutable' => false],
    'memo' => ['entries' => 64],
    'cache' => [
        'enabled' => env('QR_CACHE', false),
        'store' => env('QR_CACHE_STORE'),
        'ttl' => 86400,
        'prefix' => 'qr',
    ],
    'blade' => ['component' => 'qr-code'],

    'payments' => [
        'epc' => [
            'version' => env('QR_EPC_VERSION', '002'),
            'charset' => 'utf-8',
            'strict_charset' => false,
        ],
        'bysquare' => [
            'version' => env('QR_BYSQUARE_VERSION', '1.2.0'),
            'deburr' => env('QR_BYSQUARE_DEBURR', true),
        ],
    ],
];

Všetky kľúče

Kľúč	Predvolené	Env	Účel
`error_correction`	M	QR_ERROR_CORRECTION	Predvolená úroveň: L (7 %), M (15 %), Q (25 %), H (30 %).
`boost_error_correction`	true	QR_BOOST_ERROR_CORRECTION	Zvýši úroveň zadarmo, ak má zvolená verzia rezervu. Verziu nikdy nemení.
`versions.min / versions.max`	1 / 40	—	Povolené verzie symbolu (1–40, min ≤ max).
`mask`	null	—	Vynúti masku 0–7; null vyberie masku s najnižšou penalizáciou podľa ISO.
`eci`	auto	QR_ECI	Označenie ECI 26 (UTF-8): auto (len pre ne-ASCII UTF-8), always, never.
`kanji`	false	—	Povolí kanji segmenty v Shift JIS (nikdy nie spolu s označením ECI).
`svg.size`	256	—	Šírka/výška v px (1–8192); null vykreslí responzívne SVG (len viewBox).
`svg.margin`	4	—	Tichá zóna v moduloch (0–64). ISO/IEC 18004 vyžaduje 4.
`svg.foreground / svg.background`	#000000 / #ffffff	—	Hex, rgb()/rgba(), pomenované CSS farby, currentColor; transparent vynechá pozadie.
`svg.module_style / svg.module_radius`	square / 0.5	—	square, rounded alebo dots; polomer v moduloch (0 < r ≤ 0.5).
`svg.finder_style / svg.finder_color`	square / null	—	Štvorcové alebo zaoblené finder vzory; farba null = farba popredia.
`svg.xml_declaration`	false	—	Pridá pred inline SVG XML deklaráciu. Odpovede a sťahovania ju majú vždy.
`response.max_age / response.immutable`	86400 / false	—	Cache-Control pre verejné a osobné kódy.
`memo.entries`	64	—	LRU zakódovaných matíc v rámci procesu (len verejné payloady); 0 ju vypne.
`cache.enabled`	false	QR_CACHE	Cachuje vykreslené SVG verejných payloadov v Laravel cache store.
`cache.store`	null	QR_CACHE_STORE	Použitý cache store; null alebo prázdna hodnota = predvolený store.
`cache.ttl / cache.prefix`	86400 / qr	—	Počet sekúnd v cache a prefix kľúča.
`blade.component`	qr-code	—	Alias komponentu (<x-qr-code>); null alebo prázdna hodnota (nenastavená) ho vypne.
`payments.epc.version`	002	QR_EPC_VERSION	Verzia EPC069-12: 001 (BIC povinný) alebo 002 (BIC voliteľný pre IBAN z EHP).
`payments.epc.charset`	utf-8	—	utf-8, iso-8859-1, -2, -4, -5, -7, -10, -15.
`payments.epc.strict_charset`	false	—	Obmedzí text EPC na podmnožinu SEPA Latin.
`payments.bysquare.version`	1.2.0	QR_BYSQUARE_VERSION	1.0.0, 1.1.0 alebo 1.2.0 (meno príjemcu povinné).
`payments.bysquare.deburr`	true	QR_BYSQUARE_DEBURR	Odstráni diakritiku z poznámky a údajov príjemcu.

Kľúče sa overujú pri čítaní. Nenastavený kľúč — chýbajúci, null alebo prázdny ('' či len medzery, napríklad riadok QR_ECI= v .env) — dostane predvolenú hodnotu uvedenú vyššie; pri mask, svg.size, svg.finder_color, cache.store a blade.component je nenastavená hodnota to isté ako null (prázdne svg.size teda vykreslí responzívne SVG). Chybne nastavený kľúč — preklep ako QR_ECI=sometimes — vyhodí InvalidQrConfigException s názvom kľúča. error_correction akceptuje aj názvy low, medium, quartile a high v ľubovoľnej veľkosti písmen.

Prostredie (env)

Najčastejšie prepínače sú riadené cez env:

QR_ERROR_CORRECTION=M
QR_BOOST_ERROR_CORRECTION=true
QR_ECI=auto
QR_CACHE=true
QR_CACHE_STORE=redis
QR_EPC_VERSION=002
QR_BYSQUARE_VERSION=1.2.0
QR_BYSQUARE_DEBURR=true

Kontrola platných nastavení

php artisan about zobrazí sekciu Qr s platnými nastaveniami — korekcia chýb a jej zvyšovanie, verzie, maska, ECI, kanji, predvolené SVG, memo, cache, Blade komponent, EPC a PAY by square. Názov cache store nikdy nevypíše.

php artisan about

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 kryptomien

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

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.

Ponuka do 48 hodín Prezrieť všetky balíky