BugBuster: /* Trigger aktualisieren */

2012-02-25T20:33:27Z

‎Trigger aktualisieren

Tril: /* Trigger aktualisieren */

2012-02-25T10:33:54Z

‎Trigger aktualisieren

Tril: Die Seite wurde neu angelegt: „Das Multi Trigger Framework erlaubt einem Entwickler, mehrere Trigger auf einfache Art und Weise zu definieren. Kategorie:Extensions {{ExtInfo | Dev=Tristan L…“

2012-02-25T10:20:09Z

Die Seite wurde neu angelegt: „Das Multi Trigger Framework erlaubt einem Entwickler, mehrere Trigger auf einfache Art und Weise zu definieren. Kategorie:Extensions {{ExtInfo | Dev=Tristan L…“

Neue Seite

Das Multi Trigger Framework erlaubt einem Entwickler, mehrere Trigger auf einfache Art und Weise zu definieren.
[[Kategorie:Extensions]]
{{ExtInfo
| Dev=Tristan Lins
| ExtVersion=1.0.0
| Version=2.11+
| ERLink=http://www.contao.org/erweiterungsliste/view/MySQLMultiTriggerFramework.de.html
| TrackerLink=https://github.com/InfinitySoft/contao-mysqlmultitriggerframework/issues
| Depending=MySQL 5+
}}

=Multi Trigger Framework=

MySQL 5+ unterstützt [http://dev.mysql.com/doc/refman/5.1/de/triggers.html Trigger], leider wird pro Time/Event nur ein einziger Trigger unterstützt. Das Multi Trigger Framework gestattet es Extension-Entwicklern, Trigger zu definieren, ohne sich um diesen Umstand Gedanken machen zu müssen. Das Framework löscht automatisch nicht mehr benötigte Trigger und legt neue an.

==Trigger definieren==

Trigger werden in der <code>config.php</code> einer Erweiterung, in der globalen Variable <code>$GLOBALS['TL_TRIGGER']</code> definiert.
Die Variable ist folgendermaßen aufgebaut:

<source lang="php">
$GLOBALS['TL_TRIGGER']['<table>']['<time>']['<event>'] = array('<sql>');
</source>

'''<table>''' definiert die Tabelle, auf der der Trigger angelegt wird.<br>
'''<time>''' definiert den Zeitpunkt, wann der Trigger ausgeführt wird: '''before''' oder '''after'''.<br>
'''<event>''' definiert das Event, zu dem der Trigger ausgeführt wird: '''insert''', '''update''' oder '''delete'''.

===Beispiel===

<source lang="php">
/**
* Multi Triggers
*/
$GLOBALS['TL_TRIGGER']['tl_avisota_recipient']['after']['insert'][] = 'CALL avisota_recipient_list(NEW.id, NEW.lists);';
$GLOBALS['TL_TRIGGER']['tl_avisota_recipient']['after']['update'][] = 'CALL avisota_recipient_list(NEW.id, NEW.lists);';
$GLOBALS['TL_TRIGGER']['tl_avisota_recipient']['before']['delete'][] = 'DELETE FROM tl_avisota_recipient_list WHERE recipient=OLD.id;';
$GLOBALS['TL_TRIGGER']['tl_member']['after']['insert'][] = 'CALL avisota_member_list(NEW.id, NEW.avisota_lists);';
$GLOBALS['TL_TRIGGER']['tl_member']['after']['update'][] = 'CALL avisota_member_list(NEW.id, NEW.avisota_lists);';
$GLOBALS['TL_TRIGGER']['tl_member']['before']['delete'][] = 'DELETE FROM tl_avisota_member_list WHERE member=OLD.id;';
$GLOBALS['TL_TRIGGER']['tl_avisota_mailing_list']['before']['delete'][] = 'DELETE FROM tl_avisota_recipient_list WHERE list=OLD.id;
DELETE FROM tl_avisota_member_list WHERE list=OLD.id;';
</source>

==Trigger aktualisieren==

Die Trigger werden über das Install Tool bzw. die Datenbankaktualisierung aktualisiert.

[[Datei:trigger_create.png|Trigger anlegen|frame|center]]

Werden weitere Erweiterungen installiert, die ebenfalls Trigger verwenden, werden die alten Trigger gelöscht und neue angelegt.

[[Datei:trigger_drop.png|Trigger aktualisieren|frame|center]]

Werten alle Erweiterungen gelöscht, die Trigger verwenden, werden die Trigger gelöscht.

[[Datei:trigger_drop.png|Trigger löschen|frame|center]]

==Trigger Namenskonvention==

Die Trigger sind nach folgendem Schema benannt: <code>CMT_<table>_<time><event>_<hash></code><br>
'''CMT''' steht für ''Contao Multi Trigger''.<br>
'''<table>''' definiert die Tabelle, auf der der Trigger angelegt wird.<br>
'''<time>''' definiert den Zeitpunkt (nur das erste Zeichen), wann der Trigger ausgeführt wird: '''B''' für '''before''' oder '''A''' für '''after'''.<br>
'''<event>''' definiert das Event (nur das erste Zeichen), zu dem der Trigger ausgeführt wird: '''I''' für '''insert''', '''U''' für '''update''' oder '''D''' für '''delete'''.

Ein Trigger heißt dann bspw. <code>CMT_tl_avisota_mailing_list_BD_1ded90261a1101e0</code>

==Hooks==

Das Framework liefert 2 Hooks, mit denen auf Trigger Veränderungen reagiert werden kann.

===mysqlMultiTriggerDrop===

Wird ausgeführt, wenn ein Trigger gelöscht wird. (Der DROP Befehl befindet sich bereits in <code>$return['ALTER_ADD']</code>!)

<source lang="php">
$GLOBALS['TL_HOOKS']['mysqlMultiTriggerDrop'][] = array('MyClass', hookMysqlMultiTriggerDrop);

class MyClass
{
public function hookMysqlMultiTriggerDrop($strTriggerName, $return)
{
// do somethink
return $return;
}
}
</source>

===mysqlMultiTriggerCreate===

Wird ausgeführt, wenn ein Trigger erstellt wird. (Der CREATE Befehl befindet sich bereits in <code>$return['ALTER_ADD']</code>!)

<source lang="php">
$GLOBALS['TL_HOOKS']['mysqlMultiTriggerCreate'][] = array('MyClass', hookMysqlMultiTriggerCreate);

class MyClass
{
public function hookMysqlMultiTriggerCreate($strTriggerName, $objTrigger, $return)
{
// do somethink
return $return;
}
}
</source>

@@ Zeile 53: / Zeile 53: @@
 [[Datei:trigger_update.png|Trigger aktualisieren|frame|center]]
-Werten alle Erweiterungen gelöscht, die Trigger verwenden, werden die Trigger gelöscht.
+Werden alle Erweiterungen gelöscht, die Trigger verwenden, werden die Trigger gelöscht.
 [[Datei:trigger_drop.png|Trigger löschen|frame|center]]

@@ Zeile 51: / Zeile 51: @@
 Werden weitere Erweiterungen installiert, die ebenfalls Trigger verwenden, werden die alten Trigger gelöscht und neue angelegt.
-[[Datei:trigger_drop.png|Trigger aktualisieren|frame|center]]
+[[Datei:trigger_update.png|Trigger aktualisieren|frame|center]]
 Werten alle Erweiterungen gelöscht, die Trigger verwenden, werden die Trigger gelöscht.

MultiTriggerFramework - Versionsgeschichte

BugBuster: /* Trigger aktualisieren */

Tril: /* Trigger aktualisieren */

Tril: Die Seite wurde neu angelegt: „Das Multi Trigger Framework erlaubt einem Entwickler, mehrere Trigger auf einfache Art und Weise zu definieren. Kategorie:Extensions {{ExtInfo | Dev=Tristan L…“