Download the PHP package markocupic/import-from-csv-bundle without Composer

On this page you can find all versions of the php package markocupic/import-from-csv-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package import-from-csv-bundle

Logo

Import from CSV (Backend-Modul für Contao CMS)

Mit diesem Modul lassen sich über eine CSV-Datei in einem Rutsch grosse Mengen an Datensätzen importieren – praktisch, wenn z.B. sehr viele Benutzer oder Mitglieder angelegt werden müssen. Die CSV-Datei erstellt man am besten in einem Tabellenkalkulationsprogramm (z.B. MS Excel) und speichert sie als kommaseparierte Datei (CSV) ab. Ein Beispiel für eine solche Datei findet sich im Verzeichnis docs.

https://user-images.githubusercontent.com/1525166/150694067-e4438409-d6b0-42c7-853b-1b273a2f5064.mp4

Warnung!

[!CAUTION] Das Modul bietet einen grossen Nutzen, erfordert aber Sorgfalt: Bei falscher Anwendung können Datensätze gelöscht oder unbrauchbar gemacht werden, sodass Contao anschliessend nicht mehr funktionstüchtig ist. Setzen Sie das Modul nur ein, wenn Sie wissen, was Sie tun.

Aufbau der CSV-Importdatei

Die Importdatei ist eine kommaseparierte Textdatei (CSV), die sich mit MS Excel oder einem Texteditor erstellen lässt. In die erste Zeile gehören zwingend die Feldnamen. Die einzelnen Felder werden durch ein Trennzeichen (üblicherweise das Semikolon ;) voneinander abgegrenzt. Feldinhalte, die in der Datenbank als serialisiertes Array abgelegt werden (z.B. Gruppenzugehörigkeiten, Newsletter-Abos usw.), werden durch zwei aufeinanderfolgende Pipe-Zeichen getrennt, z.B. 2||5. Feldtrennzeichen und Feldbegrenzer lassen sich individuell festlegen.

[!IMPORTANT] Jeder Datensatz gehört in eine eigene Zeile – Zeilenumbrüche innerhalb eines Datensatzes machen den Import unmöglich. Die fertige CSV-Datei wird über die Contao-Dateiverwaltung auf den Webserver geladen und kann anschliessend in der Import-Konfiguration ausgewählt werden.

Beim Import werden die Inhalte auf Gültigkeit geprüft; als Grundlage dienen die DCA-Einstellungen der Zieltabelle.

[!CAUTION] Das Modul sollte nur genutzt werden, wenn man sich seiner Sache sehr sicher ist. Gelöschte Daten lassen sich nur wiederherstellen, wenn zuvor ein Datenbank-Backup erstellt wurde.

Einstellungen

Kommaseparierte Datei erstellen und hochladen

Als Erstes muss eine CSV-Datei erstellt werden. In die Kopfzeile gehören die Feldnamen.

Zeichenkodierung (UTF-8)

