API - XOOPS 2.5.11 Beta 2
By monxoops.fr
Config_File Class Reference

Public Member Functions

 __construct ($config_path=NULL)
 
 set_path ($config_path)
 
 get ($file_name, $section_name=NULL, $var_name=NULL)
 
get_key ($config_key)
 
 get_file_names ()
 
 get_section_names ($file_name)
 
 get_var_names ($file_name, $section=NULL)
 
 clear ($file_name=NULL)
 
 load_file ($file_name, $prepend_path=true)
 
 set_file_contents ($config_file, $contents)
 
 parse_contents ($contents)
 
 _set_config_var (&$container, $var_name, $var_value, $booleanize)
 
 _trigger_error_msg ($error_msg, $error_type=E_USER_WARNING)
 

Data Fields

 $overwrite = true
 
 $booleanize = true
 
 $read_hidden = true
 
 $fix_newlines = true
 
 $_config_path = ""
 
 $_config_data = array()
 

Constructor & Destructor Documentation

◆ __construct()

__construct (   $config_path = NULL)

#- Constructs a new config file class.

Parameters
string$config_path(optional) path to the config files
Here is the call graph for this function:

Member Function Documentation

◆ _set_config_var()

_set_config_var ( $container,
  $var_name,
  $var_value,
  $booleanize 
)

#+ @access private

Parameters
array&$container
string$var_name
mixed$var_value
boolean$booleanizedetermines whether $var_value is converted to to true/false
Here is the call graph for this function:
Here is the caller graph for this function:

◆ _trigger_error_msg()

_trigger_error_msg (   $error_msg,
  $error_type = E_USER_WARNING 
)

@uses trigger_error() creates a PHP warning/error

Parameters
string$error_msg
integer$error_typeone of
Here is the caller graph for this function:

◆ clear()

clear (   $file_name = NULL)

Clear loaded config data for a certain file or all files.

Parameters
string$file_namefile to clear config data for

◆ get()

get (   $file_name,
  $section_name = NULL,
  $var_name = NULL 
)

Retrieves config info based on the file, section, and variable name.

Parameters
string$file_nameconfig file to get info for
string$section_name(optional) section to get info for
string$var_name(optional) variable to get info for
Returns
string|array a value or array of values
Here is the call graph for this function:

◆ get_file_names()

get_file_names ( )

Get all loaded config file names.

Returns
array an array of loaded config file names

◆ get_key()

& get_key (   $config_key)

Retrieves config info based on the key.

Parameters
$file_namestring config key (filename/section/var)
Returns
string|array same as get() @uses get() retrieves information from config file and returns it

◆ get_section_names()

get_section_names (   $file_name)

Get all section names from a loaded file.

Parameters
string$file_nameconfig file to get section names from
Returns
array an array of section names from the specified file
Here is the call graph for this function:

◆ get_var_names()

get_var_names (   $file_name,
  $section = NULL 
)

Get all global or section variable names.

Parameters
string$file_nameconfig file to get info for
string$section_name(optional) section to get info for
Returns
array an array of variables names from the specified file/section
Here is the call graph for this function:

◆ load_file()

load_file (   $file_name,
  $prepend_path = true 
)

Load a configuration file manually.

Parameters
string$file_namefile name to load
boolean$prepend_pathwhether current config path should be prepended to the filename
Here is the call graph for this function:
Here is the caller graph for this function:

◆ parse_contents()

parse_contents (   $contents)

parse the source of a configuration file manually.

Parameters
string$contentsthe file-contents to parse
Here is the call graph for this function:
Here is the caller graph for this function:

◆ set_file_contents()

set_file_contents (   $config_file,
  $contents 
)

Store the contents of a file manually.

Parameters
string$config_filefile name of the related contents
string$contentsthe file-contents to parse
Here is the call graph for this function:

◆ set_path()

set_path (   $config_path)

Set the path where configuration files can be found.

Parameters
string$config_pathpath to the config files
Here is the call graph for this function:
Here is the caller graph for this function:

Field Documentation

◆ $_config_data

$_config_data = array()

◆ $_config_path

$_config_path = ""

#- @access private

◆ $booleanize

$booleanize = true

Controls whether config values of on/true/yes and off/false/no get converted to boolean values automatically.

◆ $fix_newlines

$fix_newlines = true

Controls whether or not to fix mac or dos formatted newlines. If set to true, \r or \r
will be changed to
.

◆ $overwrite

$overwrite = true

Controls whether variables with the same name overwrite each other.

◆ $read_hidden

$read_hidden = true

Controls whether hidden config sections/vars are read from the file.


The documentation for this class was generated from the following file: