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

Exponential-Migrationen für Doctrine-Nutzer

Für Entwickler, die Doctrine Migrations aus der DXP kennen und jetzt an einer Exponential-6-Site arbeiten - was gleich ist, was sich unterscheidet (Inhalte wie Schema, Sicherungspunkte, Commit, Tag und Push, Umgebungen…

Download as PDF

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

On this page

This page is a translation. Read the English original

Exponential-Migrationen für Doctrine-Nutzer

Diese Seite ist für Entwickler, die die Datenbank von DXP-Projekten mit Doctrine Migrations ändern (Doctrine-Migrationen) und jetzt an einer Exponential-6-Site arbeiten, dem Kernel ohne Symfony. Exponential 6.0.15 hat eigene Migrationen. Die Idee ist die bekannte; Umfang und Sicherheitsnetz sind breiter.

Was gleich ist

  • Eine Datei je Änderung, nach einem Zeitstempel benannt, in Git mit dem Code, der sie braucht.
  • In Reihenfolge angewendet, je Datenbank aufgezeichnet, nie zweimal angewendet; eine gelaufene Migration wird nie geändert.
  • Ein Probelauf vor dem echten Lauf, up() zum Anwenden, down() zum Zurücknehmen einer Migration.
  • Ein Befehl in der Auslieferung, der anwendet, was aussteht.

Was sich unterscheidet

ThemaDoctrine Migrations (DXP)Exponential-6-Migrationen
Was eine Migration ändertSQL des Schemas und Ihrer eigenen Tabellenalles: Tabellen, Inhaltsklassen, Inhalte, Rollen, Einstellungen, über die APIs des Kernels
Die Klassefinal class Version20261101100000 extends AbstractMigrationfinal class NewsNote20261101100000 extends \expMigrationPhp in Site\Migrations
Reihenfolgenach Versionnach ID, dazu requires: im Kopf (andere Migrationen, Erweiterungen, Upgrade-Schritte des Kernels)
Die Aufzeichnungdoctrine_migration_versionsexp_migration und exp_migration_run, gespiegelt nach migrations/status/<umgebung>.json in Git
Geänderte Dateiennicht bemerktvon einer Prüfsummen-Sperre abgelehnt, außer --force --reason akzeptiert sie
Vor einem LaufIhr eigenes Backupein Sicherungspunkt (Dump, Speicher, Einstellungen), automatisch genommen, wiederverwendet, solange sich nichts geändert hat
Nach einem Fehlerdie Datenbank, wie der Fehler sie hinterließ (MySQL committet DDL)die Transaktion zurückgerollt, wo die Engine es kann, dann der Sicherungspunkt wiederhergestellt
Nach einem LaufnichtsStatusdatei und Laufprotokoll committet, getaggt und gepusht
Umgebungen--env wählt die Symfony-Konfigurationein Kopf environments: staging, production schränkt ein, wo eine Migration läuft
Schema-Diffdoctrine:migrations:diff erzeugt aus Entitätenkein Diff-Generator; exp:migration:generate --skeleton schreibt eine leere Klasse
EnginesMySQL, PostgreSQL, SQLiteMySQL/MariaDB, PostgreSQL, SQLite, Oracle, MongoDB
Oberflächenur KonsoleKonsole und Setup > Migrationen in der Administration

Die Befehle nebeneinander

Doctrine (DXP)Exponential 6
php bin/console doctrine:migrations:status./console exp:migration:status
doctrine:migrations:migrate --dry-run./console exp:migration:migrate (ein Probelauf bis --apply)
doctrine:migrations:migrate./console exp:migration:migrate --apply
doctrine:migrations:generate./console exp:migration:generate --skeleton <name> --apply
doctrine:migrations:execute --down <version>./console exp:migration:rollback <migrations-id> --apply
(keiner)./console exp:migration:rollback <run-id> --apply: der Sicherungspunkt von vor einem Lauf
(keiner)./console exp:migration:dry-run --simulate --diff: ausführen und zurückrollen, zeigen, was sich geändert hat
(keiner)./console exp:migration:check: die Prüfung für die CI, ohne Datenbank

Die Seiten der DXP schreiben die Befehle mit dem Alias doctrine:migration:*; dort funktionieren beide Schreibweisen.

Dieselbe Tabelle in beiden

Doctrine:

final class Version20261101100000 extends AbstractMigration
{
    public function getDescription(): string
    {
        return 'A table for news notes';
    }

    public function up( Schema $schema ): void
    {
        $this->addSql( 'CREATE TABLE news_note (id INT NOT NULL, title VARCHAR(150) NOT NULL, PRIMARY KEY(id))' );
    }

    public function down( Schema $schema ): void
    {
        $this->addSql( 'DROP TABLE news_note' );
    }
}

Exponential 6: die Tabelle im Format von share/db_schema.dba, vom Kernel auf jeder Engine angelegt:

<?php
// description: A table for news notes
namespace Site\Migrations;

final class NewsNote20261101100000 extends \expMigrationPhp
{
    const TABLE = 'news_note';

    public static function schema()
    {
        return array( self::TABLE => array(
            'name' => self::TABLE,
            'fields' => array(
                'id' => array( 'length' => 11, 'type' => 'int', 'not_null' => '1', 'default' => 0 ),
                'title' => array( 'length' => 150, 'type' => 'varchar', 'not_null' => '1', 'default' => '' ),
            ),
            'indexes' => array( 'PRIMARY' => array( 'type' => 'primary', 'fields' => array( 'id' ) ) ),
        ) );
    }

    public function plan( $context )
    {
        return array( 'create the table ' . self::TABLE );
    }

    public function detect( $context )
    {
        return \expKernelTableSchema::exists( self::TABLE, $context->db(), true ) ? \expMigration::DONE : null;
    }

    public function up( $context )
    {
        $messages = array();
        if ( !\expKernelTableSchema::install( array( self::TABLE ), $context->db(), self::schema(), $messages ) )
            throw new \RuntimeException( 'the table could not be created: ' . implode( '; ', $messages ) );
        return array( 'created ' . self::TABLE );
    }

    public function down( $context )
    {
        $context->db()->query( 'DROP TABLE ' . self::TABLE );
        \expKernelTableSchema::reset();
        return array( 'dropped ' . self::TABLE );
    }
}

Die Unterschiede im Code: kein SQL je Engine (der Schema-Handler schreibt es), plan() statt nur einer Beschreibung, detect(), damit eine Installation, die die Tabelle schon hat, die Migration als erledigt zählt, und jeder Aufruf geht über $context->db(), die Verbindung des Laufs. Kernel-Code bleibt PHP-7.4-kompatibel: Rückgabetypen sind nicht nötig.

Wann welcher Stack gilt

Sie arbeiten anNehmen Sie
einem DXP-Projekt (Symfony, das Content-Repository)Doctrine Migrations, wie es das Skeleton der DXP tut
einer Exponential-6-Site (der Kernel, ./console)exp:migration:*
einem Projekt, das beides betreibtdas Werkzeug jedes Stacks auf seiner eigenen Datenbank; zeichnen Sie nie die Änderung des einen Stacks in der Tabelle des anderen auf

DXP, Legacy, Nexus oder Exponential 6 wählen erklärt die Stacks. Eine Site von einem Stack auf den anderen umzuziehen, ist ein Umzug der Site, keine Migrationsdatei: Migrationen oder Umzug einer Site.

Wie es weitergeht

Verwandte Seiten

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