---
title: "Konfigurácia — QR for Laravel | Roundly"
description: "Každý konfiguračný kľúč, predvolená hodnota a env premenná — korekcia chýb, verzie, SVG štýly, cache, Blade a platobné štandardy."
url: https://roundly-consulting.com/sk/open-source/navody/qr-for-laravel/konfiguracia
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[QR for Laravel](https://roundly-consulting.com/sk/open-source/navody/qr-for-laravel.md)

# Konfigurácia

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

```php
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:

```bash
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.

```bash
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](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## 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](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/qr-for-laravel.md)