30a14466166af438310a5dbc60e396faf9e36eb5
[gnucomo.git] / src / phpclasses / configuration.class.php
1 <?php
2 /**************************************************************************
3 **  (c) Copyright 2002, Andromeda Technology & Automation
4 ** This is free software; you can redistribute it and/or modify it under the
5 ** terms of the GNU General Public License, see the file COPYING.
6 ***************************************************************************/
7
8
9 /*
10 ///////////////////////////////////////////////////////////////////////////
11 //  NAME           : configuration
12 //  BASECLASS      :
13 //  MEMBERS        : 
14 //  OPERATORS      :
15 //  METHODS        : read
16 //
17 //  DESCRIPTION    : Handle configurational parameters for the application.
18 //                   Many applications need some permanently stored configurational
19 //                   data. The information is usually stored in two places: A system-
20 //                   wide configuration file and a configuration file per user.
21 //                   The content of the configuration file is in XML format.
22 //                   The configuration base class takes care of finding the configuration
23 //                   files, e.g. in /etc/app.conf or in /usr/loca/etc/app.conf
24 //                   The config files are parsed with the gnome XML parser and a
25 //                   framework is provided to find configurational items.
26 //
27 //  RELATIONS      : 
28 //  SEE ALSO       :
29 //  LAST MODIFIED  : Jul 29, 2002
30 ///////////////////////////////////////////////////////////////////////////
31 */
32
33
34 class configuration
35 {
36    var   $system, $user;
37
38    function configuration()
39    {
40       $system = false;
41       $user   = false;
42    }
43
44    function xmlFindTag($node, $tag)
45    {
46       $element = false;
47       $i = 0;
48
49       while (!$element && $i < sizeof($node))
50       {
51          if ($node[$i]->type == XML_ELEMENT_NODE && $node[$i]->tagname == $tag)
52          {
53             $element = $node[$i];
54          }
55          $i++;
56       }
57
58       return $element;
59    }
60
61    function read($app_name)
62    {
63       $filename = "/etc/" . $app_name . ".conf";
64       if (!is_readable($filename))
65       {
66          $filename = "/usr/local/etc/" . $app_name . ".conf";
67       }
68       if (is_readable($filename))
69       {
70
71          $this->system = xmldocfile($filename);
72
73          if ($this->system)
74          {
75             $root = $this->system->root();
76
77             if ($root->tagname != $app_name)
78             {
79                print("Configuration error: Wrong configuration file.<br>");
80                $this->system = false;
81             }
82          }
83       }
84       else
85       {
86          print("Configuration error: Configuration file for $app_name not found.<br>");
87       }
88    }
89
90    function find_parameter($section, $parameter)
91    {
92       $param_value = "";
93
94       if ($this->system)
95       {
96          $root_node = $this->system->root();
97          $section_node = $this->xmlFindTag($root_node->children(), $section);
98          if ($section_node)
99          {
100             $param_node = $this->xmlFindTag($section_node->children(), $parameter);
101             if ($param_node)
102             {
103                $param_node = $param_node->children();
104             }
105             if ($param_node && $param_node[0]->type == XML_TEXT_NODE)
106             {
107                $param_value = $param_node[0]->content;
108             }
109          }
110       }
111
112       return $param_value;
113    }
114 }
115
116 ?>