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