X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=gosa-core%2Finclude%2Fclass_configRegistry.inc;h=f895a3dac561ef9a0c1a8c04d3c426c7beb37f3c;hb=9566dc068208034acf0da2630a7efbb5a370f191;hp=32b4b61e2e30526714d9a300989ed3e1a9033f0a;hpb=2a5845405cd07efe83561b9402690dd6720d27b7;p=gosa.git
diff --git a/gosa-core/include/class_configRegistry.inc b/gosa-core/include/class_configRegistry.inc
index 32b4b61e2..f895a3dac 100644
--- a/gosa-core/include/class_configRegistry.inc
+++ b/gosa-core/include/class_configRegistry.inc
@@ -15,11 +15,24 @@ class configRegistry{
// Contains all classes with plInfo
public $classesWithInfo = array();
- public $categoryRequirements = array();
+ public $pluginRequirements = array();
public $categoryToClass = array();
public $objectClasses = array();
+ public $detectedSchemaIssues = array();
+ public $schemaCheckFailed = FALSE;
+ public $schemaCheckFinished = FALSE;
+ public $pluginsDeactivated = array();
+
+ // Name of enabled plugins found in gosa.conf.
+ private $activePlugins = array();
+
+
+ /*! \brief Constructs the config registry
+ * @param config The configuration object
+ * @return
+ */
function __construct($config)
{
$this->config = &$config;
@@ -44,76 +57,249 @@ class configRegistry{
$this->reload();
}
+
+ /*! \brief Returns a list of plugins used by GOsa.
+ @return Array An array containing all plugins with theis plInfo data.
+ */
+ function getListOfPlugins()
+ {
+ return($this->classesWithInfo);
+ }
+
- function validateSchemata($disableIncompatiblePlugins = FALSE,$displayMessage = FALSE)
+ /*! \brief Checks whether the schema check was called in the current session or not.
+ * @return Boolean True if check was already called
+ */
+ function schemaCheckFinished()
{
- // We can check the schemata only with a valid LDAP connection
- if(empty($this->config->current['CONFIG'])){
- return(TRUE);
- }
+ return($this->schemaCheckFinished);
+ }
+
+ /*! \brief Starts the schema validation
+ * @param Boolean 'force' Force a re-check.
+ * @param Boolean 'disableIncompatiblePlugins' Disables of incompatible GOsa-plugins.
+ * @return Boolean True on success else FALSE
+ */
+ function validateSchemata($force = FALSE, $disableIncompatiblePlugins = FALSE, $objectClassesToUse = array())
+ {
// Read objectClasses from ldap
- if(!count($this->objectClasses)){
+ if(count($objectClassesToUse)){
+ $this->setObjectClasses($objectClassesToUse);
+ }elseif(!count($this->objectClasses)){
$ldap = $this->config->get_ldap_link();
$ldap->cd($this->config->current['BASE']);
- $this->objectClasses = $ldap->get_objectclasses();
+ $this->setObjectClasses($ldap->get_objectclasses());
+ }
+
+ return($this->_validateSchemata($force, $disableIncompatiblePlugins));
+ }
+
+
+ /*! \brief Sets the list object classes to use while validation the schema. (See 'validateSchemata')
+ * This is called from the GOsa-Setup
+ * @param Array The list of object classes (usually LDAP::get_objectlclasses()).
+ * @return void
+ */
+ function setObjectClasses($ocs)
+ {
+ $this->objectClasses = $ocs;
+ }
+
+
+ /*! \brief Returns an array which contains all unresolved schemata requirements.
+ * @return Array An array containing all errors/issues
+ */
+ function getSchemaResults()
+ {
+ return($this->detectedSchemaIssues);
+ }
+
+
+ /*! \brief This method checks if the installed ldap-schemata matches the plugin requirements.
+ * @param Boolean 'force' Force a re-check.
+ * @param Boolean 'disableIncompatiblePlugins' Disables of incompatible GOsa-plugins.
+ * @return String
+ */
+ private function _validateSchemata($force = FALSE, $disableIncompatiblePlugins = FALSE)
+ {
+ // We cannot check without readable schema info
+ if(!count($this->objectClasses)){
+ return(TRUE);
}
+ // Don't do things twice unless forced
+ if($this->schemaCheckFinished && !$force) return($this->schemaCheckFailed);
+
+ // Prepare result array
+ $this->detectedSchemaIssues = array();
+ $this->detectedSchemaIssues['missing'] = array();
+ $this->detectedSchemaIssues['versionMismatch'] = array();
+
+ // Clear last results
+ $this->pluginsDeactivated = array();
+
// Collect required schema infos
- $this->categoryRequirements = array();
+ $this->pluginRequirements = array('ldapSchema' => array());
$this->categoryToClass = array();
+
+ // Walk through plugins with requirements, but only check for active plugins.
foreach($this->classesWithInfo as $cname => $defs){
- if(isset($defs['plCategory'])){
- foreach($defs['plCategory'] as $name => $data){
- if(!is_numeric($name)){
- $this->categoryToClass[$name]['BASE'] = $cname;
- if(isset($data['objectClass'])){
- $this->categoryRequirements[$name] = $data['objectClass'];
- }
+ if(isset($defs['plRequirements'])){
+
+ // Check only if required plugin is enabled in gosa.conf
+ // Normally this is the class name itself, but may be overridden
+ // in plInfo using the plRequirements::activePlugin statement.
+ $requiresActivePlugin = $cname;
+ if(isset($defs['plRequirements']['activePlugin'])){
+ $requiresActivePlugin = $defs['plRequirements']['activePlugin'];
+ }
+
+ // Only queue checks for active plugins.
+ if(isset($this->activePlugins[strtolower($requiresActivePlugin)])){
+ $this->pluginRequirements[$cname] = $defs['plRequirements'];
+ }else{
+ if($cname == $requiresActivePlugin){
+ new log("debug","","Skipped schema check for '{$cname}' plugin is inactive!",
+ array(),'');
}else{
- $this->categoryToClass[$data]['SUB'][] = $cname;
+ new log("debug","","Skipped schema check for class '{$cname}' skipped,".
+ " required plugin '{$requiresActivePlugin}' is inactive!",
+ array(),'');
}
}
}
}
- // Check schema requirements now
- foreach($this->categoryRequirements as $cat => $requirements){
-
- if(!is_string($requirements)){
- }else{
- if(!$this->ocAvailable($requirements)){
-
- if($displayMessage){
- $classes = "";
- $name = $this->categoryToClass[$cat]['BASE'];
- $classes.= "- ".$this->classToName[$name]."
";
- if(isset($this->categoryToClass[$cat]['SUB'])){
- foreach($this->categoryToClass[$cat]['SUB'] as $name){
- $classes.= "- ".$this->classToName[$name]."
";
+ // Check schema requirements now $missing = $invalid = array();
+ foreach($this->pluginRequirements as $cname => $requirements){
+
+ // Check LDAP schema requirements for this plugins
+ $failure = FALSE;
+ if(isset($requirements['ldapSchema'])){
+ foreach($requirements['ldapSchema'] as $oc => $version){
+ if(!$this->ocAvailable($oc)){
+ $this->detectedSchemaIssues['missing'][$oc] = $oc;
+
+ $this->schemaCheckFailed = TRUE;
+ $failure = TRUE;
+
+ new log("debug","","LDAP objectClass missing '{$oc}'!",
+ array(),'');
+
+ }elseif(!empty($version)){
+ $currentVersion = $this->getObjectClassVersion($oc);
+ if(!empty($currentVersion) && !$this->ocVersionMatch($version, $currentVersion)){
+ if($currentVersion == -1){
+ $currentVersion = _("unknown");
}
+ $this->detectedSchemaIssues['versionMismatch'][$oc] =
+ sprintf(_("%s has version %s but %s is required!"), bold($oc),bold($currentVersion),bold($version));
+ $this->schemaCheckFailed = TRUE;
+ $failure = TRUE;
+
+ new log("debug","","LDAP objectClass version mismatch '{$oc}' ".
+ "has '{$currentVersion}' but {$version} required!",
+ array(),'');
}
- $classes.= "
";
- msg_dialog::display(_("Schema validation error"),
- sprintf(_("The objectClass '%s' which is required for plugin '%s' is not availabe!"),
- bold($requirements),bold($cat)),
- ERROR_DIALOG);
}
- }else{
- #äprint_a($this->objectClasses[$requirements]);
}
}
+
+ // Display corresponding plugins now
+ if($disableIncompatiblePlugins && $failure && isset($requirements['onFailureDisablePlugin'])){
+ foreach($requirements['onFailureDisablePlugin'] as $name){
+ $this->pluginsDeactivated[$name] = $name;
+ }
+ }
+ }
+ $this->schemaCheckFinished =TRUE;
+ session::un_set('plist');
+ return(!$this->schemaCheckFailed);
+ }
+
+
+ /*! \brief The function 'validateSchemata' may has disabled some GOsa-Plugins,
+ * the list of disabled plugins will be returned here.
+ * @return Array The list of plugins disabled by 'validateSchemata'
+ */
+ function getDisabledPlugins()
+ {
+ return($this->pluginsDeactivated);
+ }
+
+
+ /*! \brief Displays an error message with all issues detect during the schema validation.
+ */
+ function displayRequirementErrors()
+ {
+ $message = "";
+ if(count($this->detectedSchemaIssues['missing'])){
+ $message.= "
".
+ _("The following object classes are missing:").
+ "".
+ msgPool::buildList(array_values($this->detectedSchemaIssues['missing'])).
+ "
";
+ }
+ if(count($this->detectedSchemaIssues['versionMismatch'])){
+ $message.= "
".
+ _("The following object classes are outdated:").
+ "".
+ msgPool::buildList(array_values($this->detectedSchemaIssues['versionMismatch'])).
+ "
";
+ }
+ if($message != ""){
+ $message.= "
"._("Plugins that require one or more of the object classes above will be disabled until the object classes get updated.");
+
+ msg_dialog::display(_("Schema validation error"),$message, ERROR_DIALOG);
}
}
- // check wheter an objectClass is installed or not.
+ /*! \brief Checks to version strings (e.g. '>=v2.8' and '2.9')
+ * @param String The required version with operators (e.g. '>=2.8')
+ * @param String The version to match for withOUT operators (e.g. '2.9')
+ * @return Boolean True if version matches else false.
+ */
+ private function ocVersionMatch($required, $installed)
+ {
+ $operator = preg_replace('/^([=<>]*).*$/',"\\1",$required);
+ $required = preg_replace('/^[=<>]*(.*)$/',"\\1",$required);
+ return(version_compare($installed,$required, $operator));
+ }
+
+
+ /*! \brief Returns the currently installed version of a given object class.
+ * @param String The name of the objectClass to check for.
+ * @return String The version string of the objectClass (e.g. v2.7)
+ */
+ function getObjectClassVersion($oc)
+ {
+ if(!isset($this->objectClasses[$oc])){
+ return(NULL);
+ }else{
+ $version = -1; // unknown
+ if(preg_match("/(v[^)]*)/", $this->objectClasses[$oc]['DESC'])){
+ $version = preg_replace('/^.*\(v([^)]*)\).*$/',"\\1", $this->objectClasses[$oc]['DESC']);
+ }
+ }
+ return($version);
+ }
+
+
+ /*! \brief Check whether the given object class is available or not.
+ * @param String The name of the objectClass to check for (e.g. 'mailAccount')
+ * @return Boolean Returns TRUE if the class exists else FALSE.
+ */
function ocAvailable($name)
{
return(isset($this->objectClasses[$name]));
}
+ /*! \brief Re-loads the list of installed GOsa-Properties.
+ * @param Boolean $force If force is TRUE, the complete properties list is rebuild..
+ */
function reload($force = FALSE)
{
// Do not reload the properties everytime, once we have
@@ -126,13 +312,23 @@ class configRegistry{
$this->fileStoredProperties = array();
$this->properties = array();
$this->mapByName = array();
+ $this->activePlugins = array('core'=>'core');
+
+ if(!$this->config) return;
// Search for config flags defined in the config file (TAB section)
foreach($this->config->data['TABS'] as $tabname => $tabdefs){
foreach($tabdefs as $info){
+ // Put plugin in list of active plugins
+ if(isset($info['CLASS'])){
+ $class = strtolower($info['CLASS']);
+ $this->activePlugins[$class] = $class;
+ }
+
// Check if the info is valid
if(isset($info['NAME']) && isset($info['CLASS'])){
+
// Check if there is nore than just the plugin definition
if(count($info) > 2){
@@ -151,11 +347,18 @@ class configRegistry{
// Search for config flags defined in the config file (MENU section)
foreach($this->config->data['MENU'] as $section => $entries){
foreach($entries as $entry){
- if(count($entry) > 2 && isset($entry['CLASS'])){
- $class = $entry['CLASS'];
- foreach($entry as $name => $value){
- if(!in_array($name, array('CLASS','ACL'))){
- $this->fileStoredProperties[strtolower($class)][strtolower($name)] = $value;
+
+ if(isset($entry['CLASS'])){
+
+ // Put plugin to active plugins list.
+ $class = strtolower($entry['CLASS']);
+ $this->activePlugins[$class] = $class;
+
+ if(count($entry) > 2 ){
+ foreach($entry as $name => $value){
+ if(!in_array($name, array('CLASS','ACL'))){
+ $this->fileStoredProperties[strtolower($class)][strtolower($name)] = $value;
+ }
}
}
}
@@ -194,7 +397,6 @@ class configRegistry{
$this->ldapStoredProperties[$class][$name] = $value;
}
}
- $this->status = 'finished';
}
// Register plugin properties.
@@ -213,6 +415,12 @@ class configRegistry{
$this->register($cname, $data);
$data = array('name' => 'postmodify','type' => 'command');
$this->register($cname, $data);
+ $data = array('name' => 'precreate','type' => 'command');
+ $this->register($cname, $data);
+ $data = array('name' => 'preremove','type' => 'command');
+ $this->register($cname, $data);
+ $data = array('name' => 'premodify','type' => 'command');
+ $this->register($cname, $data);
$data = array('name' => 'check', 'type' => 'command');
$this->register($cname, $data);
@@ -223,8 +431,26 @@ class configRegistry{
}
}
}
+
+ // We are only finsihed once we are logged in.
+ if(!empty($this->config->current['CONFIG'])){
+ $this->status = 'finished';
+ }
+ }
+
+
+ /*! \brief Returns TRUE if the property registration has finished without any error.
+ */
+ function propertyInitializationComplete()
+ {
+ return($this->status == 'finished');
}
+
+ /*! \brief Registers a GOsa-Property and thus makes it useable by GOsa and its plugins.
+ * @param String $class The name of the class/plugin that wants to register this property.
+ * @return Array $data An array containing all data set in plInfo['plProperty]
+ */
function register($class,$data)
{
$id = count($this->properties);
@@ -233,17 +459,33 @@ class configRegistry{
$this->mapByName[$p] = $id;
}
+
+ /*! \brief Returns all registered properties.
+ * @return Array A list of all properties.
+ */
public function getAllProperties()
{
return($this->properties);
}
+
+ /*! \brief Checks whether a property exists or not.
+ * @param String $class The class name (e.g. 'core' or 'mailAccount')
+ * @param String $name The property name (e.g. 'sessionTimeout' or 'mailMethod')
+ * @return Boolean TRUE if it exists else FALSE.
+ */
function propertyExists($class,$name)
{
$p = strtolower("{$class}::{$name}");
return(isset($this->mapByName[$p]));
}
+
+ /*! \brief Returns the id of a registered property.
+ * @param String $class The class name (e.g. 'core' or 'mailAccount')
+ * @param String $name The property name (e.g. 'sessionTimeout' or 'mailMethod')
+ * @return Integer The id for the given property.
+ */
private function getId($class,$name)
{
$p = strtolower("{$class}::{$name}");
@@ -253,6 +495,12 @@ class configRegistry{
return($this->mapByName[$p]);
}
+
+ /*! \brief Returns a given property, if it exists.
+ * @param String $class The class name (e.g. 'core' or 'mailAccount')
+ * @param String $name The property name (e.g. 'sessionTimeout' or 'mailMethod')
+ * @return GOsaPropery The property or 'NULL' if it doesn't exists.
+ */
function getProperty($class,$name)
{
if($this->propertyExists($class,$name)){
@@ -261,6 +509,12 @@ class configRegistry{
return(NULL);
}
+
+ /*! \brief Returns the value for a given property, if it exists.
+ * @param String $class The class name (e.g. 'core' or 'mailAccount')
+ * @param String $name The property name (e.g. 'sessionTimeout' or 'mailMethod')
+ * @return GOsaPropery The property value or an empty string if it doesn't exists.
+ */
function getPropertyValue($class,$name)
{
if($this->propertyExists($class,$name)){
@@ -270,6 +524,12 @@ class configRegistry{
return("");
}
+
+ /*! \brief Set a new value for a given property, if it exists.
+ * @param String $class The class name (e.g. 'core' or 'mailAccount')
+ * @param String $name The property name (e.g. 'sessionTimeout' or 'mailMethod')
+ * @return
+ */
function setPropertyValue($class,$name, $value)
{
if($this->propertyExists($class,$name)){
@@ -279,6 +539,10 @@ class configRegistry{
return("");
}
+
+ /*! \brief Save all temporary made property changes and thus make them useable/effective.
+ * @return Array Returns a list of plugins that have to be migrated before they can be saved.
+ */
function saveChanges()
{
$migrate = array();
@@ -479,6 +743,31 @@ class gosaProperty
return($match);
}
+ static function isWriteableFile($message,$class,$name,$value, $type)
+ {
+ $match = (file_exists($value) && is_writeable($value)) ||
+ (!file_exists($value) && is_writeable(dirname($value)));
+
+
+ // Display the reason for failing this check.
+ if($message && ! $match){
+
+ if(!file_exists($value) && !is_writeable(dirname($value))){
+ msg_dialog::display(_("Warning"),
+ sprintf(_("The file '%s' specified for '%s:%s' cannot be created neither be used for writing!"),
+ bold($value),bold($class),bold($name)),
+ WARNING_DIALOG);
+ }elseif(file_exists($value) && !is_writeable($value)){
+ msg_dialog::display(_("Warning"),
+ sprintf(_("The file '%s' specified for '%s:%s' cannot be used for writing!"),
+ bold($value),bold($class),bold($name)),
+ WARNING_DIALOG);
+ }
+ }
+
+ return($match);
+ }
+
static function isWriteablePath($message,$class,$name,$value, $type)
{
$match = !empty($value)&&is_dir($value)&&is_writeable($value);