Download the PHP package inlayphp/imports without Composer
On this page you can find all versions of the php package inlayphp/imports. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download inlayphp/imports
More information about inlayphp/imports
Files in inlayphp/imports
Package imports
Short Description Validated import previews and row processing for Laravel and Inlay.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package imports
Inlay Imports
Validated import previews and row processing for Laravel and Inlay
inlayphp/imports is the official optional import pipeline for Inlay applications. It provides renderer-neutral import definitions, column mapping, previews, row-isolated validation, persistence, and downloadable failure data. It builds on inlayphp/validation so interactive forms and imports can use the same native Laravel rules.
The core deliberately does not parse files, store uploads, dispatch queues, or expose HTTP routes. Applications choose their CSV/XLSX parser and transport while reusing one import pipeline.
Optional package boundary
Imports are intentionally outside the lean inlayphp/inlay installation. Many admin applications never import spreadsheets, and file parsing, upload retention and queues introduce choices that do not belong in the panel core.
Install this standalone package when an application needs the reusable PHP definition/preview/processing pipeline. It:
- depends only on the official
inlayphp/validationpackage, not the panel or frontend stack; - can run from controllers, console commands, jobs, APIs, or an Inlay panel;
- registers no routes, plugin navigation, parser, upload storage or queue implementation;
- does not require React or Vue;
- pairs optionally with
@inlayphp/imports-reactor@inlayphp/imports-vuewhen an interactive wizard is desired.
Installation
Define an importer
ImportColumn supports a label, source-header aliases, required mapping, and castUsing(). The caster receives the source value, full original row, and execution options.
Importer hooks run in this order for every row: map/cast, transform(), resolveRecord(), authorize(), validation class, then persist(). operation() and user() populate the ValidationContext; its source is always ValidationContext::SOURCE_IMPORT. Override strictUnknownColumns() to reject source headers that were not mapped.
Build the UI resource
Endpoint values are metadata for a host frontend; this package does not call or register them. Individual uploadEndpoint(), previewEndpoint(), startEndpoint(), and statusEndpoint() setters are also available. A server-rendered ImportPreview may be attached with preview().
inlay.imports.v1 contract
maxFileSize is always kilobytes. Enforce accepted types and size again on the server; frontend checks are only feedback.
Preview rows
Parse the uploaded file into a list of associative rows, then call ImportValidator:
When mapping is omitted, names, labels, and aliases are matched case-insensitively. Required, missing-source, and strict unknown-column problems appear in mappingErrors. Preview row numbers begin at 2 to account for a header row.
Each row reports original data, transformed/validated data, validity, field errors, and a failure stage: cast, transform, resolve, authorization, or validation.
Process an import
Definition options are merged with call-site options, with call-site values winning. The processor attempts every row. Mapping errors fail all rows without persistence; other failures remain isolated to their row. Persistence exceptions use the persistence stage. failurePayload() adds _import_row, _import_stage, and _import_errors fields suitable for a CSV/XLSX download adapter.
For large imports, dispatch a job containing a stable upload reference, parse rows in the job, call this same processor, and publish progress through your own cache/database/events. Apply authorization both when starting a job and per row; never serialize an entire authenticated user object into an untrusted frontend option.
Frontend and testing
@inlayphp/imports-reactimplements the five-step React wizard.@inlayphp/imports-vueimplements the matching Vue wizard.
Related official packages: lean inlayphp/inlay remains usable without import support; inlayphp/validation supplies the shared profile engine; optional @inlayphp/imports-react and @inlayphp/imports-vue provide transport-agnostic wizards for this contract.
