Quelltext der Seite BackupDB

Modul zur Sicherung der MySQL-Datenbank und zur Erstellung eines Website-Templates.
{{ExtInfo
| Dev=Hagen Klemp ([[User:do_while|do_while]])
| DevSite=http://www.softleister.de
| ExtVersion=1.3.0
| Version=ab 2.9.x
| TLVersion=2.6.0 - 2.8.x
| ERLink=http://www.contao.org/erweiterungsliste/view/BackupDB.de.html
}}
[[Kategorie:Extensions]]

=Forum=
Fragen zum BackupDB-Modul werden im Forum beantwortet: [http://www.contao-community.de/forumdisplay.php?25-backupDB Forum - BackupDB-Erweiterung]

=Installation=
Die Installation erfolgt normal über das Extension Repository im Backend der Contao Installation.<br />
Eine manuelle Installation ist möglich, dazu die ZIP Datei [http://www.contao.org/erweiterungsliste/view/BackupDB.html vom Extension Repository laden], entpacken und entsprechend übertragen. Bitte auch auf die richtige Übertragung der .htaccess-Dateien achten. Die .htaccess-Dateien in den einzelnen Verzeichnissen, werden zur Absicherung gegen direkten Zugriff aus dem Internet benötigt.


Das Installtool von Contao braucht nicht aufgerufen zu werden, da das Modul keine Datenbankveränderungen vornimmt oder eigene Tabellen anlegt.


=Backend-Modul "Backup Datenbank"=
Eine Datensicherung der MySQL-Datenbank ist wichtig, wenn ein Störfall aufgetreten ist. Mit der Datensicherung läßt sich die Datenbank komplett wieder neu erstellen. Eine '''Datei'''sicherung wird von BackupDB nicht ausgeführt, diese sollte man zusätzlich sichern, um für den Ernstfall gerüstet zu sein.

Es gibt ein paar Punkte, die beachtet werden müssen:
* BackupDB kann nicht Datenbanken jeder Größe sichern! Erfahrungswerte liegen bei max. 10-12 MByte, das ist aber stark von dem Aufbau der Website, der Serverperformance und der Datenbankanbindung abhängig. Wenn das Backup komplett fertig geworden ist, steht in der letzten Zeile der SQL-Datei "# --- End of Backup ---".
* Eine Datensicherung kann '''nicht''' für den Datentransport in ein anderes Contao- oder TYPOlight-Release (z.B. Update) verwendet werden!
* Ein Website-Template kann nur in einem gleichen System verwendet werden, d.h. gleiche Contao-Version und gleiche Erweiterungen mit gleichen Versionen. Grund ist, dass die Datenbankstruktur nicht im Website-Template gespeichert ist und so beim Import 100% übereinstimmen muss.

.
===Datenbank sichern===
[[Datei:BackupDB_Backup_starten.jpg|Backup starten]]

Um die komplette Datenbank zu sichern, klickt man im Backend einfach auf den Button "SQL-Backup starten". Daraufhin öffnet sich ein Downloadfenster, wo man das Zielverzeichnis auf dem lokalen System angibt.

.

===Website-Template erstellen===
[[Datei:BackupDB_Template_erstellen.jpg|Template erstellen]]

Das Website-Template kann genutzt werden, um über das Installtool eine fertige Umgebung einzurichten. Wichtig ist dabei, dass sowohl Contao, als auch die verwendeten Erweiterungen in den Versionen vorhanden sind, die beim Speichern des Website-Templates vorlagen.

Es werden dabei zwei Dateien erstellt:
# die Datenbankdatei *.sql
# eine Textdatei, in der die erwarteten Erweiterungen und Versionen stehen

Die Dateien werden normalerweise im /templates-Verzeichnis erstellt. Weiter [[#Anderen_Speicherort_für_Website-Templates_festlegen|unten]] ist erklärt, wie man auch ein anderes Zielverzeichnis einstellen kann.

'''Neu ab Version 1.3.0 stable:'''<br />
Bisher wurden im Export nur Contao-Tabellen, die mit tl_ beginnen berücksichtigt. Jetzt besteht die Möglichkeit, im Einstellungen-Menü eine Liste an Datentabellen anzugeben. Es können einzelne Tabellen hinzugefügt werden oder auch nur die Prefixe, wie z.B. cat_ für Catalog-Tabellen.<br />
In diesem Fall gibt man '''tl_,cat_''' an.

Das Website-Template wird normalerweise im Verzeichnis templates gespeichert, ab jetzt kann der Speicherort auch verändert werden, z.B. '''tl_files/templatefile'''
[[Datei:Backupdb130.jpg]]

.

===Automatisches Backup===
Für ein automatisch ausgeführtes Backup wird zusätzlich die Erweiterung [http://www.contao.org/erweiterungsliste/view/cron.de.html cron] benötigt. Wenn die Erweiterung installiert ist, bietet BackupDB an, dort einen cronjob anzulegen.
[[Datei:BackupDB_Cron_eintragen.jpg|Cron eintragen]]

Nach einem Klick auf diesen Link ist der Cronjob vorgemerkt, aber noch inaktiv, um dem Anwender die Möglichkeit zu geben, die Einstellungen und Zyklen nach Bedarf einzustellen:
[[Datei:BackupDB_Cron_inaktiv.jpg|Cron inaktiv]]

Im Menü des Schedulers (cron) kann das AutoBackup aktiviert werden, indem man einfach auf den rote-LED-Icon klickt (wird dann grün)
[[Datei:BackupDB_Cron_menu.jpg|Cron Menü]]

Im BackupDB-Menü sieht man dann die Anmerkung, dass der Cronjob aktiv ist.

[[Datei:BackupDB_Cron_aktiv.jpg|Cron aktiv]]


'''Anmerkung:'''

Der Cron der cron-Erweiterung ist nicht automatisch ein echter Cron. Er wird nur über Aufrufe im Backend gesteuert. Wenn nur selten jemand im Backend arbeitet, kann es sein, dass der Cron auch lange nicht ausgeführt wird. Abhilfe:
* man kann ein kleines Script in das Seitenlayout einbauen, um auch Trigger aus Frontendaufrufen zu erhalten
* man kann den CronController mittels echtem Cronjob vom Server aufrufen lassen.
Weitere Infos dazu unter [http://contifex.com/wiki/extensions/cron www.contifex.com]


.

=Experteneinstellungen=

===Anzahl der AutoBackup-Dateien einstellen===
Das Autobackup per cron-Erweiterung verwendet normalerweise 3 Backupdateien, die sich in dem Verzeichnis TL_FILES/AutoBackupDB befinden. Das neueste Backup ist immer in '''AutoBackupDB-1.sql''' gespeichert und in '''-2''' und '''-3''' sind die älteren Backups vorhanden.

Wenn einem die letzten 3 Backups nicht ausreichen, läßt sich durch einen Eintrag in der localconfig.php die Anzahl erhöhen, im Beispiel auf 5:
<source lang="php">
$GLOBALS['BACKUPDB']['AutoBackupCount'] = 5;
</source>

.

===Anderen Speicherort für Website-Templates festlegen===
Das Website-Template wird normalerweise im Verzeichnis /templates gespeichert, da es auch in diesem Verzeichnis vom Installtool gesucht wird.

Wenn man, aus welchen Gründen auch immer, ein anderes Verzeichnis verwenden möchte, kann das in der localconfig.php eingestellt werden. Das Verzeichnis sollte aber bereits vorhanden sein.
<source lang="php">
$GLOBALS['BACKUPDB']['WsTemplatePath'] = 'tl_files/myTemplateBackups';
</source>

.