FDS2610/FSCash
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
FSCash/migrations/README.md
fds2610-bot cf7371fb40 Deploy-Skript update.sh mit DB-Migrationssystem hinzugefügt 
Kopiert den git-Stand nach /var/www/html (config.php bleibt unangetastet),
prüft PHP-Syntax vorab und wendet ausstehende Migrationen aus migrations/
über eine schema_migrations-Tracking-Tabelle an. Tests werden ausgeführt,
sobald welche existieren.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-23 15:18:03 +02:00

1.9 KiB
Raw Blame History

Datenbank-Migrationen

Migrationen liegen hier als .sql-Dateien, benannt nach dem Schema:

0001_kurze_beschreibung.sql
0002_naechste_aenderung.sql

update.sh ruft migrations/run_migrations.php <pfad-zur-config.php> auf. Das Skript:

  • legt bei Bedarf die Tabelle schema_migrations an (Spalte filename als Primary Key), die protokolliert, welche Dateinamen bereits angewendet wurden
  • führt alle noch nicht angewendeten .sql-Dateien in Dateinamen-Reihenfolge aus
  • bricht beim ersten Fehler sofort ab (die fehlgeschlagene Datei wird NICHT als angewendet markiert, alle vorherigen bleiben es)

Regeln für neue Migrationen

  • Immer die nächste freie, vierstellige Nummer verwenden (0003_...). Eine bereits vergebene Nummer nie wiederverwenden, eine bereits angewendete Datei nachträglich nicht mehr ändern (neue Migration statt Änderung der alten).
  • So schreiben, dass sie keine Breaking Changes verursachen, z. B.:
    • CREATE TABLE IF NOT EXISTS ... statt CREATE TABLE ...
    • Neue Spalten nullable oder mit DEFAULT anlegen, statt bestehende NOT NULL-Constraints nachträglich zu erzwingen
    • Kein DROP TABLE / DROP COLUMN ohne vorherige Rücksprache
  • Migrationen möglichst idempotent halten (IF NOT EXISTS), damit ein erneuter Lauf nach einem Teilfehler nicht sofort wieder bricht.

Historie

init.sql (Ausgangsschema für Neuinstallationen) und update.sql (bereits manuell eingespieltes Aktien-Modul) liegen bewusst außerhalb dieses Verzeichnisses, da beide bereits auf allen bekannten Servern produktiv sind. Ab jetzt werden neue Schema-Änderungen ausschließlich als nummerierte Migration hier abgelegt.

Hinweis

run_migrations.php bindet die produktive config.php per require ein, um die bestehende $pdo-Verbindung wiederzuverwenden. Da config.php session_start() aufruft, legt der CLI-Lauf dabei eine kurzlebige, ungenutzte Session-Datei an — das ist unschädlich, aber erwähnenswert.