Merged changes up to version 2.3.4 into unstable.
[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 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;
257
258         $allowed_commands = array(
259                 "create"  => 'table_queries', 
260                 "delimiter" => 'table_queries',
261                 "alter table" => 'table_queries', 
262                 "insert" => 'data_queries', 
263                 "update" => 'data_queries', 
264                 "drop table if exists" => 'drop_queries',
265                 "drop function if exists" => 'drop_queries',
266                 "drop trigger if exists" => 'drop_queries',
267                 );
268         $ignored_mysql_errors = array( //errors ignored in normal (non forced) mode
269                 '1022', // duplicate key
270                 '1050', // Table %s already exists
271                 '1060', // duplicate column name
272                 '1061', // duplicate key name
273                 '1062', // duplicate key entry
274                 '1091'  // can't drop key/column check if exists
275         );
276         $data_queries = array();
277         $drop_queries = array();
278         $table_queries = array();
279         $sql_errors = array();
280
281         ini_set("max_execution_time", "180");
282         db_query("SET foreign_key_checks=0");
283         // uncrompress gziped backup files
284         if (strpos($filename, ".gz") || strpos($filename, ".GZ"))
285                 $lines = db_ungzip("lines", $filename);
286         elseif (strpos($filename, ".zip") || strpos($filename, ".ZIP"))
287                 $lines = db_unzip("lines", $filename);
288         else
289                 $lines = file("". $filename);
290
291         // parse input file
292         $query_table = '';
293         $delimiter = ';';
294         foreach($lines as $line_no => $line)
295         {
296                 $line = trim($line);
297                 
298                 $line = str_replace("0_", $connection["tbpref"], $line);
299
300                 if ($query_table == '') 
301                 {       // check if line begins with one of allowed queries
302                         foreach($allowed_commands as $cmd => $table) 
303                         {
304                                 if (strtolower(substr($line, 0, strlen($cmd))) == $cmd) 
305                                 {
306                                         if ($cmd == 'delimiter') {
307                                                 $delimiter = trim(substr($line, 10));
308                                                 continue 2;
309                                         }
310                                         $query_table = $table;
311                                         ${$query_table}[] = array('', $line_no+1);
312                                         break;
313                                 }
314                         }
315                  }
316                  if($query_table != '')  // inside allowed query
317                  {
318                         $table = $query_table;
319
320                         if (substr($line, -strlen($delimiter)) == $delimiter) // end of query found
321                         {
322                                 $line = substr($line, 0, strlen($line) - strlen($delimiter)); // strip delimiter
323                                 $query_table = '';
324                         }
325                         ${$table}[count(${$table}) - 1][0] .= $line . "\n";
326                 }
327                 
328         }
329 /*
330         {       // for debugging purposes
331         global $path_to_root;
332         $f = fopen($path_to_root.'/tmp/dbimport.txt', 'w+');
333         fwrite($f, print_r($drop_queries,true) ."\n");
334         fwrite($f, print_r($table_queries,true) ."\n");
335         fwrite($f, print_r($data_queries,true));
336         fclose($f);
337         }
338 */
339         // execute drop tables if exists queries
340         if (is_array($drop_queries))
341         {
342                 foreach($drop_queries as $drop_query)
343                 {
344                         if (!db_query($drop_query[0]))
345                         {
346                                 if (!in_array(db_error_no(), $ignored_mysql_errors) || !$force)
347                                         $sql_errors[] = array(db_error_msg($db), $drop_query[1]);
348                         }
349                 }
350         }
351
352         // execute create tables queries
353         if (is_array($table_queries))
354         {
355                 foreach($table_queries as $table_query)
356                 {
357                         if (!db_query($table_query[0]))
358                         {       
359                                 if (!in_array(db_error_no(), $ignored_mysql_errors) || !$force) {
360                                         $sql_errors[] = array(db_error_msg($db), $table_query[1]);
361                                 }
362                         }
363                 }
364         }
365
366         // execute insert data queries
367         if (is_array($data_queries))
368         {
369                 foreach($data_queries as $data_query)
370                 {
371                         if (!db_query($data_query[0]))
372                         {
373                                 if (!in_array(db_error_no(),$ignored_mysql_errors) || !$force)
374                                         $sql_errors[] = array(db_error_msg($db), $data_query[1]);
375                         }
376                 }
377         }
378         
379         db_query("SET foreign_key_checks=1");
380         if ($delimiter != ';') db_query("delimiter ;"); // just for any case
381
382         if (count($sql_errors)) {
383                 // display first failure message; the rest are probably derivative 
384                 $err = $sql_errors[0];
385                 display_error(sprintf(_("SQL script execution failed in line %d: %s"),
386                         $err[1], $err[0]));
387                 return false;
388         } else
389                 return true;
390 }
391
392 // returns the content of the gziped $path backup file. use of $mode see below
393 function db_ungzip($mode, $path)
394 {
395     $file_data = gzfile($path);
396     // returns one string or an array of lines
397     if ($mode != "lines")
398         return implode("",$file_data);
399     else
400         return $file_data;
401 }
402
403 // returns the content of the ziped $path backup file. use of $mode see below
404 function db_unzip($mode, $path)
405 {
406     $all = false;
407     $all = implode("", file($path));
408
409     // convert path to name of ziped file
410     $filename = preg_replace("/.*\//", "", $path);
411     $filename = substr($filename, 0, strlen($filename) - 4);
412
413     // compare filname in zip and filename from $_GET
414     if (substr($all, 30, strlen($filename)-4) . substr($all, 30+strlen($filename)+9, 4)
415           != $filename) {
416                 return '';     // exit if names differ
417     }
418     else
419     {
420         // get the suffix of the filename in hex
421                 $crc_bugfix = substr($all, 30, strlen($filename)+13);
422         $crc_bugfix = substr(substr($crc_bugfix, 0, strlen($crc_bugfix) - 4), 
423                                 strlen($crc_bugfix) - 12 - 4);
424         $suffix = false;
425         // convert hex to ascii
426         for ($i=0; $i < 12; )
427                 $suffix .= chr($crc_bugfix[$i++] . $crc_bugfix[$i++] . $crc_bugfix[$i++]);
428
429         // remove central directory information (we have always just one ziped file)
430         $comp = substr($all, -(strlen($all) - 30 - strlen($filename)-13));
431         $comp = substr($comp, 0, (strlen($comp) - 80 - strlen($filename)-13));
432
433         // fix the crc bugfix (see function save_to_file)
434         $comp = "x\9c" . $comp . $suffix;
435         $file_data = gzuncompress($comp);
436     }
437
438     // returns one string or an array of lines
439     if ($mode != "lines")
440         return $file_data;
441     else
442         return explode("\n", $file_data);
443 }
444
445 function db_backup($conn, $ext='no', $comm='', $path=null)
446 {
447         if ($conn['tbpref'] != "")
448                 $filename = $conn['dbname'] . "_" . $conn['tbpref'] . date("Ymd_Hi") . ".sql";
449         else
450                 $filename = $conn['dbname'] . "_" . date("Ymd_Hi") . ".sql";
451
452         if (!isset($path))
453                 $path = BACKUP_PATH;
454
455         return db_export($conn, $path . clean_file_name($filename), $ext, $comm);
456 }
457
458 // generates a dump of $db database
459 // $drop and $zip tell if to include the drop table statement or dry to pack
460 function db_export($conn, $filename, $zip='no', $comment='', $no_default=false)
461 {
462
463         global $app_title, $version, $power_url, $path_to_root;
464
465
466     $error = false;
467     // set max string size before writing to file
468     $max_size = 1048576 * 2; // 2 MB
469     // changes max size if value can be retrieved
470     if (ini_get("memory_limit"))
471         $max_size = 900000 * ini_get("memory_limit");
472
473     // set backupfile name
474     if ($zip == "gzip")
475         $backupfile = $filename . ".gz";
476     elseif ($zip == "zip")
477         $backupfile = $filename . ".zip";
478     else
479         $backupfile = $filename;
480     $company = $conn['name']; // get_company_pref('coy_name');
481
482     //create comment
483     $out="# MySQL dump of database '".$conn["dbname"]."' on host '".$conn["host"]."'\n";
484     $out.="# Backup Date and Time: ".date("Y-m-d H:i")."\n";
485     $out.="# Built by " . $app_title . " " . $version ."\n";
486     $out.="# ".$power_url."\n";
487     $out.="# Company: ". @html_entity_decode($company, ENT_QUOTES, $_SESSION['language']->encoding)."\n";
488     $out.="# User: ".$_SESSION["wa_current_user"]->name."\n\n";
489
490         // write users comment
491         if ($comment)
492         {
493                 $out .= "# Comment:\n";
494                 $comment=preg_replace("'\n'","\n# ","# ".$comment);
495                 //$comment=str_replace("\n", "\n# ", $comment);
496                 foreach(explode("\n",$comment) as $line)
497                         $out .= $line."\n";
498                 $out.="\n";
499         }
500
501     //$out.="use ".$db.";\n"; we don't use this option.
502
503     // get auto_increment values and names of all tables
504     $res = db_query("show table status");
505     $all_tables = array();
506     while($row = db_fetch($res))
507     {
508                 if (($conn["tbpref"] == "" && !preg_match('/[0-9]+_/', $row['Name'])) ||
509                         ($conn["tbpref"] != "" && strpos($row['Name'], $conn["tbpref"]) === 0))
510                 $all_tables[] = $row;
511     }
512         // get table structures
513         foreach ($all_tables as $table)
514         {
515                 $res1 = db_query("SHOW CREATE TABLE `" . $table['Name'] . "`");
516                 $tmp = db_fetch($res1);
517                 $table_sql[$table['Name']] = $tmp["Create Table"];
518         }
519
520         // find foreign keys
521         $fks = array();
522         if (isset($table_sql))
523         {
524                 foreach($table_sql as $tablenme=>$table)
525                 {
526                         $tmp_table=$table;
527                         // save all tables, needed for creating this table in $fks
528                         while (($ref_pos = strpos($tmp_table, " REFERENCES ")) > 0)
529                         {
530                                 $tmp_table = substr($tmp_table, $ref_pos + 12);
531                                 $ref_pos = strpos($tmp_table, "(");
532                                 $fks[$tablenme][] = substr($tmp_table, 0, $ref_pos);
533                         }
534                 }
535         }
536         // order $all_tables
537         $all_tables = order_sql_tables($all_tables, $fks);
538
539         // as long as no error occurred
540         if (!$error)
541         {
542                 foreach ($all_tables as $row)
543                 {
544                         $tablename = $row['Name'];
545                         $auto_incr[$tablename] = $row['Auto_increment'];
546
547                         $out.="\n\n";
548                         // export tables
549                         $out.="### Structure of table `".$tablename."` ###\n\n";
550
551                         $out.="DROP TABLE IF EXISTS `".$tablename."`;\n\n";
552                         if ($no_default && ($def_pos = strpos($table_sql[$tablename], "DEFAULT CHARSET")) > 0)
553                                 $table_sql[$tablename] = substr($table_sql[$tablename], 0, $def_pos);
554                         $out.=$table_sql[$tablename];
555
556                         // add auto_increment value
557 //                      if ($auto_incr[$tablename])
558 //                              $out.=" AUTO_INCREMENT=".$auto_incr[$tablename];
559                         $out.=" ;";
560                         $out.="\n\n\n";
561
562                         // export data
563                         if (!$error)
564                         {
565                                 $out.="### Data of table `".$tablename."` ###\n\n";
566
567                                 // check if field types are NULL or NOT NULL
568                                 $res3 = db_query("SHOW COLUMNS FROM `" . $tablename . "`");
569
570                                 $field_null = array();
571                                 for ($j = 0; $j < db_num_rows($res3); $j++)
572                                 {
573                                         $row3 = db_fetch($res3);
574                                         $field_null[] = $row3[2]=='YES' && $row3[4]===null;
575                                 }
576
577                                 $res2 = db_query("SELECT * FROM `" . $tablename . "`");
578                                 for ($j = 0; $j < db_num_rows($res2); $j++)
579                                 {
580                                         $out .= "INSERT INTO `" . $tablename . "` VALUES (";
581                                         $row2 = db_fetch_row($res2);
582                                         // run through each field
583                                         for ($k = 0; $k < $nf = db_num_fields($res2); $k++)
584                                         {
585                                                 $out .= db_escape($row2[$k], $field_null[$k]);
586                                                 if ($k < ($nf - 1))
587                                                         $out .= ", ";
588                                         }
589                                         $out .= ");\n";
590
591                                         // if saving is successful, then empty $out, else set error flag
592                                         if (strlen($out) > $max_size && $zip != "zip")
593                                         {
594                                                 if (save_to_file($backupfile, $zip, $out))
595                                                         $out = "";
596                                                 else
597                                                         $error = true;
598                                         }
599                                 }
600
601                         // an error occurred! Try to delete file and return error status
602                         }
603                         elseif ($error)
604                         {
605                                 @unlink($backupfile);
606                                 return false;
607                         }
608
609                         // if saving is successful, then empty $out, else set error flag
610                         if (strlen($out) > $max_size && $zip != "zip")
611                         {
612                                 if (save_to_file($backupfile, $zip, $out))
613                                         $out= "";
614                                 else
615                                         $error = true;
616                         }
617                 }
618
619         // an error occurred! Try to delete file and return error status
620         }
621         else
622         {
623                 @unlink($backupfile);
624                 return false;
625         }
626
627         //if ($zip == "zip")
628         //      $zip = $time;
629         if (save_to_file($backupfile, $zip, $out))
630         {
631                 $out = "";
632         }
633         else
634         {
635                 @unlink($backupfile);
636                 return false;
637         }
638     return $backupfile;
639 }
640
641 // orders the tables in $tables according to the constraints in $fks
642 // $fks musst be filled like this: $fks[tablename][0]=needed_table1; $fks[tablename][1]=needed_table2; ...
643 function order_sql_tables($tables, $fks)
644 {
645         // do not order if no contraints exist
646         if (!count($fks))
647                 return $tables;
648
649         // order
650         $new_tables = array();
651         $existing = array();
652         $modified = true;
653         while (count($tables) && $modified == true)
654         {
655                 $modified = false;
656             foreach ($tables as $key=>$row)
657             {
658                 // delete from $tables and add to $new_tables
659                 if (isset($fks[$row['Name']]))
660                 {
661                         foreach($fks[$row['Name']] as $needed)
662                         {
663                         // go to next table if not all needed tables exist in $existing
664                         if (!in_array($needed,$existing))
665                                 continue 2;
666                     }
667                 }
668             // delete from $tables and add to $new_tables
669                 $existing[] = $row['Name'];
670                         $new_tables[] = $row;
671             prev($tables);
672             unset($tables[$key]);
673             $modified = true;
674
675             }
676         }
677
678         if (count($tables))
679         {
680             // probably there are 'circles' in the constraints, bacause of that no proper backups can be created yet
681             // TODO: this will be fixed sometime later through using 'alter table' commands to add the constraints after generating the tables
682             // until now, just add the lasting tables to $new_tables, return them and print a warning
683             foreach($tables as $row)
684                 $new_tables[] = $row;
685             echo "<div class=\"red_left\">THIS DATABASE SEEMS TO CONTAIN 'RING CONSTRAINTS'. WA DOES NOT SUPPORT THEM. PROBABLY THE FOLOWING BACKUP IS DEFECT!</div>";
686         }
687         return $new_tables;
688 }
689
690 // saves the string in $fileData to the file $backupfile as gz file or not ($zip)
691 // returns backup file name if name has changed (zip), else TRUE. If saving failed, return value is FALSE
692 function save_to_file($path, $zip, $fileData)
693 {
694         global $path_to_root;
695
696         $backupfile = basename($path);
697
698     if ($zip == "gzip")
699     {
700         if ($zp = @gzopen($path, "a9"))
701         {
702                         @gzwrite($zp, $fileData);
703                         @gzclose($zp);
704                         return true;
705         }
706         else
707         {
708                 return false;
709         }
710
711     // $zip contains the timestamp
712     }
713     elseif ($zip == "zip")
714     {
715         // based on zip.lib.php 2.2 from phpMyBackupAdmin
716         // offical zip format: http://www.pkware.com/appnote.txt
717
718         // End of central directory record
719         $eof_ctrl_dir = "\x50\x4b\x05\x06\x00\x00\x00\x00";
720
721         // "local file header" segment
722         $unc_len = strlen($fileData);
723         $crc = crc32($fileData);
724         $zdata = gzcompress($fileData);
725
726                 // extend stored file name with suffix
727         // needed for decoding (because of crc bug)
728         $name_suffix = substr($zdata, -4, 4);
729         $name_suffix2 = "_";
730         for ($i = 0; $i < 4; $i++)
731                 $name_suffix2 .= sprintf("%03d", ord($name_suffix[$i]));
732
733         $name = substr($backupfile, 0, strlen($backupfile) - 8) . $name_suffix2 . ".sql";
734
735         // fix crc bug
736         $zdata = substr(substr($zdata, 0, strlen($zdata) - 4), 2);
737         $c_len = strlen($zdata);
738
739         // dos time
740         $timearray = getdate();
741         $dostime = (($timearray['year'] - 1980) << 25) | ($timearray['mon'] << 21) | ($timearray['mday'] << 16) |
742             ($timearray['hours'] << 11) | ($timearray['minutes'] << 5) | ($timearray['seconds'] >> 1);
743         $dtime = dechex($dostime);
744         $hexdtime = "\x" . $dtime[6] . $dtime[7] . "\x" . $dtime[4].$dtime[5] . "\x" . $dtime[2] . $dtime[3] . "\x" . $dtime[0] . $dtime[1];
745         eval('$hexdtime="' . $hexdtime . '";');
746
747         // ver needed to extract, gen purpose bit flag, compression method, last mod time and date
748         $sub1 = "\x14\x00" . "\x00\x00" . "\x08\x00" . $hexdtime;
749
750         // crc32, compressed filesize, uncompressed filesize
751         $sub2 = pack('V', $crc) . pack('V', $c_len) . pack('V', $unc_len);
752
753         $fr = "\x50\x4b\x03\x04" . $sub1. $sub2;
754
755         // length of filename, extra field length
756         $fr .= pack('v', strlen($name)) . pack('v', 0);
757         $fr .= $name;
758
759         // "file data" segment and "data descriptor" segment (optional but necessary if archive is not served as file)
760         $fr .= $zdata . $sub2;
761
762         // now add to central directory record
763         $cdrec = "\x50\x4b\x01\x02";
764         $cdrec .= "\x00\x00";                // version made by
765         $cdrec .= $sub1 . $sub2;
766
767          // length of filename, extra field length, file comment length, disk number start, internal file attributes, external file attributes - 'archive' bit set, offset
768         $cdrec .= pack('v', strlen($name)) . pack('v', 0) . pack('v', 0) . pack('v', 0) . pack('v', 0) . pack('V', 32) . pack('V',0);
769         $cdrec .= $name;
770
771         // combine data
772         $fileData = $fr . $cdrec . $eof_ctrl_dir;
773
774         // total # of entries "on this disk", total # of entries overall, size of central dir, offset to start of central dir, .zip file comment length
775         $fileData .= pack('v', 1) . pack('v', 1) . pack('V', strlen($cdrec)) . pack('V', strlen($fr)) . "\x00\x00";
776
777         if ($zp = @fopen($path, "a"))
778         {
779                         @fwrite($zp, $fileData);
780                         @fclose($zp);
781                         return true;
782         }
783         else
784         {
785                 return false;
786         }
787
788         // uncompressed
789     }
790     else
791     {
792         if ($zp = @fopen($path, "a"))
793         {
794                         @fwrite($zp, $fileData);
795                         @fclose($zp);
796                         return true;
797         }
798         else
799         {
800                 return false;
801         }
802     }
803 }
804
805 function create_comp_dirs($comp_path, $comp_subdirs)
806 {
807                 $index = "<?php\nheader(\"Location: ../index.php\");\n?>";
808             $cdir = $comp_path;
809             @mkdir($cdir);
810                 $f = @fopen("$cdir/index.php", "wb");
811                 @fwrite($f, $index);
812                 @fclose($f);
813
814             foreach($comp_subdirs as $dir)
815             {
816                         @mkdir($cdir.'/'.$dir);
817                         $f = @fopen("$cdir/$dir/index.php", "wb");
818                         @fwrite($f, $index);
819                         @fclose($f);
820             }
821 }
822
823 //
824 //      Checks $field existence in $table with given field $properties
825 //      $table - table name without prefix
826 //  $field -  optional field name
827 //  $properties - optional properties of field defined by MySQL:
828 //              'Type', 'Null', 'Key', 'Default', 'Extra'
829 //
830 function check_table($pref, $table, $field=null, $properties=null)
831 {
832         $tables = @db_query("SHOW TABLES LIKE '".$pref.$table."'");
833         if (!db_num_rows($tables))
834                 return 1;               // no such table or error
835
836         $fields = @db_query("SHOW COLUMNS FROM ".$pref.$table);
837         if (!isset($field)) 
838                 return 0;               // table exists
839
840         while( $row = db_fetch_assoc($fields)) 
841         {
842                 if ($row['Field'] == $field) 
843                 {
844                         if (!isset($properties)) 
845                                 return 0;
846                         foreach($properties as $property => $value) 
847                         {
848                                 if ($row[$property] != $value) 
849                                         return 3;       // failed type/length check
850                         }
851                         return 0; // property check ok.
852                 }
853         }
854         return 2; // field not found
855 }
856
857 ?>