Class: I2CE Configurator

This article desrcibes the class I2CE_Configurator.

• Extends the class: I2CE_Fuzzy.
• Location: Part of the module I2CE in the package I2CE
• Source: Defined in the file lib/I2CE_Configurator.php

Variables

$mod_path

Hack to store the paths to each config

• Type: private y $mod_path

$top_module

An associative array linking directory to top-level module

• Type: private y $top_module

$checked_paths

A list of the paths checked

• Type: private y $checked_paths

$found_modules

Holds a list of found modules @var private array $found_module

• Type: private $found_modules

$errors

Errors encountered

• Type: private ng $errors

$file_list

list of files for each module

• Type: private y $file_list

$storage

Where we are saving all configuration data

• Type: protected I2CE_MagicData $storage

$template

the current template we are working with

• Type: protected I2CE_MagicDataTemplate $template

$merges

$var protected array $merges. Keys are magic data paths, values are merge type

• Type: protected $merges

$locales

The locales for which we check for config files.

• Type: protected $locales

$hash

. The hash of the last config file processed. It is a string, the hash, if the last config file loaded successully. false if the last config file did not load succesully. null if there was never a config file processed.

• Type: protected mixed $hash

Methods

__construct()

Constructor

then a simple MagicData and config storage object using MagicDataStorageMem will be set up.

• Signature: public function __construct($storage,$set_last_access)

Parameters:

• I2CE_MagicData $storage
  if none is passed in,
  • Default Value: null
• boolean $set_last_access
  • Default Value: true

__destruct()

• Signature: public function __destruct()

checkForConflicts()

• Signature: protected function checkForConflicts($requirements,$enabled_modules)

Parameters:

• $requirements
• $enabled_modules

checkRequirements()

Checks the requirements. if all requirements are met and there are no conflicts, it returns a list of those that need to be installed, an empty array() if none are needed. On failure returns null.

@param array $shortnames an array of shortnames

shortnames of modules to disable. Defaults to empty array

@param array $remove an array of potential shortnames to remove -- if we did not find them somplace else. (it may have just been moved) defaults to an empty array.

enabled modules -- we check for conflicts against this array

shortnames of required modules -- if a module is set to be updated and it is not required by on of the modules in this array, it will be set as an optional modules. Defaults to the empty array

• Signature: public function checkRequirements($updates,$disables,$removals,$enabled_modules,$required_modules)
• Returns: array. Keys are:

'failure' - string with the reason for failture 'requirements' - array which has as keys shortnames and values files for the requirements. 'removals' - array of shortnames that need to be removed. 'optional' - array with key shortnames and value true 'moved' - array with key shortnames and value true Parameters:

• $updates
• mixed $disables
  a shortname or an array of
  • Default Value: array()
• $removals
  • Default Value: array()
• array $enabled_modules
  An array of shortnames of
  • Default Value: array()
• mixed $required_modules
  A shortname or an array of
  • Default Value: array()

extRequirements()

Get a list of External dependencies for the module

• Signature: public function extRequirements($module)
• Returns: array List of requirement objects

Parameters:

• string $module
  Module to check.

findAvailableConfigs()

Searches the system for available configuration files (if not done already) and stores them in the given I2CE_MagicData

@param I2CE_FileSearch A file search to use for modules. If null(default) uses I2CE::getFileSearch()

checks the module paths of the currently enabled modules. If true, checks the module paths of all modules which are either enabled or disabled.

extensions which we wish to test if they are a config file. Defaults to the empty array in which case we look for files with the 'xml' extension and any additional extensions registered under I2CE::getConfig()->config->additional_configuration_extensions

and this is set, we only add in the directories which are subdirectorues of $limit_to_subdir (check is by string comparision)

• Signature: public function findAvailableConfigs($file_search,$deep,$extensions,$limit_to_subdir,$verbose_errors)
• Returns: array of string the list of shortnames found

Parameters:

• $file_search
  • Default Value: null
• boolean $deep
  Defaults to false. If false, only
  • Default Value: false
• array $extensions
  An array containing file
  • Default Value: array()
• string $limit_to_subdir
  If $file_search is given
  • Default Value:
• $verbose_errors
  • Default Value: false

findPotentialConfigs()

Return a list of potential configuration files. "Potential config files" are those whose extension matches the regular expression.

@param array @returns

• Signature: private function findPotentialConfigs($extensions,$file_search)

Parameters:

• $extensions
• $file_search

flattenRequirements()

• Signature: protected function flattenRequirements($requirementDOM)

Parameters:

• $requirementDOM

getAvailableModules()

Scan a directory for available modules.

