seeddms-code/inc/inc.ClassExtensionMgr.php

509 lines
14 KiB
PHP

<?php
/**
* Implementation of an extension management.
*
* SeedDMS can be extended by extensions. Extension usually implement
* hook.
*
* @category DMS
* @package SeedDMS
* @license GPL 2
* @version @version@
* @author Uwe Steinmann <uwe@steinmann.cx>
* @copyright 2011 Uwe Steinmann
* @version Release: @package_version@
*/
/**
* Class to represent an extension manager
*
* This class provides some very basic methods to manage extensions.
*
* @category DMS
* @package SeedDMS
* @author Markus Westphal, Malcolm Cowe, Uwe Steinmann <uwe@steinmann.cx>
* @copyright 2011 Uwe Steinmann
* @version Release: @package_version@
*/
class SeedDMS_Extension_Mgr {
/**
* @var string $extdir directory where extensions are located
* @access protected
*/
protected $extdir;
/**
* @var string $reposurl url for fetching list of extensions in repository
* @access protected
*/
protected $reposurl;
/**
* @var array[] $extconf configuration of all extensions
* @access protected
*/
protected $extconf;
/**
* @var string $cachedir directory where cached extension configuration
* is stored
* @access protected
*/
protected $cachedir;
/**
* @var string[] $errmsg list of error message from last operation
* @access protected
*/
protected $errmsgs;
/*
* Name of json file containg available extension from repository
*/
const repos_list_file = 'repository.json';
/**
* Compare two version
*
* This functions compares two version in the format x.x.x with x being
* an integer
*
* @param string $ver1
* @param string $ver2
* @return int -1 if $ver1 < $ver2, 0 if $ver1 == $ver2, 1 if $ver1 > $ver2
*/
static public function cmpVersion($ver1, $ver2) { /* {{{ */
$tmp1 = explode('.', $ver1);
$tmp2 = explode('.', $ver2);
if(intval($tmp1[0]) < intval($tmp2[0])) {
return -1;
} elseif(intval($tmp1[0]) > intval($tmp2[0])) {
return 1;
} else {
if(intval($tmp1[1]) < intval($tmp2[1])) {
return -1;
} elseif(intval($tmp1[1]) > intval($tmp2[1])) {
return 1;
} else {
if(intval($tmp1[2]) < intval($tmp2[2])) {
return -1;
} elseif(intval($tmp1[2]) > intval($tmp2[2])) {
return 1;
} else {
return 0;
}
}
}
} /* }}} */
/**
* Constructor of extension manager
*
* Reads the configuration of all extensions and creates the
* configuration file if it does not exist and the extension dir
* is given
*/
public function __construct($extdir = '', $cachedir = '', $reposurl = '') { /* {{{ */
$this->cachedir = $cachedir;
$this->extdir = $extdir;
$this->reposurl = $reposurl;
$this->extconf = array();
if($extdir) {
if(!file_exists($this->getExtensionsConfFile())) {
$this->createExtensionConf();
}
include($this->getExtensionsConfFile());
if(!empty($EXT_CONF)) {
$this->extconf = $EXT_CONF;
}
}
} /* }}} */
protected function getExtensionsConfFile() { /* {{{ */
return $this->cachedir."/extensions.php";
} /* }}} */
/**
* Get the configuration of extensions
*
* @return array[]
*/
public function getExtensionConfiguration() { /* {{{ */
return $this->extconf;
} /* }}} */
/**
* Check if extension directory is writable
*
* @return boolean
*/
public function isWritableExtDir() { /* {{{ */
return is_writable($this->extdir);
} /* }}} */
/**
* Create the cached file containing extension information
*
* This function will always create a file, even if no extensions
* are installed.
*
* @return boolean true on success, false on error
*/
public function createExtensionConf() { /* {{{ */
$extensions = self::getExtensions();
$fp = @fopen(self::getExtensionsConfFile(), "w");
if($fp) {
if($extensions) {
foreach($extensions as $_ext) {
if(file_exists($this->extdir . "/" . $_ext . "/conf.php")) {
$content = file_get_contents($this->extdir . "/" . $_ext . "/conf.php");
fwrite($fp, $content);
}
}
}
fclose($fp);
return true;
} else {
return false;
}
} /* }}} */
/**
* Get names of locally installed extensions by scanning the extension dir
*
* @return string[] list of extension names
*/
protected function getExtensions() { /* {{{ */
$extensions = array();
if(file_exists($this->extdir)) {
$handle = opendir($this->extdir);
while ($entry = readdir($handle) ) {
if ($entry == ".." || $entry == ".")
continue;
else if (is_dir($this->extdir ."/". $entry))
array_push($extensions, $entry);
}
closedir($handle);
asort($extensions);
}
return $extensions;
} /* }}} */
/**
* Create zip archive of an extension
*
* @param string $extname name of extension
* @param string $version version of extension (x.y.z)
* @return string name of temporary file with archive
*/
public function createArchive($extname, $version) { /* {{{ */
if(!is_dir($this->extdir ."/". $extname))
return false;
$tmpfile = $this->cachedir."/".$extname."-".$version.".zip";
$cmd = "cd ".$this->extdir."/".$extname."; zip -r ".$tmpfile." .";
exec($cmd);
return $tmpfile;
} /* }}} */
/**
* Check content of extension directory or configuration of extension
*
* @param string|array $dir full path to extension directory or extension name
* or an array containing the configuration.
* @param boolean $noconstraints set to true if constraints to local seeddms
* installation shall not be checked.
*/
public function checkExtension($dir, $options=array()) { /* {{{ */
$this->errmsgs = array();
if(is_string($dir)) {
if(!file_exists($dir)) {
if(!file_exists($this->extdir.'/'.$dir))
return false;
else
$dir = $this->extdir.'/'.$dir;
}
if(!file_exists($dir."/conf.php")) {
$this->errmsgs[] = "Missing extension configuration";
return false;
}
include($dir."/conf.php");
if(!isset($EXT_CONF)) {
$this->errmsgs[] = "Missing \$EXT_CONF in configuration";
return false;
}
$extname = key($EXT_CONF);
if(!$extname || !preg_match('/[a-zA-Z_]*/', $extname)) {
$this->errmsgs[] = "Extension has invalid or no name";
return false;
}
$extconf = $EXT_CONF[$extname];
} elseif(is_array($dir)) {
$extconf = $dir;
/* If just the configuration is passed, then there is no way to check
* for existence of files.
*/
$options['nofiles'] = true;
}
if(!isset($extconf['constraints']['depends']['seeddms'])) {
$this->errmsgs[] = "Missing dependency on SeedDMS";
}
if(!isset($extconf['constraints']['depends']['php'])) {
$this->errmsgs[] = "Missing dependency on PHP";
}
if(!isset($extconf['version'])) {
$this->errmsgs[] = "Missing version information";
}
if(!isset($extconf['title'])) {
$this->errmsgs[] = "Missing title";
}
if(!isset($extconf['author'])) {
$this->errmsgs[] = "Missing author";
}
if(!isset($options['nofiles']) || $options['nofiles'] == false) {
if(!empty($extconf['language']['file']) && !file_exists($dir."/".$extconf['language']['file'])) {
$this->errmsgs[] = "Missing language file";
}
if(!empty($extconf['class']['file']) && !file_exists($dir."/".$extconf['class']['file'])) {
$this->errmsgs[] = "Missing class file";
}
if(!empty($extconf['icon']) && !file_exists($dir."/".$extconf['icon'])) {
$this->errmsgs[] = "Missing icon file";
}
}
if(!isset($options['noconstraints']) || $options['noconstraints'] == false) {
if(isset($extconf['constraints']['depends'])) {
foreach($extconf['constraints']['depends'] as $dkey=>$dval) {
switch($dkey) {
case 'seeddms':
$version = new SeedDMS_Version;
$tmp = explode('-', $dval, 2);
if(self::cmpVersion($tmp[0], $version->version()) > 0 || ($tmp[1] && self::cmpVersion($tmp[1], $version->version()) < 0))
$this->errmsgs[] = sprintf("Incorrect SeedDMS version (needs version %s)", $extconf['constraints']['depends']['seeddms']);
break;
case 'php':
$tmp = explode('-', $dval, 2);
if(self::cmpVersion($tmp[0], phpversion()) > 0 || ($tmp[1] && self::cmpVersion($tmp[1], phpversion()) < 0))
$this->errmsgs[] = sprintf("Incorrect PHP version (needs version %s)", $extconf['constraints']['depends']['php']);
break;
case 'phpext':
if(is_array($dval) && $dval) {
$extlist = get_loaded_extensions();
foreach($dval as $d) {
if(!in_array($d, $extlist))
$this->errmsgs[] = sprintf("Missing php extension '%s'", $d);
}
}
break;
default:
$tmp = explode('-', $dval, 2);
if(isset($GLOBALS['EXT_CONF'][$dkey]['version'])) {
if(self::cmpVersion($tmp[0], $GLOBALS['EXT_CONF'][$dkey]['version']) > 0 || ($tmp[1] && self::cmpVersion($tmp[1], $GLOBALS['EXT_CONF'][$dkey]['version']) < 0))
$this->errmsgs[] = sprintf("Incorrect version of extension '%s' (needs version '%s' but provides '%s')", $dkey, $dval, $GLOBALS['EXT_CONF'][$dkey]['version']);
} else {
$this->errmsgs[] = sprintf("Missing extension or version for '%s'", $dkey);
}
break;
}
}
}
}
if($this->errmsgs)
return false;
return true;
} /* }}} */
static protected function rrmdir($dir) { /* {{{ */
if (is_dir($dir)) {
$objects = scandir($dir);
foreach ($objects as $object) {
if ($object != "." && $object != "..") {
if (filetype($dir."/".$object) == "dir") self::rrmdir($dir."/".$object); else unlink($dir."/".$object);
}
}
reset($objects);
rmdir($dir);
}
} /* }}} */
/**
* Update an extension
*
* This function will replace an existing extension or add a new extension
* The passed file has to be zipped content of the extension directory not
* including the directory itself.
*
* @param string $file name of extension archive
* @return boolean true on success, othewise false
*/
public function updateExtension($file) { /* {{{ */
/* unzip the extension in a temporary directory */
$newdir = $this->cachedir ."/ext.new";
if(!mkdir($newdir, 0755)) {
$this->errmsgs[] = "Cannot create temp. extension directory";
return false;
}
$cmd = "cd ".$newdir."; unzip ".$file;
exec($cmd);
/* Check if extension is complete and fullfills the constraints */
if(!self::checkExtension($newdir)) {
self::rrmdir($newdir);
return false;
}
include($newdir."/conf.php");
$extname = key($EXT_CONF);
/* Create the target directory */
if(!is_dir($this->extdir)) {
if(!mkdir($this->extdir, 0755)) {
$this->errmsgs[] = "Cannot create extension directory";
self::rrmdir($newdir);
return false;
}
} elseif(is_dir($this->extdir ."/". $extname)) {
$this->rrmdir($this->extdir ."/". $extname);
}
/* Move the temp. created ext directory to the final location */
rename($newdir, $this->extdir ."/". $extname);
return true;
} /* }}} */
/**
* Get list of extensions from cached repository index
*
* This function returns the whole repository index file separated in
* single lines. Each line is either a comment if it starts with an '#'
* or a json encoded array containing the extension configuration.
*
* Run SeedDMS_Extension_Mgr::updateExtensionList() to ensure the
* currently cached extension list file is up to date.
*
* @return string[] list of json strings or comments
*/
public function getRawExtensionList() { /* {{{ */
if(file_exists($this->cachedir."/".self::repos_list_file)) {
return file($this->cachedir."/".self::repos_list_file);
} else {
return array();
}
} /* }}} */
/**
* Get list of extensions from cached repository index
*
* This function reads the cache respository index and returns
* a list of extension configurations. Only the most recent version
* of an extension will be included.
*
* Run SeedDMS_Extension_Mgr::updateExtensionList() to ensure the
* currently cached extension list file is up to date.
*
* @return array[] list of extension configurations
*/
public function getExtensionList() { /* {{{ */
$list = self::getRawExtensionList();
$result = array();
$vcache = array(); // keep highest version of extension
foreach($list as $e) {
if($e[0] != '#') {
$re = json_decode($e, true);
if(!isset($result[$re['name']])) {
$result[$re['name']] = $re;
$vcache[$re['name']] = $re['version'];
} elseif(self::cmpVersion($re['version'], $vcache[$re['name']]) > 0) {
$result[$re['name']] = $re;
$vcache[$re['name']] = $re['version'];
}
}
}
return $result;
} /* }}} */
/**
* Get list of version of an extension from cached repository index
*
* This function reads the cache respository index and returns
* a list of extension configurations. Only those extensions will
* be included which maches the given name.
*
* Run SeedDMS_Extension_Mgr::updateExtensionList() to ensure the
* currently cached extension list file is up to date.
*
* @return array[] list of extension configurations
*/
public function getExtensionListByName($extname) { /* {{{ */
$list = self::getRawExtensionList();
$result = array();
foreach($list as $e) {
if($e[0] != '#') {
$re = json_decode($e, true);
if($re['name'] == $extname) {
$result[$re['version']] = $re;
}
}
}
return $result;
} /* }}} */
/**
* Import list of extension from repository
*
* @param boolean $force force download even if file already exists
*/
public function updateExtensionList($version='', $force=false) { /* {{{ */
if($this->reposurl) {
if(!file_exists($this->cachedir."/".self::repos_list_file) || $force) {
if($file = @file_get_contents($this->reposurl.($version ? '?seeddms_version='.$version : ''))) {
if(is_array($http_response_header)) {
$parts=explode(' ',$http_response_header[0]);
if(count($parts)>1) //HTTP/1.0 <code> <text>
if(intval($parts[1]) != 200) {
$this->errmsgs[] = 'Getting extension list returned http code ('.$parts[1].')';
return false;
}
}
file_put_contents($this->cachedir."/".self::repos_list_file, $file);
} else {
return false;
}
}
return true;
} else {
return false;
}
} /* }}} */
/**
* Return last error message
*
* @return string
*/
public function getErrorMsg() { /* {{{ */
if($this->errmsgs)
return $this->errmsgs[0];
else
return '';
} /* }}} */
/**
* Return all error messages
*
* @return string[]
*/
public function getErrorMsgs() { /* {{{ */
return $this->errmsgs;
} /* }}} */
}