[!WARNING] Speichern Sie die CSV-Datei UTF-8-kodiert ab, damit Umlaute (ä, ö, ü, …) und Sonderzeichen korrekt in die Datenbank importiert werden. Contao arbeitet intern mit UTF-8. Wird die Datei in einer anderen Kodierung (z.B. ISO-8859-1 / Windows-1252, oft als „ANSI" bezeichnet) gespeichert, landen Umlaute verstümmelt in der Datenbank – aus „Müller" wird dann z.B. „Müller".

So speichern Sie UTF-8 aus den gängigen Programmen:

Tipp: Speichern Sie möglichst UTF-8 ohne BOM. Ein vorangestelltes BOM (Byte Order Mark) kann den Namen des ersten Feldes in der Kopfzeile verfälschen und so die Feldzuordnung stören.

Datentabelle für den Import auswählen (Pflichtfeld)

Wählen Sie die Tabelle, in die die Datensätze importiert werden sollen.

Eindeutiges Feld für Updates

Dieses Feld wird genutzt, um Datensätze zu identifizieren, die bereits in der Datenbank existieren. Wird ein Datensatz mit einem bereits vorhandenen Wert in diesem Feld gefunden, wird er aktualisiert. Ansonsten wird ein neuer Datensatz angelegt.

Felder für den Importvorgang auswählen (Pflichtfeld)

Hier können pro Zeile ein Feld in der Datenbank und das entsprechende Feld in der CSV-Datei angegeben werden. Die Feldnamen in der CSV-Datei müssen exakt mit den Feldnamen in der Kopfzeile der CSV-Datei übereinstimmen.

Feldname in der Datenbank Feldname in der CSV-Datei
firstname Vorname
lastname Nachname
phone Tel.

Werte transformieren

Da die Daten in der CSV-Datei nicht immer exakt so vorliegen, wie Contao sie erwartet, können die Feldinhalte vor dem Import transformiert werden.

Beispiel:

Feldname in der Datenbank Wert in der CSV-Datei Ändern in Feldwert in Kleinbuchstaben transformieren Feldwert in Großbuchstaben transformieren
gender Herr male
gender Frau female
gender Divers other
country 1
language 1

Felder getrennt von (Pflichtfeld)

Geben Sie an, durch welches Zeichen die Feldinhalte in der CSV-Datei voneinander getrennt sind.

Felder eingeschlossen von (Pflichtfeld)

Prüfen Sie, ob die Feldinhalte in der CSV-Datei zusätzlich von einem Zeichen eingeschlossen sind. Häufig ist das das doppelte Anführungszeichen (").

Import-Modus (Pflichtfeld)

Legen Sie fest, ob die Datensätze an die Zieltabelle angehängt werden oder ob die Zieltabelle vorher geleert werden soll (»alter table«).

[!CAUTION] Ohne Backup lassen sich gelöschte Datensätze nicht mehr wiederherstellen.

Datei auswählen (Pflichtfeld)

Wählen Sie abschliessend die Datei aus, aus der in die Datenbank geschrieben werden soll. Tipp: Klicken Sie nach der Auswahl zunächst auf „Speichern", um eine Vorschau des Dateiinhalts zu erhalten.

Zeilenumbrüche

Alle [NEWLINE]-Tags in der CSV-Datei werden beim Import in \r\n bzw. \n umgewandelt.

Leere Feldwerte

Leere Feldwerte werden nicht verarbeitet. Beim Import eines neuen Datensatzes wird stattdessen der Default-Wert aus $GLOBALS['TL_DCA']['tl_my_table']['fields']['myField']['sql'] gesetzt.

Cronjob

Auf Wunsch lässt sich CRON aktivieren, sodass der Import in einem festgelegten Intervall automatisch ausgeführt wird.

Konfiguration

Über die Bundle-Konfiguration lassen sich zwei Werte anpassen. Erstellen Sie dazu – falls noch nicht vorhanden – im Projekt die Datei config/config.yaml und ergänzen Sie:

Parameter Standard Erklärung
preview_limit 200 Anzahl der Datensätze, die in der Vorschau (nach dem Speichern der Import-Konfiguration) angezeigt werden.
max_inserts_per_request 25 Anzahl der Datensätze, die pro Request importiert werden. Der Import wird in mehreren aufeinanderfolgenden Requests abgearbeitet, um Zeit- und Speicherlimits zu vermeiden.

Beide Werte müssen ganze Zahlen grösser 0 sein. Ungültige Angaben (0, negativ oder keine Ganzzahl) führen bereits beim Aufbau des Containers zu einem Konfigurationsfehler.

[!IMPORTANT] Passwörter: Werden beim Import Passwörter gehasht (z.B. beim Import in tl_member oder tl_user mit einer password-Spalte), ist das Hashing (bcrypt/argon2) bewusst sehr rechenintensiv. Wählen Sie max_inserts_per_request in diesem Fall klein (z.B. 5–10), damit ein einzelner Request nicht in das PHP-Zeitlimit (max_execution_time) oder ins Speicherlimit läuft. Ohne Passwort-Hashing kann der Wert deutlich höher gewählt werden.

Importmechanismus über Event-Listener anpassen

Über einen Event Listener lässt sich die Validierung umgehen oder anpassen. Im folgenden Beispiel werden die Geokoordinaten beim Import anhand von Strasse, Stadt und Länderkürzel automatisch per cURL-Request von Google Maps ermittelt. Ausserdem lassen sich Fehlermeldungen erzeugen, etwa wenn keine Geokoordinaten ermittelt werden konnten – der betreffende Datensatz wird dann übersprungen und nicht in die Datenbank geschrieben.

Hier der Aufbau einer möglichen Event-Listener-Klasse.

Verfügbare Events

Eventname Beschreibung
PreValidateWidgetEvent Wird vor der Validierung eines Feldes ausgelöst.
PreImportRowEvent Wird vor dem Import eines Datensatzes ausgelöst.
PostImportRowEvent Wird nach dem Import eines Datensatzes ausgelöst.
PostImportBatchEvent Wird nach dem Import eines Import-Requests ausgelöst.
ConfigImportEvent Wird nachdem die Konfiguration erzeugt wurde ausgelöst.

Viel Spass mit dem Import From CSV Bundle!

All versions of import-from-csv-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.3
contao/core-bundle Version ^5.7
league/csv Version ^9.27
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package markocupic/import-from-csv-bundle contains the following files

Loading the files please wait ...