Stacks & Versionen

Managed oder Custom?

Ein Projekt kann Backend, Frontend oder beides haben. none deaktiviert eine Rolle; mindestens eine Rolle muss aktiv bleiben. Custom ist eine aktive Rolle ohne Managed-Framework.

• Managed: Dwell legt bei Bedarf die Anwendung an, installiert Abhängigkeiten und liefert die dokumentierte lokale Integration. Du wählst aus dem mitgelieferten Katalog.
• Custom: Du installierst und pflegst Anwendung, Abhängigkeiten, Framework-Versionen und Anwendungskonfiguration selbst. Dwell stellt die generische lokale Runtime, Routing und verfügbare Development-Services bereit.

Backend und Frontend auswählen

Nutze die interaktive Auswahl bei dwell init oder gib die Typen als Flags an. Alle aktuellen Managed-Backends sind PHP-basiert.

Managed-Backends

• Symfony (symfony)
• Laravel (laravel)
• WordPress (wordpress)
• TYPO3 (typo3)
• Shopware 6 (shopware6)

Managed-Frontends

• React + Vite (react)
• Vue + Vite (vite-vue)

Wähle PHP passend zur Backend-Versionslinie. Dwell prüft die Kombination beim Anlegen, bei Stack-Änderungen und beim Laden der Konfiguration. PHP 8.4 ist der Standard für neue Projekte. Ältere PHP-Linien können als Legacy-/EOL-Kompatibilitätsoption erscheinen; sie sind keine Empfehlung für neue Projekte.

React und Vue laufen mit Vite auf deinem Rechner. Ihre Node-Anforderungen können über dem CLI-Minimum liegen; build und up prüfen die gewählte Frontend-Anforderung.

Versionen verstehen

Prüfe vor der Auswahl den Katalog deiner installierten Dwell-Version. Neue Upstream-Releases werden nicht automatisch zu angebotenen Profilen.

dwell versions list

Version Line

Die Profil-Linie, etwa Symfony 7.4 oder React 19.3. Sie wird mit --backend-version oder --frontend-version gewählt.

Default / Standard

Die Vorauswahl für einen Typ. Sie ist unabhängig vom Lifecycle-Label.

Lifecycle

recommended bezeichnet ein bevorzugtes Profil, supported eine kuratierte Alternative und legacy eine ältere Kompatibilitätsoption. Der separate Upstream-Status ist keine Zusage für deine gesamte Anwendung.

Verification

metadata-reviewed, scaffold-tested und runtime-tested beschreiben die vorhandene Prüftiefe. Sie garantieren nicht jede Kombination aus Betriebssystem, Architektur und Anwendung.

Pin

Die konkret kuratierte Scaffold-, Framework- oder Generator-Version. Ein Generator-Pin ist nicht die Framework-Version. Tatsächlich aufgelöste Abhängigkeiten bleiben in den Projekt-Lockfiles festgehalten.

Ein Projekt mit festen Versionen

Dieses neue Projekt verwendet die aktuell angebotenen Linien Symfony 7.4 und React 19.3 mit kompatiblem PHP 8.4. Führe die Befehle im Elternverzeichnis des neuen Projektordners aus.

dwell init mein-projekt \
  --backend symfony \
  --backend-version 7.4 \
  --frontend react \
  --frontend-version 19.3 \
  --php 8.4
cd mein-projekt
dwell build
dwell up

Bewahre composer.lock und package-lock.json im Projekt auf. Eine Versionslinie allein garantiert keine über die Zeit identischen Neuinstallationen.

Custom-Rollen verwenden

Custom PHP verwendet eine unterstützte PHP-Runtime und einen Webroot relativ zum Backend-Verzeichnis. Custom Frontend startet deinen eigenen Development-Command.

dwell init custom-php --backend custom --backend-webroot public --php 8.4

dwell init custom-frontend --frontend custom --frontend-dev-command '{"command":"npm","args":["run","dev"]}'

Die Beispiele legen getrennte neue Projekte an. Ergänze danach deinen Anwendungscode und installiere seine Abhängigkeiten selbst. Beim Custom Frontend muss der Startcommand HOST=127.0.0.1 und den zugewiesenen PORT berücksichtigen. Custom ist keine garantierte Framework-Integration.

Hinweise & Grenzen

Dwell aktualisiert vorhandene Anwendungen nicht stillschweigend. stack set erfordert ein gestopptes Projekt und kann Typ oder Framework-Version nur ändern, wenn das bisherige Rollenverzeichnis leer ist. Es führt keine Framework-Migration durch. Eine reine PHP-Änderung ist möglich, wenn sie zum Backend-Profil passt.

Als Nächstes

Starte dein Projekt mit dem Projekte-Guide oder lerne, welche Einstellungen du über die Konfigurations-Commands änderst. Die Produktseite erklärt den Umfang des Managed-Katalogs.

Technische Referenz