Datenbankversionierung mit Leitermigrationen

Kernpunkte

• Leiter ist ein Tool zum Erstellen, Ausführen und Verwalten von Datenbankmigrationen, mit denen Änderungen in Datenbankschemata auf die gleiche Weise wie der Anwendungscode verfolgt werden können. Dieses Tool kann in jedes große Framework integriert werden und für Änderungen und Feature -Management in der Versionskontrolle verwendet werden.
• Migrationen werden immer nacheinander ausgeführt, und die Leiter stellt dies sicher, indem Migrationen nach Abfolge und Speichern der in der Datenbank selbst durchgeführten Migrationen gespeichert werden, wodurch die Wiederholung früherer Migrationen verhindern.
• Leiter ermöglicht auch die Erstellung von Vorbekämpfung oder "Saatgut" -Datenbanken, z. B. Standardbenutzerkonten. Dies kann mit dem Schlüsselwert des Ladders erfolgen, der einige Daten zur späteren Referenz speichert.
• Das Tool enthält zusätzliche Befehle zum Verwalten und Überwachen von Datenbanken, z. B. den Statusbefehl für den Datenbankstatus, die Diff- und Diff-Save-Befehle für das Dumping und Wiederherstellen des Datenbankstatus sowie die Versionsbefehle zur Überprüfung der verwendeten Version der Leiterversion.

Versionskontrollsysteme sind von unschätzbarem Wert für die Verfolgung von Änderungen im Code, insbesondere bei der Arbeit in Teams. Die meisten Anwendungen enthalten jedoch mehr als nur Anwendungscode. Das Verwalten von Änderungen an Datenbanken war schwieriger, insbesondere wenn neue Funktionen hinzugefügt werden, die sich ändern müssen.

Angenommen, Sie arbeiten an einem Modul und stellen fest, dass eine Datenbanktabelle eine zusätzliche Spalte erfordert. Möglicherweise möchten Sie ein Datenbank -Query -Tool oder eine Befehlszeile öffnen und diese Spalte einfach hinzufügen. Dies hinterlässt jedoch keine Aufzeichnung von Änderungen wie der Versionskontrollcode von Versionen. Dies kann bei der Arbeit in einem Team verschärft werden. Wenn Kollegen Ihre Codeänderungen extrahieren, ohne dasselbe Datenbank -Update auszuführen, stürzt ihre Anwendungsversion höchstwahrscheinlich ab. Dies wird noch problematischer, wenn Sie Produktaktualisierungen veröffentlichen, da dies die App nicht nur für Ihre Kollegen, sondern auch für Ihre Benutzer brechen kann.

Eine Lösung besteht darin, die Migration zu verwenden, um die Verantwortung für das Erstellen und Ändern von Datenbankschemata in Ihren Code zu übertragen. Auf diese Weise können Änderungen zusammen mit dem Rest der Anwendung verwaltet werden, und wir können Funktionen verwenden, an die wir in der Versionskontrolle gewöhnt sind (z. B. in der Lage sind, Versionen zu vergleichen und Audit -Trails zu halten), um Datenbankwechsel zu verarbeiten. Es ermöglicht auch, dass diese Änderungen nahtlos in die Version integriert werden, da sie Teil desselben Zweigs oder Tags sein können.

Viele wichtige Frameworks haben ihre eigenen Migrationsimplementierungen, aber für diejenigen, die nicht - wenn Sie keine verwenden - können Sie eine Leiter verwenden.

Leiter Einführung

Leiter ist ein Tool zum Erstellen, Ausführen und Verwalten von Datenbankmigrationen. Migration ist nur eine PHP -Klasse, daher kann die Versionskontrolle mit dem Rest des Code der Anwendung eingecheckt werden.

Sie können in einer einzigen Migration so viele Änderungen am Schema vornehmen, obwohl es am besten ist, die Migration auf eine einzelne Tabelle oder Funktion zu beschränken.

Migrationen werden immer in der Reihenfolge ausgeführt. Nehmen wir also an, Sie schreiben eine Migration, um die Produkttabelle zu erstellen und einige Wochen später eine neue Migration zu erstellen, um eine zusätzliche Spalte hinzuzufügen. Der Versuch, das erstere zu führen, bevor der letztere einen Fehler erzeugt. Ladder löst dieses Problem, indem Migrationen nach Abfolge und Speichern von Datensätzen (und Zeiten) des Ausführens von Migrationen in der Datenbank selbst nummeriert werden.

Installation

Leiter kann von Bitbucket oder Komponist heruntergeladen werden. Es dauert jedoch mehrere Schritte, um auf dem Betrieb zu gehen.

