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