Version vom 19. Juli 2011, 15:18 Uhr

Einige Entwickler werden wahrscheinlich das Problem haben, dass die Modultabellen zwar korrekt erzeugt werden, sich aber trotzdem nach der Installation immer noch in der Sektion "Update Database" wiederfinden. Meist liegt das an den implizierten Defaultwerten die von MySQL automatisch erzeugt werden.

Normalfall

Damit die Tabellen nicht mehr in dieser Sektion erscheinen, macht man einfach folgendes nachdem die Tabelle einmal korrekt angelegt worden ist:

1. SQL Mode überprüfen. (Wird bei den meisten nicht relevant sein) Contao arbeitet unter MySQL nicht im Strictmodus, welcher standardmäßig auch aus ist. Einfach im phpMyAdmin oder auf der Konsole eingeben und kontrollieren, dass der Wert leer ist:

   SHOW VARIABLES LIKE 'sql_mode';

   Wenn nicht leer gibt man folgendes ein:

   SET sql_mode = '';

2. Nun lässt man sich das create statement zurückgeben:

   SHOW CREATE TABLE tl_MODULE_TABLE_NAME;

   tl_MODULE_TABLE_NAME natürlich durch den eigenen Tabellen Namen ersetzen. Dieses Statement ist nun genau so in der database.sql zu verwenden.

Achtung: Es gibt Ausnahmen, siehe nächsten Abschnitt.

Spezialfall

Leider funktioniert das nicht ganz bei Feldern die NULL sein dürfen, Beispiel:

Achtung: Hier in der Wiki Anzeige wird durch das Syntax Highlighting fälschlicherweise das "default" groß geschrieben, dass muss klein geschrieben werden.

`price` DECIMAL(20,4) NULL ,
`price2` DOUBLE(255,0) NULL

MySQL gibt nach obigem Beispiel zurück:

`price` DECIMAL(20,4) DEFAULT NULL,
`price2` DOUBLE(255,0) DEFAULT NULL

Beides akzeptiert Contao aber nicht. Dafür die vollständige Variante:

`price` DECIMAL(20,4) NULL DEFAULT NULL,
`price2` DOUBLE(255,0) NULL DEFAULT NULL

Hier ist also etwas Nacharbeit nötig.
Andererseits auch einfach zu merken, immer den vollständigen Syntax nehmen:

NAME  TYP[(WIDTH, PRECISION, SCALE)]  [NOT] NULL  DEFAULT VALUE

Beispiel Statement und Hinweise dazu

Hier mal ein SQL CREATE Statement mit einigen meist gebrauchten Kombinationen:

    CREATE TABLE `tl_sqltest` (
      `id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
      `pid` INT(10) UNSIGNED NOT NULL DEFAULT '0',
      `sorting` INT(10) UNSIGNED NOT NULL DEFAULT '0',
      `tstamp` INT(10) UNSIGNED NOT NULL DEFAULT '0',
      `decimal_demo1` DECIMAL(20,4) NOT NULL DEFAULT '100.0000',
      `decimal_demo2` DECIMAL(20,0) NOT NULL DEFAULT '100',
      `float_demo` FLOAT(9,2) UNSIGNED NOT NULL DEFAULT '0.00',
      `varchar_demo1` VARCHAR(32) NOT NULL DEFAULT 'demo',
      `varchar_demo2` VARCHAR(64) NOT NULL DEFAULT '',
      `char_demo1` CHAR(1) NOT NULL DEFAULT 'A',
      `char_demo2` CHAR(1) NOT NULL DEFAULT '',
      `text_demo1` text NOT NULL,
      `int_null_demo` INT(10) NULL DEFAULT NULL,
      `decimal_null_demo` DECIMAL(20,4) NULL DEFAULT NULL,
      `float_null_demo` FLOAT(9,2) UNSIGNED NULL DEFAULT NULL,
      `varchar_null_demo` VARCHAR(32) NULL DEFAULT NULL,
      `char_null_demo` CHAR(1) NULL DEFAULT NULL,
      `text_null_demo` text NULL,
      `timestamp_demo` TIMESTAMP NULL DEFAULT NULL,
      `date_demo` DATE NOT NULL DEFAULT '1999-01-01',
      PRIMARY KEY  (`id`),
      UNIQUE KEY `varchar_demo1` (`varchar_demo1`),
      KEY `pid` (`pid`)
    ) ENGINE=MyISAM DEFAULT CHARSET=utf8;

• bei PRIMARY KEY müssen 2 Leerzeichen folgen bevor die runde Klammer folgt
• blob/text Felder (auch die Untertypen tinytext,...) dürfen laut MySQL keinen Default Wert haben, daher ist es hier richtig diesen wegzulassen.
• der Name des Unique Keys und des normalen Keys muss identisch sein mit dem Feldnamen der in Klammern steht.
• ein Key der über mehrere Felder angelegt werden könnte, wird von Contao nicht akzeptiert (funktioniert aber)
• Richtiges Präfix: Contao parst nur Tabellen, die mit dem Präfix "tl_" ausgestattet sind.

Hinweise für Sequel Pro (Mac) Nutzer

Folgende Hinweise stammen aus dem Forum und werden hier ohne Bewertung wiedergegeben (hab kein Mac):

Das SQL-Dump, das Sequel Pro (Mac) erzeugt hat, hatte zwei 'Fehler'.

• DEFAULT (Großbuchstaben) statt default (Kleinbuchstaben)
• AUTO_INCREMENT (Großbuchstaben) statt auto_increment (Kleinbuchstaben)
• nur 1 Leerzeichen nach PRIMARY KEY statt 2 Leerzeichen

Hier sind also Anpassungen nötig.

Problematik Groß-/Kleinschreibung der Tabellennamen

Erweiterungen die Tabellen mit Groß-/Kleinschreibung haben, wie z.B. "tl_coinSlider" bzw. "tl_coinPictures" können Probleme bereiten, besonders unter Windows (XAMPP).
Grund ist, die Tabellen werden in Kleinschreibung angelegt. Contao stellt dies fest und verlangt erneut ein Datenbank Update.
Lösbar ist das Problem durch einen Eintrag in der Datei my.ini:

[mysqld]
lower_case_table_names = 2

Anmerkung: Es sollte jedoch bei Tabellennamen immer ausschließlich mit Kleinbschreibung gearbeitet werden um solche Probleme zu vermeiden. Nicht jeder kann die my.ini editieren.

Der database.sql Generator

Nachdem man nun das Grundprinzip verstanden hat, ist man aber doch froh, wenn einem die Arbeit abgenommen wird.
Dazu dient das Modul: "database.sql Generator"

--BugBuster 15:21, 3. Sep. 2010 (CEST)