Scripte

PHP Script: MySQLDBExport-2.0.1.class.php

Nach obenNach unten

Zurück zur Übersicht - Datei downloaden

  1. <?php
  2.  
  3. //         **********************************************
  4. //         ***     MySQLDBExport.class.php v2.0.1     ***
  5. //         **********************************************
  6.  
  7. // -----------------------------------------------------------------------
  8. /*
  9.   Copyright:
  10.   ==============
  11.   Dieses Script wurde ursprünglich von Dennis Riehle geschrieben - Sie dürfen
  12.   das Script frei verwenden, bearbeiten und weitergeben, solange dieser Copyright
  13.   Hinweis nicht entfernt wird.
  14.   Es erfolgt keinerlei Haftung für eventuell durch dieses Script entstandene
  15.   Schäden - die Benutzung erfolgt vollständig auf eigene Gefahr.
  17.   Beschreibung:
  18.   ==============
  19.   Mit dieser Klasse lässt sich ein Dump (Export) einer MySQL Datenbank erzeugen,
  20.   was z.B. für ein Backupsystem verwendet werden kann.
  22.   Benutzung:
  23.   ==============
  24.   a) Bei einer bereits vorhandenen MySQL Verbindung:
  25.      
  26.         $export = new MySQLDBExport();    // Instanz erzeugen
  27.         $export->set_db("Datenbank");     // Datenbank auswählen
  28.         $dump   = $export->make_dump();   // Dump erstellen
  29.        
  30.   b) Wenn erst noch eine Verbindung hergestellt werden muss:
  31.  
  32.         $export = new MySQLDBExport("Host", "User", "Passwort");
  33.                                           // Instanz erzeugen und gleichzeitig
  34.                                           // eine MySQL-Verbindung erstellen
  35.         $export->set_db("Datenbank");     // Datenbank auswählen
  36.         $dump   = $export->make_dump();   // Dump erstellen
  37.        
  38.   Weitere Optionen:
  39.   -----------------
  40.   Standardmäßig wird innerhalb des Dumps ein Unix Zeilenumbruch verwendet, möchte
  41.   man dies ändern, so ist vor dem Aufrufen von make_dump() folgendes zu setzen:
  42.     $export->set_newline("\r\n");
  43.  
  44.   MySQLDBExport erzeugt normalerweise immer einen Dump für alle sich innerhalb einer
  45.   Datenbank befindlichen Tabellen, möchte man nur eine einzelne oder nur bestimmte
  46.   Tabellen exportieren, so lässt sich make_dump() ein String oder ein Array der
  47.   zu exportierenden Tabellen übergeben:
  48.     $export->make_dump("Tabellenname");
  49.   Oder:
  50.     $export->make_dump(array("Tabelle1", "Tabelle2"));
  51.    
  52.   Error Handling - beim Auftreten eines Fehlers liefern die Funktionen false
  53.   zurück und schreiben eine Nachricht in die error Variable, die sich wie folgt
  54.   abfragen lässt:
  55.     echo $export->get_error();
  57.   Changelog
  58.   ==============
  59.   Von Version 2.0 auf Version 2.0.1 wurden folgende Änderungen vorgenommen:
  60.   - Wie von dedlfix (<http://forum.de.selfhtml.org/?t=125488&m=809046#nachricht>)
  61.     angemerkt ist es nicht schön, dass Script per die() sterben zu lassen,
  62.     aus diesem Grund wurde die error Variable eingeführt, sowie die Funktion
  63.     get_error() zum Abfragen selbiger
  64.   - Rein theoretisch wäre es bei einer schlechten Programmierung mit dieser
  65.     Klasse möglich gewesen, über den Tabellennamen SQL Injections einfließen zu
  66.     lassen (s.a. <http://forum.de.selfhtml.org/?t=125488&m=809778#nachricht>),
  67.     die neue Version behebt diese Probleme durch escapen des Backticks in
  68.     Tabellennamen mit der Funktion escape_table_name()
  69.   - Mit set_newline() ist eine Möglichkeit hinzugekommen, wie sich $newline
  70.     im Sinne von OOP setzen lässt
  71.   - Die Funktion make_dump() hat noch zwei weitere optionale Parameter die an
  72.     export_table_structure() und export_table_data() durchgeschleust werden,
  73.     dadurch sind diese Werte nicht mehr hartkodiert.
  74.   - Code Cleaning, Kommentierung
  75. */
  76.  
  77. class MySQLDBExport {
  78.  
  79.   var $con     = false;
  80.   var $db      = "";
  81.   var $newline = "\n";
  82.   var $error   = "";
  83.  
  84.   // -----------------------------------------------------------------------
  85.   function MySQLDBExport($host = NULL, $user = NULL, $pass = NULL) {
  86.     // Initialisierung - sofern gewünscht, MySQL Verbindung aufbauen
  87.     if($host != NULL AND $user != NULL) {
  88.       // Verbindung herstellen
  89.       $con = @mysql_connect($host, $user, $pass);
  90.       // Wenn fehlgeschlagen, Error melden und abbrechen
  91.       if(!$con) {
  92.         $this->error = "Fehler beim Herstellen der MySQL Verbindung - " . mysql_error();
  93.         return false;
  94.       }
  95.       // Sonst die Verbindung in $con speichern
  96.       $this->con = $con;
  97.       return true;
  98.     }
  99.   }
  100.  
  101.   // -----------------------------------------------------------------------
  102.   function get_error() {
  103.     // Ausgabe der letzten Error-Meldung
  104.     return $this->error;
  105.   }
  106.  
  107.   // -----------------------------------------------------------------------
  108.   function set_newline($newline) {
  109.     // Setzen von $newline
  110.     $this->newline = $newline;
  111.     return true;
  112.   }
  113.  
  114.   // -----------------------------------------------------------------------
  115.   function set_db($db) {
  116.     // Wenn vorher bereits ein Fehler aufgetreten ist, abbrechen
  117.     if(!empty($this->error)) {
  118.       return false;
  119.     }
  120.     // Sonst versuchen, die MySQL Datenbank auszuwählen
  121.     $try = @mysql_select_db($db);
  122.     // Im Fehlerfall einen Error melden und abbrechen
  123.     if(!$try) {
  124.       $this->error = mysql_error();
  125.       return false;
  126.     }
  127.     // Sonst den Datenbanknamen abspeichern in $db
  128.     $this->db = $db;
  129.     return true;
  130.   }
  131.  
  132.   // -----------------------------------------------------------------------
  133.   function escape_table_name($table) {
  134.     // Escapen von Tabellen oder Datenbanknamen gemäß
  135.     // <http://dev.mysql.com/doc/refman/5.0/en/legal-names.html>
  136.     $table = str_replace("´", "´´", $table);
  137.     return $table;
  138.   }
  139.  
  140.   // -----------------------------------------------------------------------
  141.   function get_tables() {
  142.     // Liste über alle existierenden Tabellen in der Datenbank besorgen
  143.     $return = mysql_query('SHOW TABLES FROM `' . $this->escape_table_name($this->db) . '`;');
  144.     if(!$return) {
  145.       $this->error = mysql_error();
  146.       return false;
  147.     }
  148.     // Array für Liste initialisieren
  149.     $tables = array();
  150.     // MySQL Ergebnisliste durchgehen und jede Tabelle in $tables hinzufügen
  151.     while (list($current) = mysql_fetch_row($result)) {
  152.       $tables[] = $current;
  153.     }
  154.     // Und Tabellenarray zurückgeben
  155.     return $tables;
  156.   }
  157.  
  158.   // -----------------------------------------------------------------------
  159.   function export_table_structure($table, $drop_if_exists = true) {
  160.     // Ausgabestring initialisieren
  161.     $sqlstring = "";
  162.     // Wenn DROP TABLE mit ausgegeben werden soll, dieses in den
  163.     // Ausgabestring schreiben
  164.     if($drop_if_exists) {
  165.       $sqlstring .= "DROP TABLE IF EXISTS `" . $this->escape_table_name($table)
  166.                  .  "`;" . $this->newline;
  167.     }
  168.     // Die CREATE TABLE Syntax per SQL Befehl besorgen oder Fehler ausgeben
  169.     $return = mysql_query("SHOW CREATE TABLE `" . $this->escape_table_name($table) . "`");
  170.     if(!$return) {
  171.       $this->error = mysql_error();
  172.       return false;
  173.     }
  174.     // Auslesen, ...
  175.     $data = mysql_fetch_assoc($return);
  176.     // ...in Ausgabestring schreiben ...
  177.     $sqlstring .= str_replace("\n", $this->newline, $data['Create Table']) . ";"
  178.                .  $this->newline
  179.                .  $this->newline;
  180.     // ...und diesen zurück geben
  181.     return $sqlstring;
  182.   }
  183.  
  184.   // -----------------------------------------------------------------------
  185.   function export_table_data($table, $leave_out_fields = false) {
  186.     // Alle Felder aus der Tabelle auslesen, bei Fehler abbrechen
  187.     $sql = "SELECT * FROM `" . $this->escape_table_name($table) . "`";
  188.     $return = mysql_query($sql);
  189.     if(!$return) {
  190.       $this->error = mysql_error();
  191.       return false;
  192.     }
  193.     // Ausgabestring initialisieren
  194.     $sqlstring = "";
  195.     // Alle Ergebniszeilen abarbeiten...
  196.     while($data = mysql_fetch_assoc($return))
  197.     {
  198.       // Arrays zum Sammeln der Key und der Value Werte initialisieren
  199.       $keys = array();
  200.       $values = array();
  201.       foreach($data as $key => $value) {
  202.         // Wenn dieses Feld ausgelassen werden soll, fahre mit
  203.         // nächster Schleife fort
  204.         if(is_array($leave_out_fields) AND in_array($key, $leave_out_fields)) {
  205.           continue;
  206.         }
  207.         // Sonst füge den aktuellen Key in das "Keysammelarray" hinzu
  208.         $keys[] = "`" . $this->escape_table_name($key) . "`";
  209.         // Wenn das Value NULL ist, in den String NULL umwandeln
  210.         if($value === NULL) {
  211.           $value = "NULL";
  212.         }
  213.         // Wenn das Value leer oder False ist, ein "" als Value nehmen
  214.         elseif($value === "" OR $value === false) {
  215.           $value = '""';
  216.         }
  217.         // Wenn das Value nicht numerisch ist, es mit mysql_real_escape_string()
  218.         // escapen und zwischen " setzen
  219.         elseif(!is_numeric($value)) {
  220.           $value = mysql_real_escape_string($value);
  221.           $value = "\"$value\"";
  222.         }
  223.         // In allen anderen Fällen ist das Value numerisch, kann belassen
  224.         // werden wie es ist und direkt in das "Valuesammelarray" hinzugefügt
  225.         // werden
  226.         $values[] = $value;
  227.       }
  228.       // Aus den Sammelarrays jetzt einen INSERT INTO SQL-Befehl erstellen und diesen
  229.       // an die Ausgabe anhängen
  230.       $sqlstring .= "INSERT INTO `" . $this->escape_table_name($table) . "` ( "
  231.                  .  implode(", ",$keys)
  232.                  .    " ){$this->newline}\tVALUES ( "
  233.                  .  implode(", ",$values)
  234.                  .    " );" . $this->newline;
  235.     }
  236.     // Ausgabestring zurückliefern
  237.     return $sqlstring;
  238.   }
  239.  
  240.   // -----------------------------------------------------------------------
  241.   function make_dump($tables_input = NULL, $drop_if_exists = false, $leave_out_fields = false ) {
  242.     // Ausgabestring für den Datenbank Dump initialisieren mit einer ersten Kommentarzeile
  243.     $exportstring = "-- ------------------------------------------" . $this->newline;
  244.     // Array für alle zu exportierenden Tabellen initialisieren
  245.     // Jeder Wert in diesem Array wird später als Tabellennamen aufgefasst und es wird
  246.     // versucht einen MySQL DUMP dieser Tabelle zu erstellen
  247.     $tables = array();
  248.     // Wenn für $tables_input ein Array übergeben wurde die Kopfzeile für einen indivi-
  249.     // duellen Datenbankexport erzeugen und alle Einträge aus dem Array in das Tabellen-
  250.     // array kopieren, sodass nur die im Array übergebenen Tabellen exportiert werden
  251.     if(is_array($tables_input)) {
  252.       $tables = $tables_input;
  253.       $exportstring .= "-- INDIVIDUAL DATABASE EXPORT              --" . $this->newline;
  254.     }
  255.     // Ansonsten, wenn $tables_input ein einfacher String ist, diesen als eine Tabelle
  256.     // auffassen und nur diese eine Tabelle exportieren, als Single Database Export
  257.     elseif(!is_array($tables_input) AND $tables_input != NULL) {
  258.       $tables[0] = $tables_input;
  259.       $exportstring .= "-- SINGLE DATABASE EXPORT                  --" . $this->newline;
  260.     }
  261.     // Wurde der Parameter $tables_input gar nicht mit übergeben oder ist dieser False, so
  262.     // wird per $this->get_tables() herausgefunden welche Tabellen alle existieren und es werden
  263.     // alle Tabellen exportiert => Full Database Export
  264.     else {
  265.       $tables = $this->get_tables();
  266.       // Wenn get_tables() fehlschlägt, abbrechen
  267.       if($tables === false) return false;
  268.       $exportstring .= "-- FULL DATABASE EXPORT                    --".$this->newline;
  269.     }
  270.     // In den Ausgabestring die Kopfzeilen schreiben, welche den Namen der Datenbank in
  271.     // der die Tabellen liegen, das Datum zu dem der Dump erzeugt wurde sowie den Typ des
  272.     // Exports (s.o.) enthält
  273.     $exportstring .= "-- ------------------------------------------" . $this->newline
  274.                   .  "-- Database: " . $this->db.str_repeat(" ",30 - strlen($this->db)) . "--"
  275.                                                                      . $this->newline
  276.                   .  "-- Build: " . date("d.m.Y, H:i")."                --" . $this->newline
  277.                   .  "-- Script by Dennis Riehle                 --" . $this->newline
  278.                   .  "-- http://tutorial.riehle-web.com/scripts/ --" . $this->newline
  279.                   .  "-- ------------------------------------------" . $this->newline
  280.                                                                      . $this->newline;
  281.     // Gehe alle Tabellen in $tables durch und exportiere nacheinander von jeder Tabelle
  282.     // die Struktur, sowie die Daten.
  283.     foreach($tables as $table) {
  284.       $structure = $this->export_table_structure($table, $drop_if_exists)
  285.       $data      = $this->export_table_data($table, $leave_out_fields)
  286.       // Wenn export_table_structure() oder export_table_data() fehlschlägt, abbrechen
  287.       if($structure === false OR $data === false) return false;
  288.       $exportstring .= "-- Table: $table" . $this->newline
  289.                     .  "-- ------------------------------------------" . $this->newline
  290.                     .  $structure
  291.                     .  $data
  292.                     .  $this->newline;
  293.     }
  294.     // Füge dem Exportstring noch ein Ende Kennzeichen hinzu...
  295.     $exportstring .= "-- ------------------------------------------" . $this->newline
  296.                   .  "-- Export End                              --" . $this->newline
  297.                   .  "-- ------------------------------------------" . $this->newline;
  298.     // ...und liefere den kompletten String zurück.
  299.     return $exportstring;
  300.   }
  301. }
  302. // -----------------------------------------------------------------------
  303. /*
  304.     ENDE
  305. */
  306.  
  307. ?>
  308.  

Zurück zur Übersicht - Datei downloaden

Nach obenNach unten

Valid XHTML 1.0! Valid CSS!

Letzte Änderungen: Sonntag, der 03. Februar 2008
© 2005, Dennis Riehle.