• Signature: public function getAvailableModules($search_dirs,$limit_search,$rescan,$verbose)
• Returns: array List of modules found

Parameters:

• array $search_dirs
  List of Directories to search
• boolean $limit_search
  Don't scan by depth (true)
  • Default Value: true
• boolean $rescan
  Whether to force a rescan (false)
  • Default Value: false
• boolean $verbose
  Verbose errors (false)
  • Default Value: false

getConflicts()

For a given module, find a list of conflicting modules.

• Signature: private function getConflicts($module)
• Returns: array List of conflicts

Parameters:

• string $module
  Module to check

getDefaultExtensions()

• Signature: private function getDefaultExtensions()

getDependencyList()

Gets information about the dependecies for a module

• Signature: public function getDependencyList($module)
• Returns: array indexed by 'requirements', 'conflicts'

'enable', 'path', and 'badness' where 'badness' is an array of strings of error messages and the other are arrays of shortnames Parameters:

• string $module

getDependsList()

Gets the list of modules depending on the specified module.

• Signature: public function getDependsList($shortname)

Parameters:

• string $shortname
  The shortname of a module

getDescription()

Returns a brief one-line description of the module.

• Signature: public function getDescription($module)
• Returns: string

Parameters:

• string $module
  name

getEnabled()

Get enabled sub-modules

• Signature: private function getEnabled($module)
• Returns: array List of enabled submodules

Parameters:

• string $module
  Module to check.

getHash()

Get the hash of the contents of the last processConfifFile.

• Signature: public function getHash()
• Returns: mixed. String, the hash, if the last config file

loaded successfully. false if the last config file did not load succesully. null if there was never a config file processed.

getI2CERoot()

• Signature: public function getI2CERoot()

getLongDescription()

Returns a longer description of the module.

• Signature: public function getLongDescription($module)
• Returns: string

Parameters:

• string $module
  name

getMaxChildOrder()

• Signature: protected function getMaxChildOrder($node,$xpath)

Parameters:

• $node
• $xpath

getMerges()

Get the magic data paths whose status we are tracking. $retrurns array. Keys are magic data paths, values are the merge type

• Signature: public function getMerges()

getModuleDir()

Return the directory of the module

• Signature: public function getModuleDir($module)
• Returns: string Path to config file.

Parameters:

• string $module
  Module to check.
  • Default Value: null

getModuleFileList()

Get a list of files for a given module

• Signature: public function getModuleFileList($module)
• Returns: array List of files in the module. Paths are

relative to the directory where the module's configuration file is. Parameters:

• string $module
  The module name

getModuleFileMap()

Get a list of each files under each path.

• Signature: public function getModuleFileMap($module)
• Returns: array List of file maps in the module. Paths are

relative to the directory where the module's configuration file is. @todo Contains a hack for the special case where CLASSES directory is ./ Parameters:

• string $module
  The module name

getModulePath()

Return the path to the module configuration file

• Signature: public function getModulePath($module)
• Returns: string Path to config file.

Parameters:

• string $module
  Module to check.

getModulePathList()

• Signature: public function getModulePathList($module)

Parameters:

• $module

getNextUnchecked()

• Signature: protected function getNextUnchecked($requirementDOM)

Parameters:

• $requirementDOM

getPackageAuthors()

Returns a longer description of the module.

• Signature: public function getPackageAuthors($module)
• Returns: string

Parameters:

• string $module
  name

getRequirements()

Get a list of requirements for the module

• Signature: private function getRequirements($module)
• Returns: array List of required modules.

Parameters:

• string $module
  Module to check.

getRoot()

Get the root of where this I2CE instance started.

• Signature: public function getRoot()
• Returns: the fully resolved path to the starting directory

getStorage()

Get the magic data node storage for the configurator

• Signature: public function getStorage()
• Returns: I2CE_MagicDataNode

getTopModule()

Find the top-level module in a directory. (e.g. I2CE, ihris-common, ihris-manage)

@return

• Signature: public function getTopModule($d,$verbose)

Parameters:

• string $d
  Directory to check
• boolean $verbose
  • Default Value: false

getVersion()

Return the version for a given module

• Signature: public function getVersion($module)
• Returns: string

Parameters:

• string $module
  name

importLocalizedTemplates()

• Signature: public function importLocalizedTemplates($localized)

Parameters:

• $localized
  • Default Value: array()

isReq()

Determine if this object is a I2CE_MagicDataNode that can be used as a requirement. @param mixed $string

• Signature: private function isReq($req)
• Returns: boolean

Parameters:

• $req

loadConfigFile()

Load a config file with various extensions.

