]> git.llucax.com Git - mecon/samurai.git/blob - lib/SAMURAI/Perm.php
Documentacion para el Doxygen de la libreria de perl.
[mecon/samurai.git] / lib / SAMURAI / Perm.php
1 <?php
2 // vim: set binary expandtab tabstop=4 shiftwidth=4:
3 // +--------------------------------------------------------------------+
4 // |                      Ministerio de Economía                        |
5 // |                             SAMURAI                                |
6 // +--------------------------------------------------------------------+
7 // | This file is part of SAMURAI.                                      |
8 // |                                                                    |
9 // | SAMURAI is free software; you can redistribute it and/or modify    |
10 // | it under the terms of the GNU General Public License as published  |
11 // | by the Free Software Foundation; either version 2 of the License,  |
12 // | or (at your option) any later version.                             |
13 // |                                                                    |
14 // | SAMURAI is distributed in the hope that it will be useful, but     |
15 // | WITHOUT ANY WARRANTY; without even the implied warranty of         |
16 // | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU   |
17 // | General Public License for more details.                           |
18 // |                                                                    |
19 // | You should have received a copy of the GNU General Public License  |
20 // | along with SAMURAI; if not, write to the Free Software Foundation, |
21 // | Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA      |
22 // +--------------------------------------------------------------------+
23 // | Creado: Fri Jul 18 16:05:22 2003                                   |
24 // | Autor:  Leandro Lucarella <llucar@mecon.gov.ar>                    |
25 // +--------------------------------------------------------------------+
26 //
27 // $Id$
28 //
29
30 // +X2C Class 377 :SAMURAI_Perm
31 /**
32  * Chequeador de permisos.
33 Para la libreria de perl: 
34 @see perm.epl
35  *
36  * @package SAMURAI
37  * @access public
38  */
39 class SAMURAI_Perm {
40     /**
41      * Permisos. Es un array asociativo, donde la clave es un identificador de sistema y el valor un array con los permisos que tiene para ese sistema.
42      *
43      * @var    array $permisos
44      * @access protected
45      */
46     var $_permisos = array();
47
48     /**
49      * Sistema usado actualmente.
50      *
51      * @var    int $sistema
52      * @access protected
53      */
54     var $_sistema;
55
56     /**
57      * Base de datos a usar en las conexiones.
58      *
59      * @var    DB $db
60      * @access protected
61      */
62     var $_db;
63
64     /**
65      * Observaciones de los permisos.
66      *
67      * @var    array $observaciones
68      * @access protected
69      */
70     var $_observaciones = array();
71
72     /**
73      * Sets Sistema.
74      *
75      * @param  int $sistema Sistema.
76      *
77      * @return void
78      * @access public
79      */
80     function setSistema($sistema)
81     {
82         $this->_sistema = $sistema;
83     }
84
85     // ~X2C
86
87     // +X2C Operation 380
88     /**
89      * Constructor.
90      *
91      * @param  int $login Login del usuario para el cual obtener los permisos.
92      * @param  int $sistema Sistema con el cual se va a trabajar.
93      * @param  DB &$db Base de datos a usar.
94      *
95      * @return void
96      * @access public
97      */
98     function SAMURAI_Perm($login, $sistema, &$db) // ~X2C
99     {
100         $this->_sistema = $sistema;
101         $query = '
102             SELECT DISTINCT psu.id_sistema AS sistema, pps.id_permiso AS permiso
103             FROM samurai.perfil_sist_usuario AS psu, samurai.perm_perfil_sist AS pps
104             WHERE psu.login = '.$db->quote($login).' AND psu.id_perfil = pps.id_perfil
105             AND psu.id_sistema = pps.id_sistema';
106         foreach ($db->getAll($query, DB_FETCHMODE_ASSOC) as $row) {
107             $this->_permisos[$row['sistema']][] = $row['permiso'];
108         }
109         $this->_db =& $db;
110     }
111     // -X2C
112
113     // +X2C Operation 381
114     /**
115      * Verifica si tiene un permiso.
116 Se puede pasar parametros variables con un identificador de permiso o un array, por ejemplo: $perm->tiene(1, 4, array(2, 5, 67), 12); Si tiene algun permiso devuelve true.
117 Si no se pasa ningun parametro ($perm->tiene()), devuelve true si tiene un permiso (al menos uno) en el sistema actual.
118 @see chequear()
119      *
120      * @return bool
121      * @access public
122      */
123     function tiene() // ~X2C
124     {
125         $args = func_get_args();
126         if (!$args) {
127             return (boolean) @$this->_permisos[$this->_sistema];
128         } else {
129             foreach ($args as $arg) {
130                 if (is_array($arg)) {
131                      if (@array_intersect($arg, $this->_permisos[$this->_sistema])) {
132                         return true;
133                      }
134                 } else {
135                      if (@in_array($arg, $this->_permisos[$this->_sistema])) {
136                         return true;
137                      }
138                 }
139             }
140             return false;
141         }
142     }
143     // -X2C
144
145
146     // +X2C Operation 385
147     /**
148      * Obtiene una lista de permisos. Si se especifica un sistema, obtiene la lista de permisos para ese sistema.
149      *
150      * @param  int $sistema Sistema del cual obtener la lista de permisos.
151      *
152      * @return array
153      * @access public
154      */
155     function getPermisos($sistema = null) // ~X2C
156     {
157         $sistema = is_null($sistema) ? $this->_sistema : $sistema;
158         return @$this->_permisos[$sistema] ? $this->_permisos[$sistema] : array();
159     }
160     // -X2C
161
162     // +X2C Operation 388
163     /**
164      * @return void
165      * @access public
166      */
167     function chequear() // ~X2C
168     {
169         $args = func_get_args();
170         if (!call_user_func_array(array($this, 'tiene'), $args)) {
171             include 'MECON/includes/no_autorizado.html';
172             exit;
173         }
174     }
175     // -X2C
176
177     // +X2C Operation 391
178     /**
179      * Obtiene las observaciones de un permiso para un sistema.
180      *
181      * @param  int $perm Obtiene las observaciones de un permiso para un sistema.
182      * @param  int $sistema Sistema al cual pertenecen los permisos.
183      *
184      * @return array
185      * @access public
186      */
187     function getObservaciones($perm, $sistema = null) // ~X2C
188     {
189         $sistema = is_null($sistema) ? $this->_sistema : $sistema;
190         if (!@is_array($this->_observaciones[$sistema][$perm])) {
191             $this->_observaciones[$sistema][$perm] = array();
192             $query = '
193                 SELECT ps.observaciones AS observaciones
194                 FROM samurai.perm_sist AS ps
195                 WHERE ps.id_permiso = '.$this->_db->quote($perm).'
196                   AND ps.id_sistema = '.$this->_db->quote($sistema);
197             foreach ($this->_db->getAll($query, DB_FETCHMODE_ASSOC) as $row) {
198                 $this->_observaciones[$sistema][$perm][] = $row['observaciones'];
199             }
200         }
201         return $this->_observaciones[$sistema][$perm];
202     }
203     // -X2C
204
205 } // -X2C Class :SAMURAI_Perm
206
207 ?>