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 ***********************************************************************/
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
21 define('EXPORT_MAX_INSERT', 50000);
23 function array_natsort($aryData, $strIndex, $strSortBy, $strSortType=false)
25 // if the parameters are invalid
26 if (!is_array($aryData) || !$strSortBy)
30 // create our temporary arrays
31 $arySort = $aryResult = array();
33 // loop through the array
34 foreach ($aryData as $key => $aryRow)
35 // set up the value in the array
36 $arySort[$strIndex ? $aryRow[$strIndex] : $key] = $aryRow[$strSortBy];
38 // apply the natural sort
41 // if the sort type is descending
42 if ($strSortType=="desc")
46 // loop through the sorted and original data
47 foreach ($arySort as $arySortKey => $arySorted)
50 foreach ($aryData as $aryOriginal)
52 if ($aryOriginal[$strIndex]==$arySortKey)
53 // add it to the output array
54 array_push($aryResult, $aryOriginal);
56 $aryResult[$arySortKey] = $aryData[$arySortKey];
61 function update_admin_password($conn, $password)
63 $sql = "UPDATE ".$conn['tbpref']."users SET password=".db_escape($password) . "
64 WHERE user_id='admin'";
65 db_query($sql, "could not update user password for 'admin'");
68 function write_config_db($new = false)
70 global $path_to_root, $def_coy, $db_connections, $tb_pref_counter;
74 $n = count($db_connections);
76 $msg .= "/*Connection Information for the database\n";
77 $msg .= "\$def_coy - the default company that is pre-selected on login\n\n";
78 $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";
79 $msg .= "'dbuser' - the user name under which the company database should be accessed.\n";
80 $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";
81 $msg .= "'dbpassword' - the password required for the dbuser to authorise the above database user.\n\n";
82 $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";
83 $msg .= "'tbpref' - prefix on table names, or '' if not used. Always use non-empty prefixes if multiply company use the same database.\n";
86 $msg .= "\$def_coy = " . $def_coy . ";\n\n";
87 $msg .= "\$tb_pref_counter = " . $tb_pref_counter . ";\n\n";
88 $msg .= "\$db_connections = " .var_export($db_connections, true);
91 $filename = $path_to_root . "/config_db.php";
92 // Check if the file exists and is writable first.
93 if ((!file_exists($filename) && is_writable($path_to_root)) || is_writable($filename))
95 if (!$zp = fopen($filename, 'w'))
101 if (!fwrite($zp, $msg))
117 function write_extensions($extensions=null, $company = -1)
119 global $path_to_root, $installed_extensions, $next_extension_id;
121 if (!isset($extensions)) {
122 $extensions = $installed_extensions;
124 if (!isset($next_extension_id)) {
125 $next_extension_id = 1;
131 "/* List of installed additional extensions. If extensions are added to the list manually
132 make sure they have unique and so far never used extension_ids as a keys,
133 and \$next_extension_id is also updated. More about format of this file yo will find in
134 FA extension system documentation.
136 \n\$next_extension_id = $next_extension_id; // unique id for next installed extension\n\n";
140 Do not edit this file manually. This copy of global file is overwritten
141 by extensions editor.
144 $msg .= "\$installed_extensions = ". var_export($extensions, true);
146 $filename = $path_to_root . ($company==-1 ? '' : '/company/'.$company)
147 .'/installed_extensions.php';
149 // Check if the file is writable first.
150 if (!$zp = @fopen($filename, 'w'))
152 display_error(sprintf(_("Cannot open the extension setup file '%s' for writing."),
158 if (!fwrite($zp, $msg))
160 display_error(sprintf(_("Cannot write to the extensions setup file '%s'."),
170 //---------------------------------------------------------------------------------------------
172 // Update per-company list of installed extensions
174 function update_extensions($extensions) {
175 global $db_connections;
177 if (!write_extensions($extensions)) {
178 display_notification(_("Cannot update system extensions list."));
182 // update per company files
183 $cnt = max(1, count($db_connections));
184 for($i = 0; $i < $cnt; $i++)
186 $newexts = $extensions;
187 // update 'active' status
188 $exts = get_company_extensions($i);
189 foreach ($exts as $key => $ext)
191 if (isset($newexts[$key]))
192 $newexts[$key]['active'] = $exts[$key]['active'];
194 if(!write_extensions($newexts, $i))
196 display_notification(sprintf(_("Cannot update extensions list for company '%s'."),
197 $db_connections[$i]['name']));
205 function write_lang()
207 global $path_to_root, $installed_languages, $dflt_lang;
209 $installed_languages = array_natsort($installed_languages, 'code', 'code');
210 $n = count($installed_languages);
213 $msg .= "/* How to make new entries here for non-packaged languages:\n\n";
214 $msg .= "-- 'code' should match the name of the directory for the language under \\lang\n.";
215 $msg .= "-- 'name' is the name that will be displayed in the language selection list (in Users and Display Setup)\n";
216 $msg .= "-- 'rtl' only needs to be set for right-to-left languages like Arabic and Hebrew\n";
217 $msg .= "-- 'encoding' used in translation file\n";
218 $msg .= "-- 'version' always set to '' for manually installed languages.\n";
219 $msg .= "-- 'path' installation path related to FA root (e.g. 'lang/en_US').\n";
222 $msg .= "\$installed_languages = " . var_export($installed_languages, true);
224 $msg .= "\n\$dflt_lang = '$dflt_lang';\n?>\n";
226 $path = $path_to_root . "/lang";
227 $filename = $path.'/installed_languages.inc';
228 // Check if directory exists and is writable first.
229 if (file_exists($path) && is_writable($path))
231 if (!$zp = fopen($filename, 'w'))
233 display_error(_("Cannot open the languages file - ") . $filename);
238 if (!fwrite($zp, $msg))
240 display_error(_("Cannot write to the language file - ") . $filename);
250 display_error(_("The language files folder ") . $path . _(" is not writable. Change its permissions so it is, then re-run the operation."));
257 $filename - sql file name
258 $connection - database connection
259 $force - ignore duplicate errors
260 $init - presume $filename is initialization file with '0_' prefix
261 $protect - protect users/roles
262 $return_errors - return errors instead of display them
264 function db_import($filename, $connection, $force=true, $init=true, $protect=false, $return_errors=false)
266 global $db, $go_debug, $sql_trail;
270 $allowed_commands = array(
271 "create" => 'table_queries',
272 "delimiter" => 'table_queries',
273 "alter table" => 'table_queries',
274 "insert" => 'data_queries',
275 "update" => 'data_queries',
276 "set names" => 'set_names',
277 "drop table if exists" => 'drop_queries',
278 "drop function if exists" => 'drop_queries',
279 "drop trigger if exists" => 'drop_queries',
287 $ignored_mysql_errors = array( //errors ignored in normal (non forced) mode
288 '1022', // duplicate key
289 '1050', // Table %s already exists
290 '1060', // duplicate column name
291 '1061', // duplicate key name
292 '1062', // duplicate key entry
293 '1091' // can't drop key/column check if exists
296 $set_names = array();
297 $data_queries = array();
298 $drop_queries = array();
299 $table_queries = array();
300 $sql_errors = array();
302 $old_encoding = mysql_client_encoding();
304 ini_set("max_execution_time", "180");
305 db_query("SET foreign_key_checks=0");
306 // uncrompress gziped backup files
307 if (strpos($filename, ".gz") || strpos($filename, ".GZ"))
308 $lines = db_ungzip("lines", $filename);
309 elseif (strpos($filename, ".zip") || strpos($filename, ".ZIP"))
310 $lines = db_unzip("lines", $filename);
312 $lines = file("". $filename);
318 foreach($lines as $line_no => $line)
323 $line = str_replace("0_", $connection["tbpref"], $line);
325 if ($query_table == '')
326 { // check if line begins with one of allowed queries
327 foreach($allowed_commands as $cmd => $table)
329 if (strtolower(substr($line, 0, strlen($cmd))) == $cmd)
331 if ($cmd == 'delimiter') {
332 $delimiter = trim(substr($line, 10));
335 $query_table = $table;
339 foreach($protected as $protbl)
340 if (strpos($line, $connection["tbpref"].$protbl) !== false)
346 ${$query_table}[] = array('', $line_no+1);
351 if($query_table != '') // inside allowed query
353 $table = $query_table;
355 if (substr($line, -strlen($delimiter)) == $delimiter) // end of query found
357 $line = substr($line, 0, strlen($line) - strlen($delimiter)); // strip delimiter
361 ${$table}[count(${$table}) - 1][0] .= $line . "\n";
367 // 'set names' or equivalents should be used only on post 2.3 FA versions
368 // otherwise text encoding can be broken during import
370 $encoding = null; // UI encoding for default site language is the default
371 $new_db = $init || db_fixed();
372 $new_file = count($set_names);
377 if (count($set_names)) // standard db restore
379 if (preg_match('/set\s*names\s*[\']?(\w*)[\']?/i', $set_names[0][0], $match))
380 $encoding = $match[1];
382 // otherwise use default site ui encoding
387 if ($new_file) // import on old db is forbidden: this would destroy db content unless latin1 was used before in UI
389 $msg = _("This is new format backup file which cannot be restored on database not migrated to utf8.");
396 else // backup restore during upgrade failure
397 $encoding = 'latin1'; // standard encoding on mysql client
400 mysql_set_charset($encoding);
402 /*/ { // for debugging purposes
403 global $path_to_root;
404 $f = fopen($path_to_root.'/tmp/dbimport.txt', 'w+');
405 fwrite($f, print_r($set_names,true) ."\n");
406 fwrite($f, print_r($drop_queries,true) ."\n");
407 fwrite($f, print_r($table_queries,true) ."\n");
408 fwrite($f, print_r($data_queries,true));
413 { // prevent errors display
414 $save_debug = $go_debug;
417 // execute drop tables if exists queries
418 if (is_array($drop_queries))
420 foreach($drop_queries as $drop_query)
422 if (!db_query($drop_query[0]))
424 if (!in_array(db_error_no(), $ignored_mysql_errors) || !$force)
425 $sql_errors[] = array(db_error_msg($db), $drop_query[1]);
430 // execute create tables queries
431 if (is_array($table_queries))
433 foreach($table_queries as $table_query)
435 if (!db_query($table_query[0]))
437 if (!in_array(db_error_no(), $ignored_mysql_errors) || !$force) {
438 $sql_errors[] = array(db_error_msg($db), $table_query[1]);
444 // execute insert data queries
445 if (is_array($data_queries))
447 foreach($data_queries as $data_query)
449 if (!db_query($data_query[0]))
451 if (!in_array(db_error_no(),$ignored_mysql_errors) || !$force)
452 $sql_errors[] = array(db_error_msg($db), $data_query[1]);
458 $go_debug = $save_debug;
460 db_query("SET foreign_key_checks=1");
461 if ($delimiter != ';') db_query("delimiter ;"); // just for any case
463 mysql_set_charset($old_encoding); // restore connection encoding
465 if (count($sql_errors)) {
469 // display first failure message; the rest are probably derivative
470 $err = $sql_errors[0];
471 display_error(sprintf(_("SQL script execution failed in line %d: %s"),
478 // returns the content of the gziped $path backup file. use of $mode see below
479 function db_ungzip($mode, $path)
481 $file_data = gzfile($path);
482 // returns one string or an array of lines
483 if ($mode != "lines")
484 return implode("",$file_data);
489 // returns the content of the ziped $path backup file. use of $mode see below
490 function db_unzip($mode, $path)
493 $all = implode("", file($path));
495 // convert path to name of ziped file
496 $filename = preg_replace("/.*\//", "", $path);
497 $filename = substr($filename, 0, strlen($filename) - 4);
499 // compare filname in zip and filename from $_GET
500 if (substr($all, 30, strlen($filename)-4) . substr($all, 30+strlen($filename)+9, 4)
502 return ''; // exit if names differ
506 // get the suffix of the filename in hex
507 $crc_bugfix = substr($all, 30, strlen($filename)+13);
508 $crc_bugfix = substr(substr($crc_bugfix, 0, strlen($crc_bugfix) - 4),
509 strlen($crc_bugfix) - 12 - 4);
511 // convert hex to ascii
512 for ($i=0; $i < 12; )
513 $suffix .= chr($crc_bugfix[$i++] . $crc_bugfix[$i++] . $crc_bugfix[$i++]);
515 // remove central directory information (we have always just one ziped file)
516 $comp = substr($all, -(strlen($all) - 30 - strlen($filename)-13));
517 $comp = substr($comp, 0, (strlen($comp) - 80 - strlen($filename)-13));
519 // fix the crc bugfix (see function save_to_file)
520 $comp = "x
\9c" . $comp . $suffix;
521 $file_data = gzuncompress($comp);
524 // returns one string or an array of lines
525 if ($mode != "lines")
528 return explode("\n", $file_data);
531 function db_backup($conn, $ext='no', $comm='', $path=null)
533 if ($conn['tbpref'] != "")
534 $filename = $conn['dbname'] . "_" . $conn['tbpref'] . date("Ymd_Hi") . ".sql";
536 $filename = $conn['dbname'] . "_" . date("Ymd_Hi") . ".sql";
541 return db_export($conn, $path . clean_file_name($filename), $ext, $comm);
544 // Generates a dump of $db database
546 function db_export($conn, $filename, $zip='no', $comment='')
549 global $app_title, $version, $power_url, $path_to_root;
552 // set max string size before writing to file
553 $max_size = 1048576 * 2; // 2 MB
554 // changes max size if value can be retrieved
555 if (ini_get("memory_limit"))
556 $max_size = 900000 * ini_get("memory_limit");
558 // set backupfile name
560 $backupfile = $filename . ".gz";
561 elseif ($zip == "zip")
562 $backupfile = $filename . ".zip";
564 $backupfile = $filename;
565 $company = $conn['name']; // get_company_pref('coy_name');
567 if (file_exists($backupfile)) // prevent appends
571 $out="# MySQL dump of database '".$conn["dbname"]."' on host '".$conn["host"]."'\n";
572 $out.="# Backup Date and Time: ".date("Y-m-d H:i")."\n";
573 $out.="# Built by " . $app_title . " " . $version ."\n";
574 $out.="# ".$power_url."\n";
575 $out.="# Company: ". @html_entity_decode($company, ENT_QUOTES, $_SESSION['language']->encoding)."\n";
576 $out.="# User: ".$_SESSION["wa_current_user"]->name."\n\n";
577 $out.="# Compatibility: ".get_company_pref('version_id')."\n\n";
579 // write users comment
582 $out .= "# Comment:\n";
583 $comment=preg_replace("'\n'","\n# ","# ".$comment);
584 //$comment=str_replace("\n", "\n# ", $comment);
585 foreach(explode("\n",$comment) as $line)
590 //$out.="use ".$db.";\n"; we don't use this option.
595 if ($mysql_enc = get_mysql_encoding_name($_SESSION['language']->encoding))
596 $out .= "\nSET NAMES $mysql_enc;\n";
598 // get auto_increment values and names of all tables
599 $res = db_query("show table status");
600 $all_tables = array();
601 while($row = db_fetch($res))
603 if (($conn["tbpref"] == "" && !preg_match('/[0-9]+_/', $row['Name'])) ||
604 ($conn["tbpref"] != "" && strpos($row['Name'], $conn["tbpref"]) === 0))
605 $all_tables[] = $row;
607 // get table structures
608 foreach ($all_tables as $table)
610 $res1 = db_query("SHOW CREATE TABLE `" . $table['Name'] . "`");
611 $tmp = db_fetch($res1);
612 $table_sql[$table['Name']] = $tmp["Create Table"];
617 if (isset($table_sql))
619 foreach($table_sql as $tablenme=>$table)
622 // save all tables, needed for creating this table in $fks
623 while (($ref_pos = strpos($tmp_table, " REFERENCES ")) > 0)
625 $tmp_table = substr($tmp_table, $ref_pos + 12);
626 $ref_pos = strpos($tmp_table, "(");
627 $fks[$tablenme][] = substr($tmp_table, 0, $ref_pos);
632 $all_tables = order_sql_tables($all_tables, $fks);
634 // as long as no error occurred
637 foreach ($all_tables as $row)
639 $tablename = $row['Name'];
640 $auto_incr[$tablename] = $row['Auto_increment'];
644 $out.="### Structure of table `".$tablename."` ###\n\n";
646 $out.="DROP TABLE IF EXISTS `".$tablename."`;\n\n";
647 $out.=$table_sql[$tablename];
649 // add auto_increment value
650 // if ($auto_incr[$tablename])
651 // $out.=" AUTO_INCREMENT=".$auto_incr[$tablename];
658 $out.="### Data of table `".$tablename."` ###\n";
660 // check if field types are NULL or NOT NULL
661 $res3 = db_query("SHOW COLUMNS FROM `" . $tablename . "`");
663 $field_null = array();
664 for ($j = 0; $j < db_num_rows($res3); $j++)
666 $row3 = db_fetch($res3);
667 $field_null[] = $row3[2]=='YES' && $row3[4]===null;
670 $res2 = db_query("SELECT * FROM `" . $tablename . "`");
673 for ($j = 0; $j < db_num_rows($res2); $j++)
675 $row2 = db_fetch_row($res2);
677 for ($k = 0; $k < $nf = db_num_fields($res2); $k++)
679 $values .= db_escape($row2[$k], $field_null[$k]);
684 $len = strlen($values);
685 if ($maxinsert < $len+1)
687 $maxinsert = EXPORT_MAX_INSERT;
690 $out .= $insert .';'; // flush insert query
697 $insert = "\nINSERT INTO `" . $tablename . "` VALUES\n";
698 $maxinsert -= strlen($insert);
706 // if saving is successful, then empty $out, else set error flag
707 if (strlen($out) > $max_size && $zip != "zip")
709 if (save_to_file($backupfile, $zip, $out))
716 $out .= $insert. ';';
717 // an error occurred! Try to delete file and return error status
721 @unlink($backupfile);
725 // if saving is successful, then empty $out, else set error flag
726 if (strlen($out) > $max_size && $zip != "zip")
728 if (save_to_file($backupfile, $zip, $out))
735 // an error occurred! Try to delete file and return error status
739 @unlink($backupfile);
745 if (save_to_file($backupfile, $zip, $out))
751 @unlink($backupfile);
757 // orders the tables in $tables according to the constraints in $fks
758 // $fks musst be filled like this: $fks[tablename][0]=needed_table1; $fks[tablename][1]=needed_table2; ...
759 function order_sql_tables($tables, $fks)
761 // do not order if no contraints exist
766 $new_tables = array();
769 while (count($tables) && $modified == true)
772 foreach ($tables as $key=>$row)
774 // delete from $tables and add to $new_tables
775 if (isset($fks[$row['Name']]))
777 foreach($fks[$row['Name']] as $needed)
779 // go to next table if not all needed tables exist in $existing
780 if (!in_array($needed,$existing))
784 // delete from $tables and add to $new_tables
785 $existing[] = $row['Name'];
786 $new_tables[] = $row;
788 unset($tables[$key]);
796 // probably there are 'circles' in the constraints, bacause of that no proper backups can be created yet
797 // TODO: this will be fixed sometime later through using 'alter table' commands to add the constraints after generating the tables
798 // until now, just add the lasting tables to $new_tables, return them and print a warning
799 foreach($tables as $row)
800 $new_tables[] = $row;
801 echo "<div class=\"red_left\">THIS DATABASE SEEMS TO CONTAIN 'RING CONSTRAINTS'. WA DOES NOT SUPPORT THEM. PROBABLY THE FOLOWING BACKUP IS DEFECT!</div>";
806 // saves the string in $fileData to the file $backupfile as gz file or not ($zip)
807 // returns backup file name if name has changed (zip), else TRUE. If saving failed, return value is FALSE
808 function save_to_file($path, $zip, $fileData)
810 global $path_to_root;
812 $backupfile = basename($path);
816 if ($zp = @gzopen($path, "a9"))
818 @gzwrite($zp, $fileData);
827 // $zip contains the timestamp
829 elseif ($zip == "zip")
831 // based on zip.lib.php 2.2 from phpMyBackupAdmin
832 // offical zip format: http://www.pkware.com/appnote.txt
834 // End of central directory record
835 $eof_ctrl_dir = "\x50\x4b\x05\x06\x00\x00\x00\x00";
837 // "local file header" segment
838 $unc_len = strlen($fileData);
839 $crc = crc32($fileData);
840 $zdata = gzcompress($fileData);
842 // extend stored file name with suffix
843 // needed for decoding (because of crc bug)
844 $name_suffix = substr($zdata, -4, 4);
846 for ($i = 0; $i < 4; $i++)
847 $name_suffix2 .= sprintf("%03d", ord($name_suffix[$i]));
849 $name = substr($backupfile, 0, strlen($backupfile) - 8) . $name_suffix2 . ".sql";
852 $zdata = substr(substr($zdata, 0, strlen($zdata) - 4), 2);
853 $c_len = strlen($zdata);
856 $timearray = getdate();
857 $dostime = (($timearray['year'] - 1980) << 25) | ($timearray['mon'] << 21) | ($timearray['mday'] << 16) |
858 ($timearray['hours'] << 11) | ($timearray['minutes'] << 5) | ($timearray['seconds'] >> 1);
859 $dtime = dechex($dostime);
860 $hexdtime = "\x" . $dtime[6] . $dtime[7] . "\x" . $dtime[4].$dtime[5] . "\x" . $dtime[2] . $dtime[3] . "\x" . $dtime[0] . $dtime[1];
861 eval('$hexdtime="' . $hexdtime . '";');
863 // ver needed to extract, gen purpose bit flag, compression method, last mod time and date
864 $sub1 = "\x14\x00" . "\x00\x00" . "\x08\x00" . $hexdtime;
866 // crc32, compressed filesize, uncompressed filesize
867 $sub2 = pack('V', $crc) . pack('V', $c_len) . pack('V', $unc_len);
869 $fr = "\x50\x4b\x03\x04" . $sub1. $sub2;
871 // length of filename, extra field length
872 $fr .= pack('v', strlen($name)) . pack('v', 0);
875 // "file data" segment and "data descriptor" segment (optional but necessary if archive is not served as file)
876 $fr .= $zdata . $sub2;
878 // now add to central directory record
879 $cdrec = "\x50\x4b\x01\x02";
880 $cdrec .= "\x00\x00"; // version made by
881 $cdrec .= $sub1 . $sub2;
883 // length of filename, extra field length, file comment length, disk number start, internal file attributes, external file attributes - 'archive' bit set, offset
884 $cdrec .= pack('v', strlen($name)) . pack('v', 0) . pack('v', 0) . pack('v', 0) . pack('v', 0) . pack('V', 32) . pack('V',0);
888 $fileData = $fr . $cdrec . $eof_ctrl_dir;
890 // total # of entries "on this disk", total # of entries overall, size of central dir, offset to start of central dir, .zip file comment length
891 $fileData .= pack('v', 1) . pack('v', 1) . pack('V', strlen($cdrec)) . pack('V', strlen($fr)) . "\x00\x00";
893 if ($zp = @fopen($path, "w"))
895 @fwrite($zp, $fileData);
908 if ($zp = @fopen($path, "a"))
910 @fwrite($zp, $fileData);
921 function create_comp_dirs($comp_path, $comp_subdirs)
923 $index = "<?php\nheader(\"Location: ../index.php\");\n?>";
926 $f = @fopen("$cdir/index.php", "wb");
930 foreach($comp_subdirs as $dir)
932 @mkdir($cdir.'/'.$dir);
933 $f = @fopen("$cdir/$dir/index.php", "wb");
940 // Checks $field existence in $table with given field $properties
941 // $table - table name without prefix
942 // $field - optional field name
943 // $properties - optional properties of field defined by MySQL:
944 // 'Type', 'Null', 'Key', 'Default', 'Extra'
946 function check_table($pref, $table, $field=null, $properties=null)
948 $tables = @db_query("SHOW TABLES LIKE '".$pref.$table."'");
949 if (!db_num_rows($tables))
950 return 1; // no such table or error
952 $fields = @db_query("SHOW COLUMNS FROM ".$pref.$table);
954 return 0; // table exists
956 while( $row = db_fetch_assoc($fields))
958 if ($row['Field'] == $field)
960 if (!isset($properties))
962 foreach($properties as $property => $value)
964 if ($row[$property] != $value)
965 return 3; // failed type/length check
967 return 0; // property check ok.
970 return 2; // field not found
974 Update or create setting in simple php config file.
976 function update_config_var($file, $variable, $value, $comment='')
978 if (!is_file($file) || !is_writeable($file))
980 $content = file_get_contents($file);
981 $strvalue = '$'."$variable = ".var_export($value, true).';';
982 $pattern = '/'.preg_quote('$'.$variable).'\s*=\s*[^;]*;/m';
983 $content = preg_replace($pattern, $strvalue, $content, -1, $result);
986 $strvalue = ($comment ? "// $comment" : '') ."\n$strvalue\n";
987 $content = preg_replace('/\?>\s*/m', $strvalue, $content, -1, $result);
989 $content .= $strvalue;
992 return file_put_contents($file, $content)!=false;