2 /**********************************************************************
3 Copyright (C) FrontAccounting, LLC.
4 Released under the terms of the GNU General Public License, GPL,
5 as published by the Free Software Foundation, either version 3
6 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 include_once($path_to_root. "/includes/archive.inc");
13 include_once($path_to_root. "/includes/remote_url.inc");
14 include_once($path_to_root. "/includes/hooks.inc");
16 define('PKG_CACHE_PATH', $path_to_root.'/modules/_cache');
17 define('PUBKEY_PATH', $path_to_root);
19 // FrontAccounting package class
21 class package extends gzip_file {
22 function package($filename, $basedir=null)
27 $basedir = PKG_CACHE_PATH.'/'.substr(basename($filename), 0, -4);
28 if (file_exists($basedir)) {
29 // flush_dir($basedir, true);
33 $this->archive($filename);
34 $this->set_options(array('basedir'=> $basedir));
35 $this->options['type'] = "pkg";
38 // Used by archive class. Use create_archive() instead.
42 return $this->create_gzip();
45 // Install package and clean temp directory.
53 $this->set_options(array('overwrite' => 1));
54 $this->extract_files(); // extract package in cache directory
55 $cachepath = $this->options['basedir'];
56 $ctrl = get_control_file("$cachepath/_init/config");
58 $targetdir = $path_to_root.'/'.$ctrl['InstallPath'];
60 if (!is_dir($targetdir))
63 $dpackage = new package("$cachepath/_data", $targetdir);
64 $dpackage->set_options(array('overwrite' => 1));
66 $flist = $dpackage->extract_files(true);
67 if (count($dpackage->error)) {
68 $this->error = array_merge($this->error, $dpackage->error);
71 copy_files($flist, $targetdir, "$cachepath/_back");
73 $dpackage->extract_files(); //install package in target directory
75 $install = hook_invoke($ctrl['Package'], 'install_extension', $dummy);
76 $success &= $install===null || $install;
77 $success &= count($dpackage->error) == 0;
78 $this->error = array_merge($this->error, $dpackage->error);
82 // Removing package related sources
90 $cachepath = $this->options['basedir'];
91 $ctrl = get_control_file("$cachepath/_init/config");
93 $targetdir = $path_to_root.'/'.$ctrl['InstallPath'];
95 $dpackage = new package("$cachepath/_data", $targetdir);
97 $flist = $dpackage->extract_files(true);
99 $success &= copy_files($flist, "$cachepath/_back", $targetdir, true);
101 if (strpos($ctrl['InstallPath'], 'modules/') === 0) { // flush module directory
102 flush_dir($targetdir, true);
106 $uninstall = hook_invoke($ctrl['Package'], 'uninstall_extension', $dummy);
107 $success &= $uninstall===null || $uninstall;
112 // Purge all package related configuration and data.
121 // Changes field value read from control file (single, or multiline) into
122 // arrays of subfields if needed.
124 function ufmt_property($key, $value)
126 // indexes used in output arrays
128 // 'MenuTabs' => array('url', 'access', 'tab_id', 'title', 'section'),
129 // 'MenuEntries' => array('url', 'access', 'tab_id', 'title'),
131 if (!isset($sub_fields[$key]))
132 return $value==='' ? null : $value;
136 if (!is_array($value))
137 $value = array($value);
138 foreach($value as $line) {
139 $indexes = $sub_fields[$key];
141 preg_match_all('/(["])(?:\\\\?+.)*?\1|[^"\s][\S]*/', $line, $match);
142 foreach($match[0] as $n => $subf) {
144 $val = strtr(substr($subf, 1, -1),
149 $ret[array_shift($indexes)] = $val;
158 //=============================================================================
160 // Retrieve control file and return as associative array
161 // $index is name of field used as key in result array, or null for numeric keys
163 function get_control_file($file, $index = false) {
165 $list = gzopen($file, 'rb');
166 if (!$list) return null;
168 $repo = $pkg = array();
169 $key = false; $value = '';
172 $line = rtrim($line);
173 if ($line && ctype_space($line[0])) { // continuation of multiline property
174 if (strlen(ltrim($line))) {
175 if ($value !== '' && !is_array($value))
176 $value = array($value);
177 $value[] = ltrim($line);
181 if ($key) { // save previous property if any
182 $pkg[$key] = ufmt_property($key, $value);
184 if (!strlen($line)) { // end of section
186 if ($index !== true) {
187 if ($index === false) break;
188 if (!isset($pkg[$index])) {
189 display_error(sprintf(_("No key field '%s' in file '%s'"), $index, $file));
192 $repo[$pkg[$index]] = $pkg;
197 $key = null; $value = '';
199 } elseif (preg_match('/([^:]*):\s*(.*)/', $line, $m)) {
200 $key = $m[1]; $value = $m[2];
202 display_error("Empty key in line $line");
206 display_error("File parse error in line $line");
210 } while ((($line = fgets($list))!==false) || $key);
213 return $index === false ? $pkg : $repo;
216 // Save configuration data to control file.
218 function save_control_file($fname, $list, $zip=false)
220 $file = $zip ? gzopen($fname, 'wb') : fopen($fname, 'wb');
221 foreach($list as $section) {
222 foreach($section as $key => $value) {
223 if (is_array($value)) { // multiline value
224 if (is_array(reset($value))) { // lines have subfields
225 foreach($value as $i => $line) {
226 // Subfields containing white spaces or double quotes are doublequoted
227 // with " escaped with backslash.
228 foreach($line as $n => $subfield)
229 if (preg_match('/[\s"]/', $subfield)) {
231 '"'.strtr($subfield, array('"'=>'\\"')).'"';
233 // Subfields are separated by white space.
234 $value[$i] = implode(' ', $value[$i]);
237 // array elements on subsequent lines starting with white space
238 $value = implode("\n ", $value);
240 $zip ? gzwrite($file, "$key: $value\n") : fwrite($file, "$key: $value\n");
242 $zip ? gzwrite($file, "\n"): fwrite($file, "\n");
244 $zip ? gzclose($file) : fclose($file);
247 // Retrieve text field in localized version or default one
248 // when the localized is not avaialable.
250 function pkg_prop($pkg, $property, $lang=false)
253 if ($lang && isset($pkg[$property.'-'.user_language()]))
254 $prop = @$pkg[$pname];
256 $prop = @$pkg[$property];
258 return is_array($prop) ? implode("\n ",$prop): $prop;
261 // Retrieve list of packages from repository and return as table ($pkgname==null),
262 // or find $pkgname package in repository and optionaly download
264 // $type is type/s of package
265 // $filter is optional field selection array in form field=>newkey
266 // or (0=>field1, 1=>field2...)
267 // $outkey - field used as a key in package list. If null 'Package' field is used.
269 function get_pkg_or_list($type = null, $pkgname = null, $filter=array(), $outkey=null, $download=true) {
271 global $path_to_root, $repo_auth;
273 $repo = (isset($repo_auth['scheme']) ? $repo_auth['scheme'] : 'http://')
274 .(isset($repo_auth['login']) ? $repo_auth['login'].':' : '')
275 .(isset($repo_auth['pass']) ? $repo_auth['pass'].'@' : '')
276 .(isset($repo_auth['host']) ? $repo_auth['host'].'/' : '')
277 .(isset($repo_auth['path']) ? $repo_auth['path'].'/' : '')
278 .$repo_auth['branch'];
280 // first download local copy of repo release file
281 // and check remote signature with local copy of public key
283 $loclist = PKG_CACHE_PATH.'/Release.gz';
284 $target_dir = $download==true ? "$path_to_root/tmp/" : $download;
286 if (isset($type) && !is_array($type)) {
287 $type = array($type);
291 if (!file_exists($loclist)) {
292 if (!url_copy($repo.'/Release.gz', $loclist))
294 display_error(_("Cannot download repo index file." ));
299 $sig = url_get_contents($repo.'/Release.sig');
300 $data = file_get_contents($loclist);
301 $cert = file_get_contents(PUBKEY_PATH.'/FA.pem');
302 if (openssl_verify($data, $sig, $cert) <= 0) {
304 if (!@unlink($loclist))
306 display_error(sprintf(_("Cannot delete outdated '%s' file."), $loclist));
310 display_error(_('Release file in repository is invalid, or public key is outdated.'));
318 $Release = get_control_file($loclist, 'Filename');
319 // download and check all indexes containing given package types
320 // then complete package list or seek for pkg
322 foreach($Release as $fname => $parms) {
323 if ($type && !count(array_intersect(explode(' ', $parms['Type']), $type))) {
324 unset($Release[$fname]); continue; // no packages of selected type in this index
326 if ($Release[$fname]['Version'] != $repo_auth['branch']) {
327 display_warning(_('Repository version does not match application version.')); // ?
329 $remoteindex = $repo.'/'.$fname;
330 $locindex = PKG_CACHE_PATH.'/'.$fname;
333 if (!file_exists($locindex)) {
334 if (!url_copy($remoteindex, $locindex)) {
335 display_error(sprintf(_("Cannot download '%s' file." ), $fname));
340 if ($parms['SHA1sum'] != sha1_file($locindex)) { // check subdir index consistency
342 if (!@unlink($locindex)) {
343 display_error(sprintf(_("Cannot delete outdated '%s' file."), $locindex));
347 display_error(sprintf( _("Security alert: broken index file in repository '%s'. Please inform repository administrator about this issue."),
355 // scan subdir list and select packages of given type
356 $pkglist = get_control_file($locindex, 'Package');
357 foreach($pkglist as $name => $pkg) {
358 $pkgfullname = $repo.'/'.$parms['Path']."/".$pkg['Filename'].'.pkg';
359 if (!isset($type) || in_array($pkg['Type'], $type)) {
363 foreach($filter as $field => $key) {
364 if (is_numeric($field))
365 $p[$field] = @$pkg[$field];
367 $p[$key] = @$pkg[$field];
370 if ($pkgname == null) {
371 $Packages[$outkey ? $outkey : $name] = $p;
372 } elseif ($pkgname == $pkg['Package']) {
373 //download package to temp directory
375 $locname = $target_dir.$pkg['Filename'].'.pkg';
376 if (!url_copy($pkgfullname, $locname)) {
377 display_error(sprintf(_("Cannot download '%s' file." ), $pkgfullname));
380 // checking sha1 hash is expensive proces, so chekc the package
381 // consistency just before downloading
382 if ($pkg['SHA1sum'] != sha1_file($locname)) {
383 display_error(sprintf( _("Security alert: broken package '%s' in repository. Please inform repository administrator about this issue."),
397 function get_package($pkgname, $type = null)
399 return get_pkg_or_list($type, $pkgname);
402 Returns full name of installed package, or null if package is not installed.
404 function installed_package($package)
406 $cache = opendir(PKG_CACHE_PATH);
408 while ($file = @readdir($cache)) {
409 if (!is_dir(PKG_CACHE_PATH.'/'.$file))
411 if (strpos($file, $package.'-') === 0)
419 Remove package from system
421 function uninstall_package($name)
423 $name = installed_package($name);
424 if (!$name) return true; // not installed
425 $pkg = new package($name.'.pkg');
428 flush_dir(PKG_CACHE_PATH.'/'.$name, true);
429 rmdir(PKG_CACHE_PATH.'/'.$name);
431 return count($pkg->error)==0;
434 //---------------------------------------------------------------------------------------
436 // Return merged list of available and installed languages in inform of local
437 // configuration array supplemented with installed versions information.
439 function get_languages_list()
441 global $installed_languages;
443 $pkgs = get_pkg_or_list('language', null, array(
444 'Package' => 'package',
445 'Version' => 'available',
447 'Language' => 'code',
448 'Encoding' => 'encoding',
450 'Description' => 'Descr',
451 'InstallPath' => 'path'
454 // add/update languages already installed
456 foreach($installed_languages as $id => $l) {
457 $list = array_search_keys($l['code'], $pkgs, 'code'); // get all packages with this code
458 foreach ($list as $name) {
459 if ($l['encoding'] == $pkgs[$name]['encoding']) { // if the same encoding
460 $pkgs[$name]['version'] = @$l['version']; // set installed version
461 $pkgs[$name]['local_id'] = $id; // index in installed_languages
465 $l['local_id'] = $id;
466 if (!isset($l['package']) || $l['package'] == '' || !isset($pkgs[$l['package']]))
469 $pkgs[$l['package']] = array_merge($pkgs[$l['package']], $l);
474 //---------------------------------------------------------------------------------------
476 // Return merged list of available and installed extensions as a local
477 // configuration array supplemented with installed versions information.
479 function get_extensions_list($type = null)
481 global $path_to_root;
483 if (isset($type) || !is_array($type)) {
484 $type = array($type);
487 $pkgs = get_pkg_or_list($type, null, array(
488 'Package' => 'package',
489 'Version' => 'available',
491 'Description' => 'Descr',
493 'DefaultStatus' => 'active',
494 // 'MenuTabs' => 'tabs',
495 // 'MenuEntries' => 'entries',
496 'Encoding' => 'encoding',
497 // 'AccessExtensions' => 'acc_file',
498 'InstallPath' => 'path'
501 // lookup for local extensions
502 $path = $path_to_root.'/modules/';
504 $moddir = opendir($path);
506 while(false != ($fname = readdir($moddir)))
508 if(!in_array($fname, array('.','..','CVS','_cache')) && is_dir($path.$fname))
510 if (!isset($pkgs[$fname]))
511 $pkgs[$fname] = array(
516 'type' => 'extension',
517 'path' => 'modules/'.$fname,
523 // add/update extensions already installed
525 $installed = get_company_extensions();
526 foreach($installed as $extno => $ext) {
527 if (!in_array($ext['type'], $type)) continue;
528 $ext['local_id'] = $extno;
529 // if (!isset($pkgs[$ext['package']]) || $ext['package'] == '')
532 $pkgs[$ext['package']] = array_merge($pkgs[$ext['package']], $ext);
538 // Return merged list of available and installed extensions as a local
539 // configuration array supplemented with installed versions information.
541 function get_themes_list()
543 $pkgs = get_pkg_or_list('theme', null, array(
544 'Package' => 'package',
545 'Version' => 'available',
547 'Description' => 'Descr'
550 // add/update extensions already installed
552 $local = get_company_extensions();
554 foreach($local as $extno => $ext) {
555 if (isset($pkgs[@$ext['package']])) {
556 $ext['local_id'] = $extno;
557 $pkgs[$ext['package']] = array_merge($pkgs[$ext['package']], $ext);
560 // TODO: Add other themes from themes directory
565 //---------------------------------------------------------------------------------------
567 // Return merged list of available and installed COAs as a local
568 // configuration array supplemented with installed versions information.
570 function get_charts_list()
572 $pkgs = get_pkg_or_list('chart', null, array(
573 'Package' => 'package',
574 'Version' => 'available',
576 'Description' => 'Descr',
578 'InstallPath' => 'path',
579 'Encoding' => 'encoding',
583 // add/update default charts
585 $local = get_company_extensions();
587 foreach($local as $extno => $ext) {
588 if ($ext['type'] != 'chart') continue;
589 $ext['local_id'] = $extno;
590 if (!isset($pkgs[$ext['package']]) || $ext['package'] == '')
593 $pkgs[$ext['package']] = array_merge($pkgs[$ext['package']], $ext);
598 //---------------------------------------------------------------------------------------------
599 // Install/update package from repository
601 function install_language($pkg_name)
603 global $path_to_root, $installed_languages, $Ajax;
605 $pkg = get_pkg_or_list('language', $pkg_name);
608 $i = array_search_key($pkg['Language'], $installed_languages, 'code');
610 $i = count($installed_languages);
611 else { // remove another already installed package for this language
612 $old_pkg = @$installed_languages[$i]['package'];
613 if ($old_pkg && ($pkg['Package'] != $old_pkg))
614 uninstall_package($old_pkg);
617 $package = new package("$path_to_root/tmp/".$pkg['Filename'].'.pkg');
618 if ($package->install()) {
620 'name' => $pkg['Name'],
621 'package' => $pkg['Package'],
622 'code' => $pkg['Language'],
623 'encoding' => $pkg['Encoding'],
624 'version' => $pkg['Version'],
625 'path' => $pkg['InstallPath']
627 if ($pkg['RTLDir']=='yes')
629 $installed_languages[$i] = $lang;
630 write_lang($installed_languages);
631 unlink("$path_to_root/tmp/".$pkg['Filename'].'.pkg');
632 $Ajax->activate('lang_tbl');
634 display_error(implode('<br>', $package->error));
638 display_error(sprintf(_("Package '%s' not found."), $pkg_name));
643 //---------------------------------------------------------------------------------------------
644 // Install/update extension or theme package from repository
646 function install_extension($pkg_name)
648 global $path_to_root, $installed_extensions, $next_extension_id, $Ajax, $db_connections;
650 $pkg = get_pkg_or_list(array('extension', 'theme', 'chart'), $pkg_name);
652 $package = new package("$path_to_root/tmp/".$pkg['Filename'].'.pkg');
653 $local_exts = get_company_extensions();
654 if ($package->install()) {
655 $ext_id = array_search_key($pkg['Package'], $local_exts, 'package');
656 if ($ext_id === null)
657 $ext_id = $next_extension_id++;
658 else { // remove another already installed package for this language
659 $old_pkg = $installed_extensions[$ext_id]['package'];
661 uninstall_package($old_pkg);
664 'name' => $pkg['Name'],
665 'package' => $pkg['Package'],
666 'version' => $pkg['Version'],
667 'type' => $pkg['Type'],
668 'active' => @$pkg['DefaultStatus'] == 'active' ? true : false,
669 'path' => $pkg['InstallPath'],
671 // if (isset($pkg['MenuTabs']))
672 // $ext['tabs'] = $pkg['MenuTabs'];
673 // if (isset($pkg['MenuEntries']))
674 // $ext['entries'] = $pkg['MenuEntries'];
675 // if (isset($pkg['AccessExtensions']))
676 // $ext['acc_file'] = $pkg['AccessExtensions'];
677 if (isset($pkg['SqlScript']))
678 $ext['sql'] = $pkg['SqlScript'];
680 $local_exts[$ext_id] = $ext;
681 $ret = update_extensions($local_exts);
683 if (($ext['active'] == true) && file_exists($path_to_root.'/'.$ext['path'].'/hooks.php'))
685 // we need to include the new hooks file to activate extension
686 include_once($path_to_root.'/'.$ext['path'].'/hooks.php');
687 foreach($db_connections as $comp => $db)
688 activate_hooks($ext['package'], $comp);
691 unlink("$path_to_root/tmp/".$pkg['Filename'].'.pkg');
692 $Ajax->activate('ext_tbl');
695 display_error(implode('<br>', $package->error));
699 display_error(sprintf(_("Package '%s' not found."), $pkg_name));
705 Returns true if newer package version is available
707 function check_pkg_upgrade($current, $available)
709 preg_match_all('/[\d]+/', $available, $aver);
710 if (!count($aver[0]))
712 preg_match_all('/[\d]+/', $current, $cver);
713 if (!count($cver[0]))
715 foreach($aver[0] as $n => $ver)
716 if ($ver>@$cver[0][$n])
722 // Returns package info from index file
724 function get_package_info($pkg, $type=null, $filter=array(), $outkey=null, $download=true) {
725 return get_pkg_or_list($type, $pkg, $filter, null, false);