Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Doctrine-Migrationen

Datenbankänderungen in einem DXP-Projekt mit doctrine/doctrine-migrations-bundle - ausstehende Migrationen bei jeder Aktualisierung ausführen, SQL in der Vorschau ansehen, Migrationen für eigene Tabellen schreiben und…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/dxp-developers/doctrine-migrations.md

On this page

This page is a translation. Read the English original

Doctrine-Migrationen

Diese Seite richtet sich an Entwickler, die die Datenbank eines DXP-Projekts ändern oder Änderungen bereitstellen, die das tun. Die DXP verlangt doctrine/doctrine-migrations-bundle; die Anleitung des Skeletons führt Migrationen bei jeder Aktualisierung und Bereitstellung aus.

Inhalt

  1. Installieren gegenüber Migrieren
  2. Die Befehle
  3. Ihre eigenen Tabellen
  4. In einer Bereitstellung
  5. Regeln

Installieren gegenüber Migrieren

BefehlWann
exponential:install exponential-osseinmal, auf einer leeren Datenbank
doctrine:migration:migrate --allow-no-migrationdanach bei jeder Aktualisierung und Bereitstellung

Führen Sie den Installationsbefehl nie gegen eine Datenbank mit Inhalten aus, um sie zu "aktualisieren".

Die Befehle

Aus der CLI-Referenz der Anleitung (Abschnitt 22.2):

php bin/console doctrine:migration:status                         # pending and applied
php bin/console doctrine:migration:migrate --dry-run              # preview the SQL
php bin/console doctrine:migration:migrate --allow-no-migration   # apply pending migrations
php bin/console doctrine:migration:diff                           # generate a migration from your entity changes
php bin/console doctrine:migration:execute --up <version>         # one migration up
php bin/console doctrine:migration:execute --down <version>       # roll one back
php bin/console doctrine:schema:validate                          # mapping versus database

Ihre eigenen Tabellen

Speichert Ihr Projekt eigene Daten mit Doctrine-Entities in src/Entity/, ändern Sie die Entity, erzeugen Sie mit doctrine:migration:diff eine Migration, lesen Sie das erzeugte SQL und committen Sie die Migration mit dem Code, der sie braucht. Testen Sie sie auf jeder Datenbank-Engine, die Sie unterstützen: MySQL, PostgreSQL und SQLite unterscheiden sich bei Typen und darin, was ALTER TABLE kann.

Speichern Sie Inhalte im Inhalts-Repository (Inhaltstypen und Felder), nicht in eigenen Tabellen, es sei denn, es sind wirklich keine Inhalte: Dann erhalten sie Versionen, Übersetzungen, Berechtigungen und APIs des Repositorys umsonst.

In einer Bereitstellung

php bin/console doctrine:migration:migrate --allow-no-migration --env=prod

Sichern Sie vorher die Datenbank, führen Sie Migrationen aus, bevor der neue Code Verkehr bedient, und leeren Sie danach den Cache (Bereitstellen).

Regeln

  • Eine Migration, die irgendwo gelaufen ist, wird nie geändert; schreiben Sie eine neue.
  • Eine Migration muss auf einer leeren Datenbank und auf Produktionsdaten funktionieren.
  • doctrine:database:drop --force gibt es; führen Sie es nie auf einem Server aus, den Sie nicht leeren wollten.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x