---
title: "Imports for Laravel — dokumentácia | Roundly"
description: "Dokumentácia Imports for Laravel: importy CSV a XLSX do Eloquentu so šablónami, mapovaním stĺpcov, overeným náhľadom, importom na pozadí a vrátením."
url: https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel
language: sk
---

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

Open source

# Imports for Laravel

Inštalácia

`composer require roundly-consulting/imports-for-laravel`

Vyžaduje: PHP ^8.4 · Laravel ^13.0

[GitHub](https://github.com/roundly-consulting/imports-for-laravel) [Packagist](https://packagist.org/packages/roundly-consulting/imports-for-laravel) [Prispieť (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Patreon](https://www.patreon.com/cw/roundly)

## Prehľad

Importy CSV a XLSX do vašich Eloquent modelov. Každý typ záznamu opíšete raz v triede importéra; vaši používatelia si stiahnu šablónu, nahrajú súbor, skontrolujú navrhnuté mapovanie stĺpcov a náhľad, v ktorom je overený každý riadok, zvolia, čo sa stane so záznamami, ktoré už existujú, a importujú na pozadí — s možnosťou import vrátiť. Kým používateľ import nepotvrdí, nič sa neuloží, a neplatné riadky sa neuložia nikdy. Licencia MIT, vlastná streamovacia čítačka a zapisovač CSV a XLSX — bez externej knižnice na tabuľky — postavené na Laravel job batches a balíkoch Roundly options, crypto, enums a package-toolkit.

### Čo získate

#### Jeden importér pre každý typ záznamu

Riadok opíšete raz — typované polia, popisy v ľubovoľnom jazyku, aliasy, príklady a pravidlá, prirodzený kľúč pre duplicity a odkazy na iné záznamy v rámci vlastníka.

#### Šablóny, ktoré sa dajú vyplniť

CSV alebo XLSX v angličtine či slovenčine, s rozbaľovacími zoznamami povolených hodnôt, tipom pri každom stĺpci a vzorovými riadkami, ktoré sa pri importe preskočia.

#### Stĺpce sa priradia samy

Návrhy podľa hlavičiek, preložených popisov, aliasov a podobných zápisov a mapovania uložené pre každého vlastníka — ďalší súbor s rovnakými hlavičkami sa namapuje sám.

#### Náhľad skôr, než sa čokoľvek uloží

Každý riadok overený, chyby pomenované podľa riadka a bunky, počty platných, neplatných a duplicitných riadkov, rozdiely pri aktualizácii a súbor s chybami — hneď alebo vo fronte s priebehom.

#### Import na pozadí s možnosťou vrátiť ho

Preskočiť, aktualizovať alebo vytvoriť pri existujúcich záznamoch, idempotentné časti na Laravel job batches, zrušenie a pokračovanie a vrátenie, ktoré ponechá všetko neskôr zmenené.

#### Bezpečné aj pri neznámych súboroch

Vlastná streamovacia čítačka a zapisovač CSV a XLSX — bez externej knižnice na tabuľky — ochrana pred ZIP bombami a path traversal, CSV bez rizika vzorcov a prístup obmedzený na vlastníka.

#### Fasáda, DI alebo akcie

Jedna fasáda Imports, injektovateľný manažér alebo jednoúčelové akcie — a k tomu nahrávací fake, generátory tabuliek pre testy a voliteľné JSON API.

### Dokumentácia

#### [Použitie](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/pouzitie.md)

Kde sa balík hodí — aplikácie, do ktorých používatelia prinášajú dáta z tabuliek či iných nástrojov, aktualizácie, dávky súborov a viac nájomcov.

#### [Inštalácia](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/instalacia.md)

Inštalácia cez Composer, publikovanie migrácií imports a options, tabuľka job\_batches, plánovanie sweep a prune, typy kľúčov a prvý importér.

#### [Konfigurácia](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/konfiguracia.md)

Každý kľúč config/imports.php s premennou prostredia a predvolenou hodnotou — kľúče, úložisko, limity, čítanie, náhľad, import, vrátenie, front, API.

#### [Importéry](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/importery.md)

Jedna trieda na typ záznamu rozširujúca Importer — metódy a predvolené hodnoty, prirodzené kľúče, callbacky create a update, rollback a registrácia.

#### [Polia a hodnoty](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/polia.md)

Deväť typov polí a ich prevod, popisy, aliasy, príklady, pravidlá a normalizácia, odkazy na iné záznamy a každý kód chyby bunky.

#### [Vlastníci a oprávnenia](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/vlastnici-a-opravnenia.md)

Vlastník ako bezpečnostná hranica — pravidlá Ownership, kontrakt OwnerScope, recept pre teams-for-laravel, authorize() pri každom kroku a audit.

#### [Fasáda Imports](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/fasada.md)

Prehľad fasády Imports — for($owner), importers(), template(), read(), handle relácie a dávky, uložené mapovania, sweep a prune — so všetkými metódami.

#### [DI a akcie](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/bez-fasady.md)

Bez fasády: injektujte ImportsManager alebo zavolajte jednoúčelovú akciu — každá akcia pre aplikáciu so signatúrou execute() a cestou cez fasádu.

#### [Čítanie súborov](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/citanie-suborov.md)

Natívne streamovacie čítačky CSV a XLSX — rozpoznanie formátu podľa obsahu, kódovania, oddeľovače, podpora XLSX, limity, odmietnutia a Imports::read().

#### [Šablóny a reporty chýb](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/sablony.md)

Šablóny CSV a XLSX v angličtine alebo slovenčine s rozbaľovacími zoznamami a tipmi, sťahovanie, príkaz pre šablóny, reporty chýb a CSV bez rizika vzorcov.

#### [Mapovanie stĺpcov](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/mapovanie-stlpcov.md)

Návrhy mapovania podľa hlavičiek, popisov, aliasov a podobných zápisov, map() podľa hlavičky či stĺpca a uložené mapovania, ktoré sa použijú samy.

#### [Overený náhľad](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/nahlad.md)

Relácie a stavy, každý riadok overený pred importom, počty, výsledky riadkov s chybami buniek, rozdiely aktualizácií, overenie vo fronte a režimy duplicít.

#### [Spustenie importu a priebeh](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/spustenie-importu.md)

Import ako jeden Laravel job batch idempotentných častí — priebeh, súhrn, výnimky v callbackoch, zrušenie a pokračovanie, zámok a evidencia záznamov.

#### [Vrátenie importu](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/vratenie-importu.md)

Vrátenie v časovom okne — vytvorené záznamy bez zmeny sa zmažú alebo odovzdajú vášmu háčiku, zmenené sa ponechajú v zozname, aktualizácie sa nevracajú.

#### [Dávky súborov](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/davky-suborov.md)

Viac súborov alebo ZIP, jeden záznam na súbor — FileImporter, povolené prípony, kontrola duplicít cez SHA-256, ImportFile a ochrana pred ZIP bombami.

#### [JSON API](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/json-api.md)

Voliteľné JSON API — každá cesta s overeným vstupom a odpoveďou, resolver vlastníka, obmedzenie nahrávania, chyby a resources bez názvov tried.

#### [Udalosti](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/udalosti.md)

Každá udalosť, ktorú balík spustí po potvrdení transakcie — nahratie, mapovanie, náhľad, štart, časti, dokončenie, zlyhanie, vrátenie, upratovanie.

#### [Výnimky](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/vynimky.md)

Každá výnimka s pomenovanými konštruktormi a HTTP stavom — odmietnutia, mapovanie, stav, oprávnenia, okno na vrátenie, chyby definície a konfigurácie.

#### [Príkazy Artisan](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/prikazy.md)

imports:sweep, prune, doctor, importers, template a install — čo robia, čo kontroluje doctor, plánovanie a ekvivalenty na fasáde.

#### [Testovanie](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/testovanie.md)

Imports::fake() zaznamenáva a prepúšťa ďalej — každá dvojica asercií, zaznamenané operácie, withoutRunning(), generátory tabuliek, factories a workbench.

#### [Požiadavky](https://roundly-consulting.com/sk/open-source/navody/imports-for-laravel/poziadavky.md)

PHP 8.4+ s rozšíreniami zip, xmlreader, xmlwriter a mbstring, Laravel 13, MySQL alebo PostgreSQL, front s job\_batches a štyri balíky Roundly.

## 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.md)