Der einfachste Weg (obwohl es zugibt, weniger elegant zu sein) ist es, sie aus der Projektwurzel herunterzuladen oder zu klonen und in ein Verzeichnis namens Leiter zu platzieren. Das Problem bei der Verwendung von Composer ist, dass das Ausführen von Composer -Update Ihre Konfigurationsdatei überschreibt.

Es gibt fünf Konfigurationsdateien, von denen jede manuell erstellt werden muss.

cp ladder/config/config.php.example ladder/config/config.php
cp ladder/config/database.php.example ladder/config/database.php
cp ladder/config/diff.php.example ladder/config/diff.php
cp ladder/config/editor.php.example ladder/config/editor.php
cp ladder/config/table.php.example ladder/config/table.php

Möglicherweise müssen Sie database.php (die Datenbankverbindungsdetails enthält) und Editor.php ändern, wo Sie den bevorzugten Texteditor angeben und beim Erstellen eine neue Migration automatisch öffnen können.

Migration erstellen

Beginnen wir zunächst eine Migration, um die Benutzertabelle zu erstellen.

in der Befehlszeile:

php ladder/ladder.php create create_users_table

Dies erstellt eine Datei mit dem Namen Ladder/Migrations/00001_Create_Users_table, die standardmäßig eine grundlegende Struktur mit kommentierten Beispielanrufen enthält. Wenn Sie in Ladder/config/editor.php automatisch auf TRUE festgelegt haben, wird diese Datei sofort im angegebenen Texteditor geöffnet. Sie können Migrationen nach Belieben anrufen, aber es wird hilfreich sein, zu sehen, was die Migration aus dem Dateinamen auf einen Blick tut.

Hier ist, was die Datei aussehen könnte (ich habe die kommentierte Codezeile für Klarheit gelöscht):

class Create_Users_Table_Migration_00001 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->create_table('users')
            ->column('email', 'varchar', array('limit' => 128, 'null' => FALSE))
            ->column('password', 'varchar', array('limit' => 32, 'null' => FALSE));
    }

    public function down() {
        $this->table('users')->drop();
    }   
}

rufen Sie die up () -Methode auf, wenn die Migration ausgeführt wird, und die Down () -Methode, wenn die Migration zurückgerollt wird. Daher muss immer die entgegengesetzte Operation mit der UP () -Methode durchführen. In diesem Beispiel erstellt die UP () -Methode eine Tabelle mit dem Namen Benutzer, und die Down () -Methode löscht sie.

Die Methode

create_table () gibt eine Referenz auf die neue Tabelle zurück, während die Tabellenklasse eine Spalte () -Methode hat, um eine neue Spalte hinzuzufügen. Es verfügt über eine glatte Schnittstelle, sodass Sie sie miteinander verknüpfen können, um mehrere Spalten gleichzeitig zu erstellen. Sie werden feststellen, dass es keine ID -Spalte gibt - diese wird automatisch erstellt - d. H. Eine automatisch inkrementelle Ganzzahl -Primärschlüssel mit dem Namen ID.

table () gibt einen Verweis auf die Tabelle zurück, aber sie erstellt auch die Tabelle, wenn die Tabelle noch nicht vorhanden ist - sodass Sie den Aufruf create_table () auf Tabelle ()

sicher ändern können

Erstellen wir eine andere Migration, diesmal erstellen Sie Rollentabelle:

php ladder/ladder.php create create_roles_table

Datei selbst:

class Create_Roles_Table_Migration_00002 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('roles')
            ->column('nme', 'varchar', array('limit' => 128, 'null' => FALSE));            
    }

    public function down() {
        $this->table('roles')->drop();
    }   
}

Jetzt müssen Sie die Migration tatsächlich ausführen. Um dies zu tun:

php ladder/ladder.php migrate

Wenn Sie sich die Datenbank ansehen, finden Sie vier Tabellen:

Migrationen werden automatisch erstellt, um zu verfolgen, welche Migrationen ausgeführt wurden Migrations_kvdata wird auch für Sie erstellt, und Ihre Migrationen können für jeden Schlüsselwertspeicher verwendet werden Benutzer und Rollen sind die Tabellen, die wir gerade hinzugefügt haben.

Wenn Sie jedoch die Migration der Rollen genau beachten, werden Sie feststellen, dass sie eine Spalte namens NME anstelle des Namens erstellt. Zu diesem Zeitpunkt können wir dies beheben, indem wir die Migration "rückgängig machen", die Klasse ändern und erneut ausführen. Rollen Sie die Migration zurück:

cp ladder/config/config.php.example ladder/config/config.php
cp ladder/config/database.php.example ladder/config/database.php
cp ladder/config/diff.php.example ladder/config/diff.php
cp ladder/config/editor.php.example ladder/config/editor.php
cp ladder/config/table.php.example ladder/config/table.php

