PHP Script: MySQLDBExport-2.0.2.class.php

<?php
// **********************************************
// *** MySQLDBExport.class.php v2.0.1 ***
// **********************************************
// -----------------------------------------------------------------------
/*
Copyright:
==============
Dieses Script wurde ursprünglich von Dennis Riehle geschrieben - Sie dürfen
das Script frei verwenden, bearbeiten und weitergeben, solange dieser Copyright
Hinweis nicht entfernt wird.
Es erfolgt keinerlei Haftung für eventuell durch dieses Script entstandene
Schäden - die Benutzung erfolgt vollständig auf eigene Gefahr.
Beschreibung:
==============
Mit dieser Klasse lässt sich ein Dump (Export) einer MySQL Datenbank erzeugen,
was z.B. für ein Backupsystem verwendet werden kann.
Benutzung:
==============
a) Bei einer bereits vorhandenen MySQL Verbindung:
$export = new MySQLDBExport(); // Instanz erzeugen
$export->set_db("Datenbank"); // Datenbank auswählen
$dump = $export->make_dump(); // Dump erstellen
b) Wenn erst noch eine Verbindung hergestellt werden muss:
$export = new MySQLDBExport("Host", "User", "Passwort");
// Instanz erzeugen und gleichzeitig
// eine MySQL-Verbindung erstellen
$export->set_db("Datenbank"); // Datenbank auswählen
$dump = $export->make_dump(); // Dump erstellen
Weitere Optionen:
-----------------
Standardmäßig wird innerhalb des Dumps ein Unix Zeilenumbruch verwendet, möchte
man dies ändern, so ist vor dem Aufrufen von make_dump() folgendes zu setzen:
$export->set_newline("\r\n");
MySQLDBExport erzeugt normalerweise immer einen Dump für alle sich innerhalb einer
Datenbank befindlichen Tabellen, möchte man nur eine einzelne oder nur bestimmte
Tabellen exportieren, so lässt sich make_dump() ein String oder ein Array der
zu exportierenden Tabellen übergeben:
$export->make_dump("Tabellenname");
Oder:
$export->make_dump(array("Tabelle1", "Tabelle2"));
Error Handling - beim Auftreten eines Fehlers liefern die Funktionen false
zurück und schreiben eine Nachricht in die error Variable, die sich wie folgt
abfragen lässt:
echo $export->get_error();
Changelog
==============
Von Version 2.0.1 auf Version 2.0.2 wurden folgende Änderungen vorgenommen:
- in Zeile 272 und 273 (bzw. 284 und 285 in Version 2.0.1) fehlte ein abschließendes
Semikolon (Syntaxfehler)
- in get_tables() trat eine Verwechslung von Variablen auf
*/
class MySQLDBExport {
var $con = false;
var $db = "";
var $newline = "\n";
var $error = "";
// -----------------------------------------------------------------------
function MySQLDBExport($host = NULL, $user = NULL, $pass = NULL) {
// Initialisierung - sofern gewünscht, MySQL Verbindung aufbauen
if($host != NULL AND $user != NULL) {
// Verbindung herstellen
$con = @mysql_connect($host, $user, $pass);
// Wenn fehlgeschlagen, Error melden und abbrechen
if(!$con) {
$this->error = "Fehler beim Herstellen der MySQL Verbindung - " . mysql_error();
return false;
}
// Sonst die Verbindung in $con speichern
$this->con = $con;
return true;
}
}
// -----------------------------------------------------------------------
function get_error() {
// Ausgabe der letzten Error-Meldung
return $this->error;
}
// -----------------------------------------------------------------------
function set_newline($newline) {
// Setzen von $newline
$this->newline = $newline;
return true;
}
// -----------------------------------------------------------------------
function set_db($db) {
// Wenn vorher bereits ein Fehler aufgetreten ist, abbrechen
if(!empty($this->error)) {
return false;
}
// Sonst versuchen, die MySQL Datenbank auszuwählen
$try = @mysql_select_db($db);
// Im Fehlerfall einen Error melden und abbrechen
if(!$try) {
$this->error = mysql_error();
return false;
}
// Sonst den Datenbanknamen abspeichern in $db
$this->db = $db;
return true;
}
// -----------------------------------------------------------------------
function escape_table_name($table) {
// Escapen von Tabellen oder Datenbanknamen gemäß
// <http://dev.mysql.com/doc/refman/5.0/en/legal-names.html>
$table = str_replace("´", "´´", $table);
return $table;
}
// -----------------------------------------------------------------------
function get_tables() {
// Liste über alle existierenden Tabellen in der Datenbank besorgen
$result = mysql_query('SHOW TABLES FROM `' . $this->escape_table_name($this->db) . '`;');
if(!$result) {
$this->error = mysql_error();
return false;
}
// Array für Liste initialisieren
$tables = array();
// MySQL Ergebnisliste durchgehen und jede Tabelle in $tables hinzufügen
while (list($current) = mysql_fetch_row($result)) {
$tables[] = $current;
}
// Und Tabellenarray zurückgeben
return $tables;
}
// -----------------------------------------------------------------------
function export_table_structure($table, $drop_if_exists = true) {
// Ausgabestring initialisieren
$sqlstring = "";
// Wenn DROP TABLE mit ausgegeben werden soll, dieses in den
// Ausgabestring schreiben
if($drop_if_exists) {
$sqlstring .= "DROP TABLE IF EXISTS `" . $this->escape_table_name($table)
. "`;" . $this->newline;
}
// Die CREATE TABLE Syntax per SQL Befehl besorgen oder Fehler ausgeben
$return = mysql_query("SHOW CREATE TABLE `" . $this->escape_table_name($table) . "`");
if(!$return) {
$this->error = mysql_error();
return false;
}
// Auslesen, ...
$data = mysql_fetch_assoc($return);
// ...in Ausgabestring schreiben ...
$sqlstring .= str_replace("\n", $this->newline, $data['Create Table']) . ";"
. $this->newline
. $this->newline;
// ...und diesen zurück geben
return $sqlstring;
}
// -----------------------------------------------------------------------
function export_table_data($table, $leave_out_fields = false) {
// Alle Felder aus der Tabelle auslesen, bei Fehler abbrechen
$sql = "SELECT * FROM `" . $this->escape_table_name($table) . "`";
$return = mysql_query($sql);
if(!$return) {
$this->error = mysql_error();
return false;
}
// Ausgabestring initialisieren
$sqlstring = "";
// Alle Ergebniszeilen abarbeiten...
while($data = mysql_fetch_assoc($return))
{
// Arrays zum Sammeln der Key und der Value Werte initialisieren
$keys = array();
$values = array();
foreach($data as $key => $value) {
// Wenn dieses Feld ausgelassen werden soll, fahre mit
// nächster Schleife fort
if(is_array($leave_out_fields) AND in_array($key, $leave_out_fields)) {
continue;
}
// Sonst füge den aktuellen Key in das "Keysammelarray" hinzu
$keys[] = "`" . $this->escape_table_name($key) . "`";
// Wenn das Value NULL ist, in den String NULL umwandeln
if($value === NULL) {
$value = "NULL";
}
// Wenn das Value leer oder False ist, ein "" als Value nehmen
elseif($value === "" OR $value === false) {
$value = '""';
}
// Wenn das Value nicht numerisch ist, es mit mysql_real_escape_string()
// escapen und zwischen " setzen
elseif(!is_numeric($value)) {
$value = mysql_real_escape_string($value);
$value = "\"$value\"";
}
// In allen anderen Fällen ist das Value numerisch, kann belassen
// werden wie es ist und direkt in das "Valuesammelarray" hinzugefügt
// werden
$values[] = $value;
}
// Aus den Sammelarrays jetzt einen INSERT INTO SQL-Befehl erstellen und diesen
// an die Ausgabe anhängen
$sqlstring .= "INSERT INTO `" . $this->escape_table_name($table) . "` ( "
. implode(", ",$keys)
. " ){$this->newline}\tVALUES ( "
. implode(", ",$values)
. " );" . $this->newline;
}
// Ausgabestring zurückliefern
return $sqlstring;
}
// -----------------------------------------------------------------------
function make_dump($tables_input = NULL, $drop_if_exists = false, $leave_out_fields = false ) {
// Ausgabestring für den Datenbank Dump initialisieren mit einer ersten Kommentarzeile
$exportstring = "-- ------------------------------------------" . $this->newline;
// Array für alle zu exportierenden Tabellen initialisieren
// Jeder Wert in diesem Array wird später als Tabellennamen aufgefasst und es wird
// versucht einen MySQL DUMP dieser Tabelle zu erstellen
$tables = array();
// Wenn für $tables_input ein Array übergeben wurde die Kopfzeile für einen indivi-
// duellen Datenbankexport erzeugen und alle Einträge aus dem Array in das Tabellen-
// array kopieren, sodass nur die im Array übergebenen Tabellen exportiert werden
if(is_array($tables_input)) {
$tables = $tables_input;
$exportstring .= "-- INDIVIDUAL DATABASE EXPORT --" . $this->newline;
}
// Ansonsten, wenn $tables_input ein einfacher String ist, diesen als eine Tabelle
// auffassen und nur diese eine Tabelle exportieren, als Single Database Export
elseif(!is_array($tables_input) AND $tables_input != NULL) {
$tables[0] = $tables_input;
$exportstring .= "-- SINGLE DATABASE EXPORT --" . $this->newline;
}
// Wurde der Parameter $tables_input gar nicht mit übergeben oder ist dieser False, so
// wird per $this->get_tables() herausgefunden welche Tabellen alle existieren und es werden
// alle Tabellen exportiert => Full Database Export
else {
$tables = $this->get_tables();
// Wenn get_tables() fehlschlägt, abbrechen
if($tables === false) return false;
$exportstring .= "-- FULL DATABASE EXPORT --".$this->newline;
}
// In den Ausgabestring die Kopfzeilen schreiben, welche den Namen der Datenbank in
// der die Tabellen liegen, das Datum zu dem der Dump erzeugt wurde sowie den Typ des
// Exports (s.o.) enthält
$exportstring .= "-- ------------------------------------------" . $this->newline
. "-- Database: " . $this->db.str_repeat(" ",30 - strlen($this->db)) . "--"
. $this->newline
. "-- Build: " . date("d.m.Y, H:i")." --" . $this->newline
. "-- Script by Dennis Riehle --" . $this->newline
. "-- http://tutorial.riehle-web.com/scripts/ --" . $this->newline
. "-- ------------------------------------------" . $this->newline
. $this->newline;
// Gehe alle Tabellen in $tables durch und exportiere nacheinander von jeder Tabelle
// die Struktur, sowie die Daten.
foreach($tables as $table) {
$structure = $this->export_table_structure($table, $drop_if_exists);
$data = $this->export_table_data($table, $leave_out_fields);
// Wenn export_table_structure() oder export_table_data() fehlschlägt, abbrechen
if($structure === false OR $data === false) return false;
$exportstring .= "-- Table: $table" . $this->newline
. "-- ------------------------------------------" . $this->newline
. $structure
. $data
. $this->newline;
}
// Füge dem Exportstring noch ein Ende Kennzeichen hinzu...
$exportstring .= "-- ------------------------------------------" . $this->newline
. "-- Export End --" . $this->newline
. "-- ------------------------------------------" . $this->newline;
// ...und liefere den kompletten String zurück.
return $exportstring;
}
}
// -----------------------------------------------------------------------
/*
ENDE
*/
?>

Scripte

PHP Script: MySQLDBExport-2.0.2.class.php