Conditional config files generation - prevents overwrite during upgrade.
[fa-stable.git] / admin / db / maintenance_db.inc
1 <?php
2 /**********************************************************************
3     Copyright (C) FrontAccounting, LLC.
4         Released under the terms of the GNU General Public License,
5         GPL, as published by the Free Software Foundation, either version 
6         3 of the License, or (at your option) any later version.
7     This program is distributed in the hope that it will be useful,
8     but WITHOUT ANY WARRANTY; without even the implied warranty of
9     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
10     See the License here <http://www.gnu.org/licenses/gpl-3.0.html>.
11 ***********************************************************************/
12
13 /**
14  * @return Returns the array sorted as required
15  * @param $aryData Array containing data to sort
16  * @param $strIndex name of column to use as an index
17  * @param $strSortBy Column to sort the array by
18  * @param $strSortType String containing either asc or desc [default to asc]
19  * @desc Naturally sorts an array using by the column $strSortBy
20  */
21 function array_natsort($aryData, $strIndex, $strSortBy, $strSortType=false)
22 {
23    //    if the parameters are invalid
24    if (!is_array($aryData) || !$strSortBy)
25        //    return the array
26        return $aryData;
27
28    //    create our temporary arrays
29    $arySort = $aryResult = array();
30
31    //    loop through the array
32    foreach ($aryData as $key => $aryRow)
33        //    set up the value in the array
34        $arySort[$strIndex ? $aryRow[$strIndex] : $key] = $aryRow[$strSortBy];
35
36    //    apply the natural sort
37    natsort($arySort);
38
39    //    if the sort type is descending
40    if ($strSortType=="desc")
41        //    reverse the array
42        arsort($arySort);
43
44    //    loop through the sorted and original data
45                 foreach ($arySort as $arySortKey => $arySorted)
46                         if($strIndex) 
47                         {
48                                 foreach ($aryData as $aryOriginal)
49                                 // if the key matches
50                                         if ($aryOriginal[$strIndex]==$arySortKey)
51                                                 // add it to the output array
52                                                 array_push($aryResult, $aryOriginal);
53                         } else
54                                 $aryResult[$arySortKey] = $aryData[$arySortKey];
55    //    return the return
56    return $aryResult;
57 }
58
59
60 function write_config_db($new = false)
61 {
62         global $path_to_root, $def_coy, $db_connections, $tb_pref_counter;
63
64         if ($new)
65                 $tb_pref_counter++;
66         $n = count($db_connections);
67         $msg = "<?php\n\n";
68         $msg .= "/*Connection Information for the database\n";
69         $msg .= "- \$def_coy is the default company that is pre-selected on login\n\n";
70         $msg .= "- host is the computer ip address or name where the database is the default is localhost assuming that the web server is also the sql server\n\n";
71         $msg .= "- user is the user name under which the database should be accessed - need to change to the mysql (or other DB) user set up for purpose\n";
72         $msg .= "  NB it is not secure to use root as the user with no password - a user with appropriate privileges must be set up\n\n";
73         $msg .= "- password is the password the user of the database requires to be sent to authorise the above database user\n\n";
74         $msg .= "- DatabaseName is the name of the database as defined in the RDMS being used. Typically RDMS allow many databases to be maintained under the same server.\n";
75         $msg .= "  The scripts for MySQL provided use the name logicworks */\n\n\n";
76
77         $msg .= "\$def_coy = " . $def_coy . ";\n\n";
78         $msg .= "\$tb_pref_counter = " . $tb_pref_counter . ";\n\n";
79         $msg .= "\$db_connections = array (\n";
80         $msg .= "\t0 => ";
81         for ($i = 0; $i < $n; $i++)
82         {
83                 if ($i > 0)
84                         $msg .= "\tarray ";
85                 else
86                         $msg .= "array ";
87                 $msg .= "('name' => '" . $db_connections[$i]['name'] . "',\n";
88                 $msg .= "\t\t'host' => '" . $db_connections[$i]['host'] . "',\n";
89                 $msg .= "\t\t'dbuser' => '" . $db_connections[$i]['dbuser'] . "',\n";
90                 $msg .= "\t\t'dbpassword' => '" . $db_connections[$i]['dbpassword'] . "',\n";
91                 $msg .= "\t\t'dbname' => '" . $db_connections[$i]['dbname'] . "',\n";
92                 $msg .= "\t\t'tbpref' => '" . $db_connections[$i]['tbpref'] . "')";
93                 if ($i != $n - 1)
94                         $msg .= ",";
95                 $msg .= "\n\n";
96         }
97         $msg .= "\t);\n?>";
98
99         $filename = $path_to_root . "/config_db.php";
100         // Check if the file exists and is writable first.
101         if (!file_exists($filename) || (is_writable($path_to_root) && is_writable($filename)))
102         {
103                 if (!$zp = fopen($filename, 'w'))
104                 {
105                         return -1;
106                 }
107                 else
108                 {
109                         if (!fwrite($zp, $msg))
110                         {
111                                 fclose($zp);
112                                 return -2;
113                         }
114                         // Close file
115                         fclose($zp);
116                 }
117         }
118         else
119         {
120                 return -3;
121         }
122         return 0;
123 }
124
125 function write_extensions($extensions=null, $company = -1)
126 {
127         global $path_to_root, $installed_extensions, $next_extension_id;
128
129         if (!isset($extensions)) {
130                 $extensions = $installed_extensions;
131         }
132
133 //      $exts = array_natsort($extensions, 'name', 'name');
134 //      $extensions = $exts;
135
136         $msg = "<?php\n\n";
137         if ($company == -1)
138                 $msg .=
139 "/* List of installed additional modules and plugins. If adding extensions manually 
140         to the list make sure they have unique, so far not used extension_ids as a keys,
141         and \$next_extension_id is also updated.
142         
143         'name' - name for identification purposes;
144         'type' - type of extension: 'module' or 'plugin'
145         'path' - FA root based installation path
146         'filename' - name of module menu file, or plugin filename; related to path.
147         'tab' - index of the module tab (new for module, or one of standard module names for plugin);
148         'title' - is the menu text (for plugin) or new tab name
149         'active' - current status of extension
150         'acc_file' - (optional) file name with \$security_areas/\$security_sections extensions; 
151                 related to 'path'
152         'access' - security area code in string form
153 */
154 \n\$next_extension_id = $next_extension_id; // unique id for next installed extension\n\n";
155         else 
156                 $msg .=
157 "/*
158         Do not edit this file manually. This copy of global file is overwritten
159         by extensions editor.
160 */\n\n";
161
162         $msg .= "\$installed_extensions = array (\n";
163         foreach($extensions as $i => $ext) 
164         {
165                 $msg .= "\t$i => ";
166                 $msg .= "array ( ";
167                 $t = '';
168                 foreach($ext as $key => $val) {
169                         $msg .= $t."'$key' => '$val',\n";
170                         $t = "\t\t\t";
171                 }
172                 $msg .= "\t\t),\n";
173         }
174         $msg .= "\t);\n?>";
175
176         $filename = $path_to_root . ($company==-1 ? '' : '/company/'.$company)
177                 .'/installed_extensions.php';
178
179         // Check if the file is writable first.
180         if (!$zp = @fopen($filename, 'w'))
181         {
182                 display_error(sprintf(_("Cannot open the extension setup file '%s' for writing."),
183                          $filename));
184                 return false;
185         }
186         else
187         {
188                 if (!fwrite($zp, $msg))
189                 {
190                         display_error(sprintf(_("Cannot write to the extensions setup file '%s'."),
191                                 $filename));
192                         fclose($zp);
193                         return false;
194                 }
195                 // Close file
196                 fclose($zp);
197         }
198         return true;
199 }
200
201 function write_lang()
202 {
203         global $path_to_root, $installed_languages, $dflt_lang;
204
205         $conn = array_natsort($installed_languages, 'code', 'code');
206         $installed_languages = $conn;
207         //reset($installed_languages);
208         $n = count($installed_languages);
209         $msg = "<?php\n\n";
210
211         $msg .= "/* How to make new entries here\n\n";
212         $msg .= "-- if adding languages at the beginning of the list, make sure it's index is set to 0 (it has ' 0 => ')\n";
213         $msg .= "-- 'code' should match the name of the directory for the language under \\lang\n";
214         $msg .= "-- 'name' is the name that will be displayed in the language selection list (in Users and Display Setup)\n";
215         $msg .= "-- 'rtl' only needs to be set for right-to-left languages like Arabic and Hebrew\n\n";
216         $msg .= "*/\n\n\n";
217
218         $msg .= "\$installed_languages = array (\n";
219         if ($n > 0)
220             $msg .= "\t0 => ";
221         for ($i = 0; $i < $n; $i++)
222         {
223                 if ($i > 0)
224                         $msg .= "\t\tarray ";
225                 else
226                         $msg .= "array ";
227                 $msg .= "('code' => '" . $installed_languages[$i]['code'] . "', ";
228                 $msg .= "'name' => '" . $installed_languages[$i]['name'] . "', ";
229                 $msg .= "'encoding' => '" . $installed_languages[$i]['encoding'] . "'";
230                 if (isset($installed_languages[$i]['rtl']) && $installed_languages[$i]['rtl'])
231                         $msg .= ", 'rtl' => true),\n";
232                 else
233                         $msg .= "),\n";
234         }
235
236         $msg .= "\t);\n";
237         $msg .= "\n\$dflt_lang = '$dflt_lang';\n?>\n";
238
239         $path = $path_to_root . "/lang";
240         $filename = $path.'/installed_languages.inc';
241         // Check if directory exists and is writable first.
242         if (file_exists($path) && is_writable($path))
243         {
244                 if (!$zp = fopen($filename, 'w'))
245                 {
246                         display_error(_("Cannot open the languages file - ") . $filename);
247                         return false;
248                 }
249                 else
250                 {
251                         if (!fwrite($zp, $msg))
252                         {
253                                 display_error(_("Cannot write to the language file - ") . $filename);
254                                 fclose($zp);
255                                 return false;
256                         }
257                         // Close file
258                         fclose($zp);
259                 }
260         }
261         else
262         {
263                 display_error(_("The language files folder ") . $path . _(" is not writable. Change its permissions so it is, then re-run the operation."));
264                 return false;
265         }
266         return true;
267 }
268
269 function db_create_db($connection)
270 {
271         $db = mysql_connect($connection["host"] ,
272                 $connection["dbuser"], $connection["dbpassword"]);
273         if (!mysql_select_db($connection["dbname"], $db))
274         {
275                 $sql = "CREATE DATABASE " . $connection["dbname"] . "";
276                 if (!mysql_query($sql))
277                         return 0;
278                 mysql_select_db($connection["dbname"], $db);
279         }
280         return $db;
281 }
282
283 function db_drop_db($connection)
284 {
285
286         if ($connection["tbpref"] == "")
287         {
288                 $sql = "DROP DATABASE " . $connection["dbname"] . "";
289                 return mysql_query($sql);
290         }
291         else
292         {
293         $res = db_query("show table status");
294         $all_tables = array();
295         while($row = db_fetch($res))
296                 $all_tables[] = $row;
297         // get table structures
298                 foreach ($all_tables as $table)
299                 {
300                         if (strpos($table['Name'], $connection["tbpref"]) === 0)
301                                 db_query("DROP TABLE `".$table['Name'] . "`");
302                 }
303                 //deleting the tables, how??
304                 return true;
305         }
306 }
307
308 function db_import($filename, $connection, $force=true)
309 {
310         global $db, $go_debug;
311         
312         $allowed_commands = array(
313                 "create"  => 'table_queries', 
314                 "alter table" => 'table_queries', 
315                 "insert" => 'data_queries', 
316                 "update" => 'data_queries', 
317                 "drop table if exists" => 'drop_queries');
318         $ignored_mysql_errors = array( //errors ignored in normal (non forced) mode
319                 '1022', // duplicate key
320                 '1050', // Table %s already exists
321                 '1060', // duplicate column name
322                 '1061', // duplicate key name
323                 '1062', // duplicate key entry
324                 '1091'  // can't drop key/column check if exists
325         );
326         $data_queries = array();
327         $drop_queries = array();
328         $table_queries = array();
329         $sql_errors = array();
330
331         ini_set("max_execution_time", "180");
332         db_query("SET foreign_key_checks=0");
333
334         // uncrompress gziped backup files
335         if (strpos($filename, ".gz") || strpos($filename, ".GZ"))
336                 $lines = db_ungzip("lines", $filename);
337         elseif (strpos($filename, ".zip") || strpos($filename, ".ZIP"))
338                 $lines = db_unzip("lines", $filename);
339         else
340                 $lines = file("". $filename);
341
342         // parse input file
343         $query_table = '';
344         foreach($lines as $line_no => $line)
345         {
346                 $line = trim($line);
347                 
348                 $line = str_replace("0_", $connection["tbpref"], $line);
349
350                 if ($query_table == '') 
351                 {       // check if line begins with one of allowed queries
352                         foreach($allowed_commands as $cmd => $table) 
353                         {
354                                 if (strtolower(substr($line, 0, strlen($cmd))) == $cmd) 
355                                 {
356                                         $query_table = $table;
357                                         ${$query_table}[] = array('', $line_no+1);
358                                         break;
359                                 }
360                         }
361                  }
362                  if($query_table != '')  // inside allowed query
363                  {
364                         $table = $query_table;
365                         if (substr($line, -1) == ';') // end of query found
366                         {
367                                 $line = substr($line, 0, strlen($line) - 1); // strip ';'
368                                 $query_table = '';
369                         }
370                         ${$table}[count(${$table}) - 1][0] .= $line . "\n";
371                 }
372                 
373         }
374 /*
375         {       // for debugging purposes
376         global $path_to_root;
377         $f = fopen($path_to_root.'/tmp/dbimport.txt', 'w+');
378         fwrite($f, print_r($drop_queries,true) ."\n");
379         fwrite($f, print_r($table_queries,true) ."\n");
380         fwrite($f, print_r($data_queries,true));
381         fclose($f);
382         }
383 */
384         // execute drop tables if exists queries
385         if (is_array($drop_queries))
386         {
387                 foreach($drop_queries as $drop_query)
388                 {
389                         if (!db_query($drop_query[0]))
390                         {
391                                 if (!in_array(db_error_no(), $ignored_mysql_errors) || !$force)
392                                         $sql_errors[] = array(db_error_msg($db), $drop_query[1]);
393                         }
394                 }
395         }
396
397         // execute create tables queries
398         if (is_array($table_queries))
399         {
400                 foreach($table_queries as $table_query)
401                 {
402                         if (!db_query($table_query[0]))
403                         {       
404                                 if (!in_array(db_error_no(), $ignored_mysql_errors) || !$force) {
405                                         $sql_errors[] = array(db_error_msg($db), $table_query[1]);
406                                 }
407                         }
408                 }
409         }
410
411         // execute insert data queries
412         if (is_array($data_queries))
413         {
414                 foreach($data_queries as $data_query)
415                 {
416                         if (!db_query($data_query[0]))
417                         {
418                                 if (!in_array(db_error_no(),$ignored_mysql_errors) || !$force)
419                                         $sql_errors[] = array(db_error_msg($db), $data_query[1]);
420                         }
421                 }
422         }
423         
424         db_query("SET foreign_key_checks=1");
425
426         if (count($sql_errors)) {
427                 // display first failure message; the rest are probably derivative 
428                 $err = $sql_errors[0];
429                 display_error(sprintf(_("SQL script execution failed in line %d: %s"),
430                         $err[1], $err[0]));
431                 return false;
432         } else
433                 return true;
434         //$shell_command = C_MYSQL_PATH . " -h $host -u $user -p{$password} $dbname < $filename";
435         //shell_exec($shell_command);
436 }
437
438 // returns the content of the gziped $path backup file. use of $mode see below
439 function db_ungzip($mode, $path)
440 {
441     $file_data = gzfile($path);
442     // returns one string or an array of lines
443     if ($mode != "lines")
444         return implode("",$file_data);
445     else
446         return $file_data;
447 }
448
449 // returns the content of the ziped $path backup file. use of $mode see below
450 function db_unzip($mode, $path)
451 {
452     $all = false;
453     $all = implode("", file($path));
454
455     // convert path to name of ziped file
456     $filename = ereg_replace(".*/", "", $path);
457     $filename = substr($filename, 0, strlen($filename) - 4);
458
459     // compare filname in zip and filename from $_GET
460     if (substr($all, 30, strlen($filename)-4) . substr($all, 30+strlen($filename)+9, 4)
461           != $filename) {
462                 return '';     // exit if names differ
463     }
464     else
465     {
466         // get the suffix of the filename in hex
467                 $crc_bugfix = substr($all, 30, strlen($filename)+13);
468         $crc_bugfix = substr(substr($crc_bugfix, 0, strlen($crc_bugfix) - 4), 
469                                 strlen($crc_bugfix) - 12 - 4);
470         $suffix = false;
471         // convert hex to ascii
472         for ($i=0; $i < 12; )
473                 $suffix .= chr($crc_bugfix[$i++] . $crc_bugfix[$i++] . $crc_bugfix[$i++]);
474
475         // remove central directory information (we have always just one ziped file)
476         $comp = substr($all, -(strlen($all) - 30 - strlen($filename)-13));
477         $comp = substr($comp, 0, (strlen($comp) - 80 - strlen($filename)-13));
478
479         // fix the crc bugfix (see function save_to_file)
480         $comp = "x\9c" . $comp . $suffix;
481         $file_data = gzuncompress($comp);
482     }
483
484     // returns one string or an array of lines
485     if ($mode != "lines")
486         return $file_data;
487     else
488         return explode("\n", $file_data);
489 }
490
491 function db_backup($conn, $ext='no', $comm='', $tbpref = TB_PREF)
492 {
493         if ($conn['tbpref'] != "")
494                 $filename = $conn['dbname'] . "_" . $conn['tbpref'] . date("Ymd_Hi") . ".sql";
495         else
496                 $filename = $conn['dbname'] . "_" . date("Ymd_Hi") . ".sql";
497
498         return db_export($conn, $filename, $ext, $comm, $tbpref);
499 }
500
501 // generates a dump of $db database
502 // $drop and $zip tell if to include the drop table statement or dry to pack
503 function db_export($conn, $filename, $zip='no', $comment='', $tbpref = TB_PREF)
504 {
505
506         global $app_title, $version, $power_url, $path_to_root;
507
508     $error = false;
509     // set max string size before writing to file
510     $max_size = 1048576 * 2; // 2 MB
511     // changes max size if value can be retrieved
512     if (ini_get("memory_limit"))
513         $max_size = 900000 * ini_get("memory_limit");
514
515     // set backupfile name
516     if ($zip == "gzip")
517         $backupfile = $filename . ".gz";
518     elseif ($zip == "zip")
519         $backupfile = $filename . ".zip";
520     else
521         $backupfile = $filename;
522     $company = get_company_pref('coy_name', $tbpref);
523
524     //create comment
525     $out="# MySQL dump of database '".$conn["dbname"]."' on host '".$conn["host"]."'\n";
526     $out.="# Backup Date and Time: ".date("Y-m-d H:i")."\n";
527     $out.="# Built by " . $app_title . " " . $version ."\n";
528     $out.="# ".$power_url."\n";
529     $out.="# Company: ". @html_entity_decode($company, ENT_QUOTES, $_SESSION['language']->encoding)."\n";
530     $out.="# User: ".$_SESSION["wa_current_user"]->name."\n\n";
531
532         // write users comment
533         if ($comment)
534         {
535                 $out .= "# Comment:\n";
536                 $comment=preg_replace("'\n'","\n# ","# ".$comment);
537                 //$comment=str_replace("\n", "\n# ", $comment);
538                 foreach(explode("\n",$comment) as $line)
539                         $out .= $line."\n";
540                 $out.="\n";
541         }
542
543     //$out.="use ".$db.";\n"; we don't use this option.
544
545     // get auto_increment values and names of all tables
546     $res = db_query("show table status");
547     $all_tables = array();
548     while($row = db_fetch($res))
549     {
550                 //if ($conn["tbpref"] == "" || strpos($row['Name'], $conn["tbpref"]) !== false) replaced
551                 if (($conn["tbpref"] == "" && !preg_match('/[0-9]+_/', $row['Name'])) ||
552                         ($conn["tbpref"] != "" && strpos($row['Name'], $conn["tbpref"]) !== false))
553                 $all_tables[] = $row;
554     }
555         // get table structures
556         foreach ($all_tables as $table)
557         {
558                 $res1 = db_query("SHOW CREATE TABLE `" . $table['Name'] . "`");
559                 $tmp = db_fetch($res1);
560                 $table_sql[$table['Name']] = $tmp["Create Table"];
561         }
562
563         // find foreign keys
564         $fks = array();
565         if (isset($table_sql))
566         {
567                 foreach($table_sql as $tablenme=>$table)
568                 {
569                         $tmp_table=$table;
570                         // save all tables, needed for creating this table in $fks
571                         while (($ref_pos = strpos($tmp_table, " REFERENCES ")) > 0)
572                         {
573                                 $tmp_table = substr($tmp_table, $ref_pos + 12);
574                                 $ref_pos = strpos($tmp_table, "(");
575                                 $fks[$tablenme][] = substr($tmp_table, 0, $ref_pos);
576                         }
577                 }
578         }
579         // order $all_tables
580         $all_tables = order_sql_tables($all_tables, $fks);
581
582         // as long as no error occurred
583         if (!$error)
584         {
585                 //while($row=@mysql_fetch_array($res))
586                 foreach ($all_tables as $row)
587                 {
588                         $tablename = $row['Name'];
589                         $auto_incr[$tablename] = $row['Auto_increment'];
590
591                         $out.="\n\n";
592                         // export tables
593                         $out.="### Structure of table `".$tablename."` ###\n\n";
594
595                         $out.="DROP TABLE IF EXISTS `".$tablename."`;\n\n";
596                         $out.=$table_sql[$tablename];
597
598                         // add auto_increment value
599                         if ($auto_incr[$tablename])
600                                 $out.=" AUTO_INCREMENT=".$auto_incr[$tablename];
601                         $out.=" ;";
602                         $out.="\n\n\n";
603
604                         // export data
605                         if (!$error)
606                         {
607                                 $out.="### Data of table `".$tablename."` ###\n\n";
608
609                                 // check if field types are NULL or NOT NULL
610                                 $res3 = db_query("SHOW COLUMNS FROM `" . $tablename . "`");
611
612                                 $field_type = array();
613                                 for ($j = 0; $j < db_num_rows($res3); $j++)
614                                 {
615                                         $row3 = db_fetch($res3);
616                                         $field_type[] = $row3[2];
617                                 }
618
619                                 $res2 = db_query("SELECT * FROM `" . $tablename . "`");
620                                 for ($j = 0; $j < db_num_rows($res2); $j++)
621                                 {
622                                         $out .= "INSERT INTO `" . $tablename . "` VALUES (";
623                                         $row2 = db_fetch_row($res2);
624                                         // run through each field
625                                         for ($k = 0; $k < $nf = db_num_fields($res2); $k++)
626                                         {
627                                                 $out .= db_escape(@html_entity_decode($row2[$k], ENT_QUOTES, $_SESSION['language']->encoding));
628                                                 if ($k < ($nf - 1))
629                                                         $out .= ", ";
630                                         }
631                                         $out .= ");\n";
632
633                                         // if saving is successful, then empty $out, else set error flag
634                                         if (strlen($out) > $max_size && $zip != "zip")
635                                         {
636                                                 if (save_to_file($backupfile, $zip, $out))
637                                                         $out = "";
638                                                 else
639                                                         $error = true;
640                                         }
641                                 }
642
643                         // an error occurred! Try to delete file and return error status
644                         }
645                         elseif ($error)
646                         {
647                                 @unlink(BACKUP_PATH . $backupfile);
648                                 return false;
649                         }
650
651                         // if saving is successful, then empty $out, else set error flag
652                         if (strlen($out) > $max_size && $zip != "zip")
653                         {
654                                 if (save_to_file($backupfile, $zip, $out))
655                                         $out= "";
656                                 else
657                                         $error = true;
658                         }
659                 }
660
661         // an error occurred! Try to delete file and return error status
662         }
663         else
664         {
665                 @unlink(BACKUP_PATH . $backupfile);
666                 return false;
667         }
668
669         // if (mysql_error()) return "DB_ERROR";
670         //@mysql_close($con);
671
672         //if ($zip == "zip")
673         //      $zip = $time;
674         if (save_to_file($backupfile, $zip, $out))
675         {
676                 $out = "";
677         }
678         else
679         {
680                 @unlink(BACKUP_PATH . $backupfile);
681                 return false;
682         }
683     return $backupfile;
684 }
685
686 // orders the tables in $tables according to the constraints in $fks
687 // $fks musst be filled like this: $fks[tablename][0]=needed_table1; $fks[tablename][1]=needed_table2; ...
688 function order_sql_tables($tables, $fks)
689 {
690         // do not order if no contraints exist
691         if (!count($fks))
692                 return $tables;
693
694         // order
695         $new_tables = array();
696         $existing = array();
697         $modified = true;
698         while (count($tables) && $modified == true)
699         {
700                 $modified = false;
701             foreach ($tables as $key=>$row)
702             {
703                 // delete from $tables and add to $new_tables
704                 if (isset($fks[$row['Name']]))
705                 {
706                         foreach($fks[$row['Name']] as $needed)
707                         {
708                         // go to next table if not all needed tables exist in $existing
709                         if (!in_array($needed,$existing))
710                                 continue 2;
711                     }
712                 }
713             // delete from $tables and add to $new_tables
714                 $existing[] = $row['Name'];
715                         $new_tables[] = $row;
716             prev($tables);
717             unset($tables[$key]);
718             $modified = true;
719
720             }
721         }
722
723         if (count($tables))
724         {
725             // probably there are 'circles' in the constraints, bacause of that no proper backups can be created yet
726             // TODO: this will be fixed sometime later through using 'alter table' commands to add the constraints after generating the tables
727             // until now, just add the lasting tables to $new_tables, return them and print a warning
728             foreach($tables as $row)
729                 $new_tables[] = $row;
730             echo "<div class=\"red_left\">THIS DATABASE SEEMS TO CONTAIN 'RING CONSTRAINTS'. WA DOES NOT SUPPORT THEM. PROBABLY THE FOLOWING BACKUP IS DEFECT!</div>";
731         }
732         return $new_tables;
733 }
734
735 // saves the string in $fileData to the file $backupfile as gz file or not ($zip)
736 // returns backup file name if name has changed (zip), else TRUE. If saving failed, return value is FALSE
737 function save_to_file($backupfile, $zip, $fileData)
738 {
739         global $path_to_root;
740
741     if ($zip == "gzip")
742     {
743         if ($zp = @gzopen(BACKUP_PATH . $backupfile, "a9"))
744         {
745                         @gzwrite($zp, $fileData);
746                         @gzclose($zp);
747                         return true;
748         }
749         else
750         {
751                 return false;
752         }
753
754     // $zip contains the timestamp
755     }
756     elseif ($zip == "zip")
757     {
758         // based on zip.lib.php 2.2 from phpMyBackupAdmin
759         // offical zip format: http://www.pkware.com/appnote.txt
760
761         // End of central directory record
762         $eof_ctrl_dir = "\x50\x4b\x05\x06\x00\x00\x00\x00";
763
764         // "local file header" segment
765         $unc_len = strlen($fileData);
766         $crc = crc32($fileData);
767         $zdata = gzcompress($fileData);
768
769                 // extend stored file name with suffix
770         // needed for decoding (because of crc bug)
771         $name_suffix = substr($zdata, -4, 4);
772         $name_suffix2 = "_";
773         for ($i = 0; $i < 4; $i++)
774                 $name_suffix2 .= sprintf("%03d", ord($name_suffix[$i]));
775
776         $name = substr($backupfile, 0, strlen($backupfile) - 8) . $name_suffix2 . ".sql";
777
778         // fix crc bug
779         $zdata = substr(substr($zdata, 0, strlen($zdata) - 4), 2);
780         $c_len = strlen($zdata);
781
782         // dos time
783         $timearray = getdate($zip);
784         $dostime = (($timearray['year'] - 1980) << 25) | ($timearray['mon'] << 21) | ($timearray['mday'] << 16) |
785             ($timearray['hours'] << 11) | ($timearray['minutes'] << 5) | ($timearray['seconds'] >> 1);
786         $dtime = dechex($dostime);
787         $hexdtime = "\x" . $dtime[6] . $dtime[7] . "\x" . $dtime[4].$dtime[5] . "\x" . $dtime[2] . $dtime[3] . "\x" . $dtime[0] . $dtime[1];
788         eval('$hexdtime="' . $hexdtime . '";');
789
790         // ver needed to extract, gen purpose bit flag, compression method, last mod time and date
791         $sub1 = "\x14\x00" . "\x00\x00" . "\x08\x00" . $hexdtime;
792
793         // crc32, compressed filesize, uncompressed filesize
794         $sub2 = pack('V', $crc) . pack('V', $c_len) . pack('V', $unc_len);
795
796         $fr = "\x50\x4b\x03\x04" . $sub1. $sub2;
797
798         // length of filename, extra field length
799         $fr .= pack('v', strlen($name)) . pack('v', 0);
800         $fr .= $name;
801
802         // "file data" segment and "data descriptor" segment (optional but necessary if archive is not served as file)
803         $fr .= $zdata . $sub2;
804
805         // now add to central directory record
806         $cdrec = "\x50\x4b\x01\x02";
807         $cdrec .= "\x00\x00";                // version made by
808         $cdrec .= $sub1 . $sub2;
809
810          // length of filename, extra field length, file comment length, disk number start, internal file attributes, external file attributes - 'archive' bit set, offset
811         $cdrec .= pack('v', strlen($name)) . pack('v', 0) . pack('v', 0) . pack('v', 0) . pack('v', 0) . pack('V', 32) . pack('V',0);
812         $cdrec .= $name;
813
814         // combine data
815         $fileData = $fr . $cdrec . $eof_ctrl_dir;
816
817         // total # of entries "on this disk", total # of entries overall, size of central dir, offset to start of central dir, .zip file comment length
818         $fileData .= pack('v', 1) . pack('v', 1) . pack('V', strlen($cdrec)) . pack('V', strlen($fr)) . "\x00\x00";
819
820         if ($zp = @fopen(BACKUP_PATH . $backupfile, "a"))
821         {
822                         @fwrite($zp, $fileData);
823                         @fclose($zp);
824                         return true;
825         }
826         else
827         {
828                 return false;
829         }
830
831         // uncompressed
832     }
833     else
834     {
835         if ($zp = @fopen(BACKUP_PATH . $backupfile, "a"))
836         {
837                         @fwrite($zp, $fileData);
838                         @fclose($zp);
839                         return true;
840         }
841         else
842         {
843                 return false;
844         }
845     }
846 }
847
848 function create_comp_dirs($comp_path, $comp_subdirs)
849 {
850                 $index = "<?php\nheader(\"Location: ../index.php\");\n?>";
851             $cdir = $comp_path;
852             @mkdir($cdir);
853                 $f = @fopen("$cdir/index.php", "wb");
854                 @fwrite($f, $index);
855                 @fclose($f);
856
857             foreach($comp_subdirs as $dir)
858             {
859                         @mkdir($cdir.'/'.$dir);
860                         $f = @fopen("$cdir/$dir/index.php", "wb");
861                         @fwrite($f, $index);
862                         @fclose($f);
863             }
864 }
865 ?>