Nummer 2 zeigt an, dass die Migration zurückgerollt werden soll - es ist das Präfix des Migrationsdateinamens ohne führende Nullen.

Jetzt können Sie einfach die Korrektur vornehmen und die Migration erneut ausführen:

php ladder/ladder.php create create_users_table

Da in der Migrations Tabelle Datensätze über laufende und unreinhafte Inhalte gespeichert wurden, müssen Sie sich keine Sorgen machen, dass Ihre erste Migration umgeleitet wird.

Es gibt auch einen schnelleren Weg, um eine Neubewertung zu verwenden:

class Create_Users_Table_Migration_00001 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->create_table('users')
            ->column('email', 'varchar', array('limit' => 128, 'null' => FALSE))
            ->column('password', 'varchar', array('limit' => 32, 'null' => FALSE));
    }

    public function down() {
        $this->table('users')->drop();
    }   
}

Auf diese Weise wird die Down () -Methode der zweiten Migration gleichzeitig und dann die up () -Methode aufgerufen.

nun sagen wir nach einer Weile, wir entwickeln eine neue Funktion, für die die Benutzertabelle ein Statusfeld enthalten muss. Dazu müssen wir eine neue Migration erstellen:

php ladder/ladder.php create create_roles_table

Die Migration sieht so aus:

class Create_Roles_Table_Migration_00002 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('roles')
            ->column('nme', 'varchar', array('limit' => 128, 'null' => FALSE));            
    }

    public function down() {
        $this->table('roles')->drop();
    }   
}

Wie zuvor laufen Sie mit dem folgenden Befehl:

php ladder/ladder.php migrate

Wenn Sie jetzt Ihre Datenbank überprüfen, werden Sie feststellen, dass die Benutzertabelle eine neue Spalte enthält.

Datenbanksaat

Zusätzlich zum Schreiben von Migrationen zum Verwalten von Datenbankschemata können Sie auch Leiter verwenden, um Datenbanken vorzubeziehen (d. H. Saatgut-) Datenbanken.

Sie können beispielsweise die Migration create_users_table erweitern, um ein Standard -Root -Benutzerkonto zu erstellen:

php ladder/ladder.php remove 2

Beachten Sie, dass wir die Methoden SET () und GET () verwenden, um den Schlüsselwert des Ladders zu nutzen und die Benutzer-ID zu speichern, damit wir uns später darauf verweisen können.

Sie können auch Daten aus migrierten CSV -Dateien importieren, zum Beispiel:

php ladder/ladder.php migrate

Um zu aktualisieren, anstatt CSV -Daten einzuführen, können Sie dies tun:

php ladder/ladder.php reapply 2

In diesem Fall bedeutet der Parameter Senden, dass wir das Update ausführen möchten, und der dritte Parameter enthält eine Liste der Schlüsselfelder, um festzustellen, welche Datensätze aktualisiert werden sollen.

Hinzufügen anderer Datenbanken

Sie werden feststellen, dass die Standarddatenbank-Konfigurationsdateileiter/config/database.php zeigt, wie zusätzliche Datenbankverbindungen hinzugefügt werden. Zum Beispiel:

php ladder/ladder.php create add_status_to_users_table

Sie können die Verbindung wie folgt angeben:

class Add_Status_To_Users_Table_Migration_00003 extends Migration {
    protected $min_version = '0.8.1';

    public function up() {
        $this->table('users')
            ->column('status', 'integer', array('null' => FALSE, 'default' => 0));            
    }

    public function down() {
        $this->table('users')->drop_column('status');      
    }
}

Andere Befehle

Status

Sie können den Befehl Status verwenden, um den Datenbankstatus zu erhalten:

php ladder/ladder.php migrate

Beispielausgabe: (Die Beispielausgabe wird hier weggelassen, da das Originaldokument keinen spezifischen Ausgabeinhalt enthält)

diff und diff-save

(Die Beschreibungen der Diff- und Diff-Save-Befehle werden hier weggelassen, da diese Befehle im Originaldokument ausführlich beschrieben wurden)

Version

(Die Beschreibung des Versionsbefehls wird hier weggelassen, da der Befehl im Originaldokument ausführlich beschrieben wurde)

Zusammenfassung

In diesem Artikel wird eine Leiter eingeführt, mit der das Datenbankschema verwaltet und Daten vorbestimmt werden. (Der Zusammenfassungsteil wird hier weggelassen, da das Originaldokument die Leiter zusammengefasst hat)

FAQs über Datenbankversioning und Leitermigration

(Der FAQ -Abschnitt wird hier weggelassen, da das Originaldokument bereits detaillierte FAQ enthält)

Das obige ist der detaillierte Inhalt vonDatenbankversionierung mit Leitermigrationen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!