WMDE
/
LDAPAccountManager
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

added global search and some documentation

This commit is contained in:
Roland Gruber 2006-02-25 09:48:22 +00:00
parent 88f07bfc1a
commit 68065a5715
1 changed files with 49 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
lam/lib/cache.inc
View File

@ -38,17 +38,28 @@ include_once('ldap.inc');
* @package lib * @package lib
*/ */
class cache { class cache {
/** This variable contains the cache */
var $ldapcache;
/** This variable contains a list and their scope of attributes which should be cached */
var $attributes;
/** This is the last timestamp on which the LDAP cache has been refreshed */
var $time;
/**
* Constructor.
*
* @return cache cache object
*/
function cache() { function cache() {
$this->time = 0; $this->time = 0;
$this->attributes = array(); $this->attributes = array();
} }
var $ldapcache; // This variable contains the cache /**
var $attributes; // This variable contains a list and their scope of attributes which should be cached * This function adds attributes to the cache.
var $time; // This is the laste timestamp ldap cache has been refreshed *
* @param array $attributes syntax: is array( scope1 => array ( attributes ), scope2 => array ( attributes ), ...)
/* This function adds attributes to cache
* syntax of $attributes is array( scope1 => array ( attributes ), scope2 => array ( attributes ), ...)
*/ */
function add_cache($attributes) { function add_cache($attributes) {
if (!is_array($attributes)) trigger_error('Argument of add_cache must be : array ( scope => array(attribute1(string), attribute2(string), ..), scope => ... ).', E_USER_ERROR); if (!is_array($attributes)) trigger_error('Argument of add_cache must be : array ( scope => array(attribute1(string), attribute2(string), ..), scope => ... ).', E_USER_ERROR);
@ -73,7 +84,7 @@ class cache {
* *
* @param mixed $attributes One (string) or many (array) attribute names. * @param mixed $attributes One (string) or many (array) attribute names.
* @param string $objectClass The resulting entries need to contain this object class. * @param string $objectClass The resulting entries need to contain this object class.
* @param mixed $scope the account type(s) as string or array * @param mixed $scopelist the account type(s) as string or array, all scopes if NULL given
* @return array The found LDAP entries. * @return array The found LDAP entries.
* <br>Format: array(dn1 => array(uidnumber1), dn2 => array(uidnumber2), ... ) if $attributes is of type string * <br>Format: array(dn1 => array(uidnumber1), dn2 => array(uidnumber2), ... ) if $attributes is of type string
* <br>or array(dn1 => array(uid => array(myuid), uidNumber => array(1234)), ... ) if $attributes is an array * <br>or array(dn1 => array(uid => array(myuid), uidNumber => array(1234)), ... ) if $attributes is an array
@ -83,7 +94,8 @@ class cache {
$return = array(); $return = array();
$this->refresh_cache(); $this->refresh_cache();
if (is_array($scopelist)) $scopes = $scopelist; if (is_array($scopelist)) $scopes = $scopelist;
else $scopes = array($scopelist); elseif (is_string($scopelist)) $scopes = array($scopelist);
else $scopes = getTypes();
// Add cache entry dynamic // Add cache entry dynamic
if (!is_array($attributes)) $attributes = array($attributes); if (!is_array($attributes)) $attributes = array($attributes);
$add = array(); $add = array();
@ -116,14 +128,18 @@ class cache {
return $return; return $return;
} }
/* This functions returns the dn if a dn with $attribute=$value is found /**
* $values is the value $attribute is set to * This function returns the DN if an LDAP entry with $attribute=$value is found.
* $scopelist mixed the account type(s) as string or array *
* @param string $value is the searched value of the attribute $attribute
* @param string $attribute name of the LDAP attribute
* @param mixed $scopelist the account type(s) as string or array, all scopes if NULL given
*/ */
function in_cache($value, $attribute, $scopelist) { function in_cache($value, $attribute, $scopelist) {
$this->refresh_cache(); $this->refresh_cache();
if (is_array($scopelist)) $scopes = $scopelist; if (is_array($scopelist)) $scopes = $scopelist;
else $scopes = array($scopelist); elseif (is_string($scopelist)) $scopes = array($scopelist);
else $scopes = getTypes();
// Add cache entry dynamic // Add cache entry dynamic
$add = array(); $add = array();
foreach ($scopes as $scope) { foreach ($scopes as $scope) {
@ -149,7 +165,10 @@ class cache {
} }
/* This functions refreshs the cache /**
* This function refreshes the cache.
*
* @param boolean $rebuild forces a refresh if set to true
*/ */
function refresh_cache($rebuild=false) { function refresh_cache($rebuild=false) {
if ($this->time + $_SESSION['config']->get_cacheTimeoutSec() < time() || $rebuild) { if ($this->time + $_SESSION['config']->get_cacheTimeoutSec() < time() || $rebuild) {
@ -209,8 +228,10 @@ class cache {
} }
/* This function will return an array with all groupnames /**
* found in ldap. Groupnames are taken from cache-array. * This function returns an array with all group names which were found in the LDAP directory.
*
* @return array group names
*/ */
function findgroups() { function findgroups() {
$dn_groups = $_SESSION['cache']->get_cache('cn', 'posixGroup', 'group'); $dn_groups = $_SESSION['cache']->get_cache('cn', 'posixGroup', 'group');
@ -224,8 +245,11 @@ class cache {
} }
/* This function will return the groupname to an existing gidNumber /**
* groupnames are taken from cache-array * This function returns the group name to an existing gidNumber.
*
* @param string $gidNumber GID number
* @return group name
*/ */
function getgrnam($gidNumber) { function getgrnam($gidNumber) {
$dn_groups = $_SESSION['cache']->get_cache('gidNumber', 'posixGroup', 'group'); $dn_groups = $_SESSION['cache']->get_cache('gidNumber', 'posixGroup', 'group');