QFQ

Recherchiert welche Tools es gibt, um automatisiert MySQL Schema Update Scripts erstellen zu lassen: kein Open Source gefunden.

Aber das ist vermutlich auch gar nicht so wichtig:

• Das Tool muesste manuell aufgerufen werden - theoretisch koennte es bei 'git commit' oder 'git tag' getriggert werden, aber ich denke es kommt nicht haeufig genug vor als das sich der Aufwand fuer die Implentierung lohnt. Evtl. kann mit dem folgenden Ansatz auch erstmal Praxiserfahrung gesammelt werden um dann genauer zu sagen was noetig ist.
• Es gibt Schema Updates aber nicht so viele.
• Manchmal sind die Updates mit weiterer Logik verbunden (Bsp: der Default einer neuen Spalte soll in Zukunft anders sein als die aktuellen Werte enthalten - 2 SQL Statements sind noetig)
• Beim programmieren koennte die SQL Anweisung direkt im Update Skript eingebaut werden.

Notes¶

• Interaktives PHP Tool: https://dbv.vizuina.com
• https://www.infoq.com/articles/db-versioning-scripts
• http://enterprisecraftsmanship.com/2015/08/10/database-versioning-best-practices/
• Post von 2010 zum Thema mit den Tools: https://www.quora.com/What-are-the-alternatives-to-LiquiBase

Konzeptidee¶

• Es gibt eine PHP Datei mit einem statisch konifugriertem Array fuer alle Updates. $update[<tablename>][<version>]
• In jeder Tabelle steht im 'Comment' die aktuelle Version (numerischer Wert, fortlaufend).
• Check beim Start von QFQ ob ein Update noetig ist:
  • In `config.qfq.ini` steht eine Versionsnummer. Ist die unterschiedlich zu `ext_emconf.php`, wird der Update Process getriggert.
  • Das Update-array wird gelesen.
  • Von jeder MySQL Tabelle wird die Versionsnummer gelesen.
  • Pro Tabelle wird jeder Update durchgefuehrt. Anschliessend wird die neue Versionsnummer im Tabellen 'comment'-Feld eingetragen.
• Wenn alles gut durchgelaufen ist wird die neue Versionsnummer in config.qfq.ini eingetragen.
• Achtung: nur ein PHP Prozess darf den Update aufeinmal ausfuehren. Entsprechendes Locking einbauen.

Final implementation:

• Read the extension version number.
• Read the QFQ database version number: stored in the comment field of table 'Form'. Format: Version=x.y.z
• If versions different:
  • Read the update array 'DatabaseUpdateData.php'.
  • Play all changes after 'old' upto 'new'.
  • Save new QFQ database version in the comment field of table 'Form'
• In a new QFQ installation, the comment field of table 'Form' is empty. On the first call of QFQ, the version string
  will be set. Also the 'formEditor.sql' will be played initially.