Scripte

PHP Script: MySQLDBExport-2.0.class.php

Nach obenNach unten

Zurück zur Übersicht - Datei downloaden

  1. <?php
  2.  
  3. //         **********************************************
  4. //         ***      MySQLDBExport.class.php v2.0      ***
  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->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"));
  52.   Changelog
  53.   ==============
  54.   Von Version 1.0 auf Version 2.0 wurden folgende Änderungen vorgenommen:
  55.   - Das Script wurde zu einer Klasse umgeschrieben (vielen Dank dafür an
  56.     Jeena Paradies <http://jeenaparadies.net>), deshalb ist Version 2.0 auch nicht
  57.     zu Version 1.0 kompatibel!!
  58.   - Tabellen und Spaltennamen werden nun in Backticks ausgegeben, somit werden
  59.     auch Tabellen mit Leerzeichen im Namen unterstützt
  60.   - Code Cleaning
  61. */
  62.  
  63. class MySQLDBExport {
  64.  
  65.   var $con     = false;
  66.   var $db      = "";
  67.   var $newline = "\n";
  68.  
  69.   // -----------------------------------------------------------------------
  70.   function MySQLDBExport($host = NULL, $user = NULL, $pass = NULL) {
  71.     if($host != NULL AND $user != NULL) {
  72.       $con = mysql_connect($host, $user, $pass) OR die("Fehler beim Erstellen der Verbdingung: "
  73.            . mysql_error());
  74.       $this->con = $con;
  75.     }
  76.   }
  77.  
  78.   // -----------------------------------------------------------------------
  79.   function set_db($db) {
  80.     mysql_select_db($db) OR die("Fehler beim Auswählen der Datenbank: " . mysql_error());
  81.     $this->db = $db;
  82.   }
  83.  
  84.   // -----------------------------------------------------------------------
  85.   function get_tables() {
  86.     // Liste über alle existierenden Tabellen in der Datenbank besorgen
  87.     $result = mysql_query('SHOW TABLES FROM `' . $this->db . '`;') OR die(mysql_error());
  88.     // Array für Liste initialisieren
  89.     $tables = array();
  90.     // MySQL Ergebnisliste durchgehen und jede Tabelle in $tables hinzufügen
  91.     while (list($current) = mysql_fetch_row($result)) {
  92.       $tables[] = $current;
  93.     }
  94.     // Und Tabellenarray zurückgeben
  95.     return $tables;
  96.   }
  97.  
  98.   // -----------------------------------------------------------------------
  99.   function export_table_structure($table, $drop_if_exists = true) {
  100.     // Ausgabestring initialisieren
  101.     $sqlstring = "";
  102.     // Wenn DROP TABLE mit ausgegeben werden soll, dieses in den
  103.     // Ausgabestring schreiben
  104.     if($drop_if_exists)
  105.     {
  106.       $sqlstring .= "DROP TABLE IF EXISTS `$table`;" . $this->newline;
  107.     }
  108.     // Die CREATE TABLE Syntax per SQL Befehl besorgen oder Fehler ausgeben
  109.     $return = mysql_query("SHOW CREATE TABLE `$table`") OR
  110.                 die("Fehler beim Exportieren der Tabellenstruktur von $table: "
  111.                     . mysql_error()
  112.                    );
  113.     // Auslesen, ...
  114.     $data = mysql_fetch_assoc($return);
  115.     // ...in Ausgabestring schreiben ...
  116.     $sqlstring .= str_replace("\n", $this->newline, $data['Create Table']) . ";"
  117.                .  $this->newline
  118.                .  $this->newline;
  119.     // ...und diesen zurück geben
  120.     return $sqlstring;
  121.   }
  122.  
  123.   // -----------------------------------------------------------------------
  124.   function export_table_data($table, $leave_out_fields = false) {
  125.     // Alle Felder aus der Tabelle auslesen, bei Fehler abbrechen
  126.     $sql = "SELECT * FROM `" . $table . "`";
  127.     $return = mysql_query($sql) OR die(mysql_error());
  128.     // Ausgabestring initialisieren
  129.     $sqlstring = "";
  130.     // Alle Ergebniszeilen abarbeiten...
  131.     while($data = mysql_fetch_assoc($return))
  132.     {
  133.       // Arrays zum Sammeln der Key und der Value Werte initialisieren
  134.       $keys = array();
  135.       $values = array();
  136.       foreach($data as $key => $value) {
  137.         // Wenn dieses Feld ausgelassen werden soll, fahre mit
  138.         // nächster Schleife fort
  139.         if(is_array($leave_out_fields) AND in_array($key, $leave_out_fields)) {
  140.           continue;
  141.         }
  142.         // Sonst füge den aktuellen Key in das "Keysammelarray" hinzu
  143.         $keys[] = "`" . $key . "`";
  144.         // Wenn das Value NULL ist, in den String NULL umwandeln
  145.         if($value === NULL) {
  146.           $value = "NULL";
  147.         }
  148.         // Wenn das Value leer oder False ist, ein "" als Value nehmen
  149.         elseif($value === "" OR $value === false) {
  150.           $value = '""';
  151.         }
  152.         // Wenn das Value nicht numerisch ist, es mit mysql_real_escape_string()
  153.         // escapen und zwischen " setzen
  154.         elseif(!is_numeric($value)) {
  155.           $value = mysql_real_escape_string($value);
  156.           $value = "\"$value\"";
  157.         }
  158.         // In allen anderen Fällen ist das Value numerisch, kann belassen
  159.         // werden wie es ist und direkt in das "Valuesammelarray" hinzugefügt
  160.         // werden
  161.         $values[] = $value;
  162.       }
  163.       // Aus den Sammelarrays jetzt einen INSERT INTO SQL-Befehl erstellen und diesen
  164.       // an die Ausgabe anhängen
  165.       $sqlstring .= "INSERT INTO `$table` ( "
  166.                  .  implode(", ",$keys)
  167.                  .    " ){$this->newline}\tVALUES ( "
  168.                  .  implode(", ",$values)
  169.                  .    " );" . $this->newline;
  170.     }
  171.     // Ausgabestring zurückliefern
  172.     return $sqlstring;
  173.   }
  174.  
  175.   // -----------------------------------------------------------------------
  176.   function make_dump($tables_input = NULL)
  177.   {
  178.     // Ausgabestring für den Datenbank Dump initialisieren mit einer ersten Kommentarzeile
  179.     $exportstring = "-- ------------------------------------------" . $this->newline;
  180.     // Array für alle zu exportierenden Tabellen initialisieren
  181.     // Jeder Wert in diesem Array wird später als Tabellennamen aufgefasst und es wird
  182.     // versucht einen MySQL DUMP dieser Tabelle zu erstellen
  183.     $tables = array();
  184.     // Wenn für $tables_input ein Array übergeben wurde die Kopfzeile für einen indivi-
  185.     // duellen Datenbankexport erzeugen und alle Einträge aus dem Array in das Tabellen-
  186.     // array kopieren, sodass nur die im Array übergebenen Tabellen exportiert werden
  187.     if(is_array($tables_input))
  188.     {
  189.       $tables = $tables_input;
  190.       $exportstring .= "-- INDIVIDUAL DATABASE EXPORT              --" . $this->newline;
  191.     }
  192.     // Ansonsten, wenn $tables_input ein einfacher String ist, diesen als eine Tabelle
  193.     // auffassen und nur diese eine Tabelle exportieren, als Single Database Export
  194.     elseif(!is_array($tables_input) AND $tables_input != NULL)
  195.     {
  196.       $tables[0] = $tables_input;
  197.       $exportstring .= "-- SINGLE DATABASE EXPORT                  --" . $this->newline;
  198.     }
  199.     // Wurde der Parameter $tables_input gar nicht mit übergeben oder ist dieser False, so
  200.     // wird per $this->get_tables() herausgefunden welche Tabellen alle existieren und es werden
  201.     // alle Tabellen exportiert => Full Database Export
  202.     else
  203.     {
  204.       $tables = $this->get_tables();
  205.       $exportstring .= "-- FULL DATABASE EXPORT                    --".$this->newline;
  206.     }
  207.     // In den Ausgabestring die Kopfzeilen schreiben, welche den Namen der Datenbank in
  208.     // der die Tabellen liegen, das Datum zu dem der Dump erzeugt wurde sowie den Typ des
  209.     // Exports (s.o.) enthält
  210.     $exportstring .= "-- ------------------------------------------" . $this->newline
  211.                   .  "-- Database: " . $this->db.str_repeat(" ",30 - strlen($this->db)) . "--"
  212.                                                                      . $this->newline
  213.                   .  "-- Build: " . date("d.m.Y, H:i")."                --" . $this->newline
  214.                   .  "-- Script by Dennis Riehle                 --" . $this->newline
  215.                   .  "-- http://tutorial.riehle-web.com/scripts/ --" . $this->newline
  216.                   .  "-- ------------------------------------------" . $this->newline
  217.                                                                      . $this->newline;
  218.     // Gehe alle Tabellen in $tables durch und exportiere nacheinander von jeder Tabelle
  219.     // die Struktur, sowie die Daten.
  220.     foreach($tables as $table)
  221.     {
  222.       $exportstring .= "-- Table: $table" . $this->newline
  223.                     .  "-- ------------------------------------------" . $this->newline
  224.                     .  $this->export_table_structure($table, true)
  225.                     .  $this->export_table_data($table, false)
  226.                     .  $this->newline;
  227.     }
  228.     // Füge dem Exportstring noch ein Ende Kennzeichen hinzu...
  229.     $exportstring .= "-- ------------------------------------------" . $this->newline
  230.                   .  "-- Export End                              --" . $this->newline
  231.                   .  "-- ------------------------------------------" . $this->newline;
  232.     // ...und liefere den kompletten String zurück.
  233.     return $exportstring;
  234.   }
  235. }
  236. // -----------------------------------------------------------------------
  237. /*
  238.     ENDE
  239. */
  240.  
  241. ?>
  242.  

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.