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!