• Signature: protected function loadConfigFile($file,$verbose_errors)
• Returns: booolean true on success

Parameters:

• string $file
  Path to the config file
• boolean $verbose_errors
  (true)
  • Default Value: true

moduleConflicts()

Checks to see if a module conflicts with by another module

requirements (true)

• Signature: public function moduleConflicts($module,$version,$conflicts,$deep)
• Returns: boolean

Parameters:

• string $module
  Module to check
• string $version
  Version of the module
• mixed $conflicts
  Module name or an array of module names
• boolean $deep
  Whether to recursively check the
  • Default Value: true

moduleRequires()

Checks to see if a module is required by another module

check requirements of requiremnets of requirements of ...

• Signature: public function moduleRequires($module,$version,$requirements,$deep,$cat)
• Returns: boolean

Parameters:

• string $module
• string $version
• mixed $requirements
  a module name or an array of module names
• boolean $deep
  Defaults to true meaning we should
  • Default Value: true
• $cat
  • Default Value: 'requirement'

processConfig()

• Signature: public function processConfig($process_configuration,$verbose_errors,$process_meta,$localized)

Parameters:

• $process_configuration
  • Default Value: false
• $verbose_errors
  • Default Value: true
• $process_meta
  • Default Value: true
• $localized
  • Default Value: array()

processConfigFile()

Loads in a config file and validates it against its referenced DTD. Sets the access time and the shortname (provided in the metadata) for the file. If there is already a config file with the same shortname, it will remove that fro the list of the config files. Save all the configuration metadata under $storage->$shortname where $shortname is the shortname provided for by the config file.

this is less than the time the file was last accessed, it does not load the file/set the access time.

want to save the configuration data into (defaults to false). If true process all config data. If it is a string, then we assume that it is a version number, in which case we process all configuration data that is versioned after the specified version

file already loaded.

• Signature: public function processConfigFile($file,$process_configuration,$verbose_errors,$process_meta,$localized)
• Returns: string the shortname provided for by this config

file or null on failure. Parameters:

• string $file
  The full path to the config file. If
• mixed $process_configuration
  : Boolean -- true if you
  • Default Value: false
• boolean $verbose_errors
  defaults to true.
  • Default Value: true
• $process_meta
  • Default Value: true
• array $localized
  Data on localized versions of the
  • Default Value: array()

processRequirementsDOM()

shortnames of module we wish to be loaded.

node should have an order attribute. Optionally hey may have the attribute 'checked' meaning that we consider this node to be checked.

@param boolean $options. Defaults to false. Set to true if the new requests are optional i.e. don't cause a fatal error/add to the DOM if there a conflict

• Signature: public function processRequirementsDOM($new_requests,$requests,$optional)
• Returns: an array of the new modules that were installed on

sucess. A string on failure describing the failure reason. Parameters:

• mixed $new_requests
  a shortname or an array of
• DOMDocument $requests
  The existing requests. Each
• $optional
  • Default Value: false

recursiveScan()

• Signature: private function recursiveScan($shortnames,$extensions,$limit_to_subdir,$verbose)

Parameters:

• &$shortnames
• $extensions
• $limit_to_subdir
• $verbose

requirements()

Get a list of requirement objects for the module

• Signature: public function requirements($module)
• Returns: array List of requirement objects

Parameters:

• string $module
  Module to check.

resetCheckedPaths()

• Signature: public function resetCheckedPaths()

resetMerges()

Reset the tracked data.

• Signature: public function resetMerges()

setLocales()

Set the locales used when handingling the processing of config data.

• Signature: public function setLocales($locales)

Parameters:

• mixed $locales
  Either a string ( a locale) or an array of strings

setModulePath()

Set the module's path, usually used for testing.

• Signature: public function setModulePath($module,$path)

Parameters:

• string $module
• string $path

setRoot()

Set the root of where this I2CE instance started.

this instance of Configurator was created.

• Signature: public function setRoot($dir)
• Returns: the fully resolved path to $dir

Parameters:

• string $dir
  Directory (defaults to getcwd()) where
  • Default Value: null

setTopModule()

Set the top level module for a directory.

• Signature: public function setTopModule($dir,$module)

Parameters:

• $dir
• $module

setupFileSearch()

• Signature: private function setupFileSearch($mod,$path)

Parameters:

• $mod
  • Default Value: null
• $path
  • Default Value: "MODULES"

shallowScan()

• Signature: private function shallowScan($potential_configs,$verbose)

Parameters:

• $potential_configs
• $verbose
  • Default Value: false

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()

Fuzzy Methods

loadConfigFile_YAML()

This method is implemented by I2CE_Module_YAML->loadConfigFile_YAML()