ex-akt/contao-webpack-config-bundle

Shared Webpack Config for our customer Contao projects

1.2 2023-12-05 14:47 UTC

Requires

• php: ^7.4 || ^8.0
• contao/core-bundle: ^4.13 || ^5.1
• symfony/config: ^5.4 || ^6.1
• symfony/dependency-injection: ^5.4 || ^6.1
• symfony/http-kernel: ^5.4 || ^6.1

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.5
• contao/manager-plugin: ^2.0
• phpunit/phpunit: ^9.5
• symfony/phpunit-bridge: ^6.1

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Samuel Heer

README

Dieses Bundle enthält eine standardisierte Webpack-Config für alle Kundenprojekte. Damit muss nicht bei jedem Kundenprojekt die npm Abhängigkeiten laufend aktuell gehalten werden, sondern die Abhängigkeiten werden in diesem Bundle gepflegt.

Install

composer require ex-akt/contao-webpack-config-bundle

Ergänze folgende Scripts in deiner Root composer.json:

 "scripts": {
   ...
    "npm-install":[
        "npm --prefix vendor/ex-akt/contao-webpack-config-bundle install"
        ],
    "dev": [
        "npm --prefix vendor/ex-akt/contao-webpack-config-bundle run dev"
        ],
    "prod": [
        "npm --prefix vendor/ex-akt/contao-webpack-config-bundle run prod"
        ]
    }

Anwendung

Nach dem ersten composer require, oder composer update müssen die npm-Abhängigkeiten geladen werden:

composer run npm-install

Danach kann die lokale Entwicklungsumgebung gestartet werden:

composer run dev

Projekt-Deployment

Für die Einbindung von Webpack ins Projekt-Deployment kann das Skript "prod" aufgerufen werden:

composer run prod

Deployment über Mage

Füge der Mage-Konfiguration folgende Zeile hinzu:

- exec: { cmd: 'php -d memory_limit=-1 /usr/local/bin/composer.phar run prod', desc: 'Running Symfony Encore' }

Hinweis: Dieser Code funktioniert nicht zuverlässig auf allen Geräten, daher ist der Mage-Teil Produktion als "buggy" einzustufen.

Bekannte Schwachstellen:

1. Beim zukünfigten composer-Update fragt composer, was er mit Änderungen im Package contao-webpack-config-bundle machen soll. An dieser Stelle kann mit "y" geantwortet werden.