- phpDocumentor headers and improved docu about class methods

- coding stylite cleanup
This commit is contained in:
Ralf Becker 2009-08-22 06:58:38 +00:00
parent 109c50fecf
commit 19e6159a4a
2 changed files with 353 additions and 351 deletions

View File

@ -1,255 +1,268 @@
<?php <?php
/**************************************************************************\ /**
* eGroupWare API - Accounts manager for LDAP * * API - LDAP connection handling
* This file written by Lars Kneschke <l.kneschke@metaways.de> * *
* View and manipulate contact records using LDAP * * @link http://www.egroupware.org
* ------------------------------------------------------------------------ * * @author Lars Kneschke <l.kneschke@metaways.de>
* This library is part of the eGroupWare API * * @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
* http://www.egroupware.org/api * *
* -------------------------------------------- * * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* This program is free software; you can redistribute it and/or modify it * * @package api
* under the terms of the GNU General Public License as published by the * * @subpackage ldap
* Free Software Foundation; version 2 of the License. * * @version $Id$
\**************************************************************************/ */
/* $Id$ */ /**
* LDAP connection handling
/*! */
@class contacts class ldap
@abstract Contact List System {
@discussion Author: jengo/Milosch <br> /**
This class provides a contact database scheme. <br> * @var resource $ds holds the LDAP link identifier
It attempts to be based on the vcard 2.1 standard, with mods as needed to make for more reasonable sql storage. <br>
The LDAP schema used here may require installation of schema files available in the phpgwapi/doc/ldap dir.
Please see the README file there.
Syntax: CreateObject('phpgwapi.contacts'); <br>
Example1: $contacts = CreateObject('phpgwapi.contacts');
*/ */
class ldap var $ds;
/**
* @var array $ldapServerInfo holds the detected information about the different ldap servers
*/
var $ldapServerInfo;
/**
* the constructor for this class
*/
function __construct()
{ {
/** $this->restoreSessionData();
* @var resource $ds holds the LDAP link identifier }
*/
var $ds;
/**
* @var array $ldapServerInfo holds the detected information about the different ldap servers
*/
var $ldapServerInfo;
/**
* the constructor for this class
*/
function ldap() {
$this->restoreSessionData();
}
/**
* escapes a string for use in searchfilters meant for ldap_search.
*
* Escaped Characters are: '*', '(', ')', ' ', '\', NUL
* It's actually a PHP-Bug, that we have to escape space.
* For all other Characters, refer to RFC2254.
* @param $string either a string to be escaped, or an array of values to be escaped
*/
function getLDAPServerInfo($_host)
{
if(is_a($this->ldapServerInfo[$_host], 'ldapserverinfo')) {
return $this->ldapServerInfo[$_host];
}
return false;
}
/** /**
* escapes a string for use in searchfilters meant for ldap_search. * escapes a string for use in searchfilters meant for ldap_search.
* *
* Escaped Characters are: '*', '(', ')', ' ', '\', NUL * Escaped Characters are: '*', '(', ')', ' ', '\', NUL
* It's actually a PHP-Bug, that we have to escape space. * It's actually a PHP-Bug, that we have to escape space.
* For all other Characters, refer to RFC2254. * For all other Characters, refer to RFC2254.
* * @param $string either a string to be escaped, or an array of values to be escaped
* @param string/array $string either a string to be escaped, or an array of values to be escaped * @return ldapserverinfo|boolean
*/ */
function quote($string) function getLDAPServerInfo($_host)
{
if(is_a($this->ldapServerInfo[$_host], 'ldapserverinfo'))
{ {
return str_replace(array('\\','*','(',')','\0',' '),array('\\\\','\*','\(','\)','\\0','\20'),$string); return $this->ldapServerInfo[$_host];
} }
return false;
}
/** /**
* connect to the ldap server and return a handle * escapes a string for use in searchfilters meant for ldap_search.
* *
* @param $host ldap host * Escaped Characters are: '*', '(', ')', ' ', '\', NUL
* @param $dn ldap dn * It's actually a PHP-Bug, that we have to escape space.
* @param $passwd ldap pw * For all other Characters, refer to RFC2254.
*/ *
function ldapConnect($host='', $dn='', $passwd='') * @param string|array $string either a string to be escaped, or an array of values to be escaped
* @return string
*/
static function quote($string)
{
return str_replace(array('\\','*','(',')','\0',' '),array('\\\\','\*','\(','\)','\\0','\20'),$string);
}
/**
* connect to the ldap server and return a handle
*
* @param $host ldap host
* @param $dn ldap dn
* @param $passwd ldap pw
* @return resource|boolean resource from ldap_connect() or false on error
*/
function ldapConnect($host='', $dn='', $passwd='')
{
if(!function_exists('ldap_connect'))
{ {
if(!function_exists('ldap_connect')) /* log does not exist in setup(, yet) */
if(isset($GLOBALS['egw']->log))
{ {
/* log does not exist in setup(, yet) */ $GLOBALS['egw']->log->message('F-Abort, LDAP support unavailable');
if(isset($GLOBALS['egw']->log)) $GLOBALS['egw']->log->commit();
}
printf('<b>Error: LDAP support unavailable</b><br>',$host);
return False;
}
if(!$host)
{
$host = $GLOBALS['egw_info']['server']['ldap_host'];
}
if(!$dn)
{
$dn = $GLOBALS['egw_info']['server']['ldap_root_dn'];
}
if(!$passwd)
{
$passwd = $GLOBALS['egw_info']['server']['ldap_root_pw'];
}
// connects to ldap server
if(!$this->ds = ldap_connect($host))
{
/* log does not exist in setup(, yet) */
if(isset($GLOBALS['egw']->log))
{
$GLOBALS['egw']->log->message('F-Abort, Failed connecting to LDAP server');
$GLOBALS['egw']->log->commit();
}
printf("<b>Error: Can't connect to LDAP server %s!</b><br>",$host);
echo function_backtrace(1);
return False;
}
if(ldap_set_option($this->ds, LDAP_OPT_PROTOCOL_VERSION, 3))
{
$supportedLDAPVersion = 3;
}
else
{
$supportedLDAPVersion = 2;
}
if(!isset($this->ldapServerInfo[$host]))
{
//error_log("no ldap server info found");
$ldapbind = @ldap_bind($this->ds, $GLOBALS['egw_info']['server']['ldap_root_dn'], $GLOBALS['egw_info']['server']['ldap_root_pw']);
$filter='(objectclass=*)';
$justthese = array('structuralObjectClass','namingContexts','supportedLDAPVersion','subschemaSubentry');
if(($sr = @ldap_read($this->ds, '', $filter, $justthese)))
{
if($info = ldap_get_entries($this->ds, $sr))
{ {
$GLOBALS['egw']->log->message('F-Abort, LDAP support unavailable'); $ldapServerInfo = new ldapserverinfo();
$GLOBALS['egw']->log->commit();
}
printf('<b>Error: LDAP support unavailable</b><br>',$host); $ldapServerInfo->setVersion($supportedLDAPVersion);
return False;
}
if(!$host)
{
$host = $GLOBALS['egw_info']['server']['ldap_host'];
}
if(!$dn) // check for naming contexts
{ if($info[0]['namingcontexts'])
$dn = $GLOBALS['egw_info']['server']['ldap_root_dn']; {
} for($i=0; $i<$info[0]['namingcontexts']['count']; $i++)
{
if(!$passwd) $namingcontexts[] = $info[0]['namingcontexts'][$i];
{
$passwd = $GLOBALS['egw_info']['server']['ldap_root_pw'];
}
// connects to ldap server
if(!$this->ds = ldap_connect($host))
{
/* log does not exist in setup(, yet) */
if(isset($GLOBALS['egw']->log))
{
$GLOBALS['egw']->log->message('F-Abort, Failed connecting to LDAP server');
$GLOBALS['egw']->log->commit();
}
printf("<b>Error: Can't connect to LDAP server %s!</b><br>",$host);
echo function_backtrace(1);
return False;
}
if(ldap_set_option($this->ds, LDAP_OPT_PROTOCOL_VERSION, 3)) {
$supportedLDAPVersion = 3;
} else {
$supportedLDAPVersion = 2;
}
if(!isset($this->ldapServerInfo[$host])) {
//error_log("no ldap server info found");
$ldapbind = @ldap_bind($this->ds, $GLOBALS['egw_info']['server']['ldap_root_dn'], $GLOBALS['egw_info']['server']['ldap_root_pw']);
$filter='(objectclass=*)';
$justthese = array('structuralObjectClass','namingContexts','supportedLDAPVersion','subschemaSubentry');
if(($sr = @ldap_read($this->ds, '', $filter, $justthese))) {
if($info = ldap_get_entries($this->ds, $sr)) {
$ldapServerInfo = new ldapserverinfo();
$ldapServerInfo->setVersion($supportedLDAPVersion);
// check for naming contexts
if($info[0]['namingcontexts']) {
for($i=0; $i<$info[0]['namingcontexts']['count']; $i++) {
$namingcontexts[] = $info[0]['namingcontexts'][$i];
}
$ldapServerInfo->setNamingContexts($namingcontexts);
} }
$ldapServerInfo->setNamingContexts($namingcontexts);
}
// check for ldap server type // check for ldap server type
if($info[0]['structuralobjectclass']) { if($info[0]['structuralobjectclass'])
switch($info[0]['structuralobjectclass'][0]) { {
case 'OpenLDAProotDSE': switch($info[0]['structuralobjectclass'][0])
$ldapServerType = OPENLDAP_LDAPSERVER; {
break; case 'OpenLDAProotDSE':
default: $ldapServerType = OPENLDAP_LDAPSERVER;
$ldapServerType = UNKNOWN_LDAPSERVER; break;
break; default:
} $ldapServerType = UNKNOWN_LDAPSERVER;
$ldapServerInfo->setServerType($ldapServerType); break;
}
// check for subschema entry dn
if($info[0]['subschemasubentry']) {
$subschemasubentry = $info[0]['subschemasubentry'][0];
$ldapServerInfo->setSubSchemaEntry($subschemasubentry);
} }
$ldapServerInfo->setServerType($ldapServerType);
}
// create list of supported objetclasses // check for subschema entry dn
if(!empty($subschemasubentry)) { if($info[0]['subschemasubentry'])
$filter='(objectclass=*)'; {
$justthese = array('objectClasses'); $subschemasubentry = $info[0]['subschemasubentry'][0];
$ldapServerInfo->setSubSchemaEntry($subschemasubentry);
if($sr=ldap_read($this->ds, $subschemasubentry, $filter, $justthese)) { }
if($info = ldap_get_entries($this->ds, $sr)) {
if($info[0]['objectclasses']) { // create list of supported objetclasses
for($i=0; $i<$info[0]['objectclasses']['count']; $i++) { if(!empty($subschemasubentry))
$pattern = '/^\( (.*) NAME \'(\w*)\' /'; {
if(preg_match($pattern, $info[0]['objectclasses'][$i], $matches)) { $filter='(objectclass=*)';
#_debug_array($matches); $justthese = array('objectClasses');
if(count($matches) == 3) {
$supportedObjectClasses[$matches[1]] = strtolower($matches[2]); if($sr=ldap_read($this->ds, $subschemasubentry, $filter, $justthese))
} {
if($info = ldap_get_entries($this->ds, $sr))
{
if($info[0]['objectclasses']) {
for($i=0; $i<$info[0]['objectclasses']['count']; $i++)
{
$pattern = '/^\( (.*) NAME \'(\w*)\' /';
if(preg_match($pattern, $info[0]['objectclasses'][$i], $matches))
{
#_debug_array($matches);
if(count($matches) == 3)
{
$supportedObjectClasses[$matches[1]] = strtolower($matches[2]);
} }
} }
$ldapServerInfo->setSupportedObjectClasses($supportedObjectClasses);
} }
$ldapServerInfo->setSupportedObjectClasses($supportedObjectClasses);
} }
} }
} }
$this->ldapServerInfo[$host] = $ldapServerInfo;
} }
} else { $this->ldapServerInfo[$host] = $ldapServerInfo;
$this->ldapServerInfo[$host] = false;
} }
$this->saveSessionData();
} else {
$ldapServerInfo = $this->ldapServerInfo[$host];
} }
else
if(!@ldap_bind($this->ds, $dn, $passwd)) {
if(isset($GLOBALS['egw']->log)) {
$GLOBALS['egw']->log->message('F-Abort, Failed binding to LDAP server');
$GLOBALS['egw']->log->commit();
}
printf("<b>Error: Can't bind to LDAP server: %s!</b> %s<br />",$dn,function_backtrace(1));
return False;
}
return $this->ds;
}
/**
* disconnect from the ldap server
*/
function ldapDisconnect()
{
if(is_resource($this->ds))
{ {
ldap_unbind($this->ds); $this->ldapServerInfo[$host] = false;
} }
$this->saveSessionData();
} }
else
/**
* restore the session data
*/
function restoreSessionData()
{ {
if (isset($GLOBALS['egw']->session)) // no availible in setup $ldapServerInfo = $this->ldapServerInfo[$host];
{
$this->ldapServerInfo = (array) unserialize($GLOBALS['egw']->session->appsession('ldapServerInfo'));
}
} }
/**
* save the session data if(!@ldap_bind($this->ds, $dn, $passwd))
*/
function saveSessionData()
{ {
if (isset($GLOBALS['egw']->session)) // no availible in setup if(isset($GLOBALS['egw']->log))
{ {
$GLOBALS['egw']->session->appsession('ldapServerInfo','',serialize($this->ldapServerInfo)); $GLOBALS['egw']->log->message('F-Abort, Failed binding to LDAP server');
$GLOBALS['egw']->log->commit();
} }
printf("<b>Error: Can't bind to LDAP server: %s!</b> %s<br />",$dn,function_backtrace(1));
return False;
} }
return $this->ds;
} }
?>
/**
* disconnect from the ldap server
*/
function ldapDisconnect()
{
if(is_resource($this->ds))
{
ldap_unbind($this->ds);
}
}
/**
* restore the session data
*/
function restoreSessionData()
{
if (isset($GLOBALS['egw']->session)) // no availible in setup
{
$this->ldapServerInfo = (array) unserialize($GLOBALS['egw']->session->appsession('ldapServerInfo'));
}
}
/**
* save the session data
*/
function saveSessionData()
{
if (isset($GLOBALS['egw']->session)) // no availible in setup
{
$GLOBALS['egw']->session->appsession('ldapServerInfo','',serialize($this->ldapServerInfo));
}
}
}

View File

@ -1,137 +1,126 @@
<?php <?php
/**************************************************************************\ /**
* eGroupWare API - Accounts manager for LDAP * * API - LDAP server information
* This file written by Lars Kneschke <l.kneschke@metaways.de> * *
* View and manipulate contact records using LDAP * * @link http://www.egroupware.org
* ------------------------------------------------------------------------ * * @author Lars Kneschke <l.kneschke@metaways.de>
* This library is part of the eGroupWare API * *
* http://www.egroupware.org/api * * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* -------------------------------------------- * * @package api
* This program is free software; you can redistribute it and/or modify it * * @subpackage ldap
* under the terms of the GNU General Public License as published by the * * @version $Id$
* Free Software Foundation; version 2 of the License. * */
\**************************************************************************/
/* $Id$ */
define('UNKNOWN_LDAPSERVER',0); define('UNKNOWN_LDAPSERVER',0);
define('OPENLDAP_LDAPSERVER',1); define('OPENLDAP_LDAPSERVER',1);
/*! /**
@class contacts * Class to store and retrieve information (eg. supported object classes) of a connected ldap server
@abstract Contact List System */
@discussion Author: jengo/Milosch <br> class ldapserverinfo
This class provides a contact database scheme. <br> {
It attempts to be based on the vcard 2.1 standard, with mods as needed to make for more reasonable sql storage. <br> /**
The LDAP schema used here may require installation of schema files available in the phpgwapi/doc/ldap dir. * @var array $namingContext holds the supported namingcontexts
Please see the README file there.
Syntax: CreateObject('phpgwapi.contacts'); <br>
Example1: $contacts = CreateObject('phpgwapi.contacts');
*/ */
class ldapserverinfo var $namingContext = array();
/**
* @var string $version holds the LDAP server version
*/
var $version = 2;
/**
* @var integer $serverType holds the type of LDAP server(OpenLDAP, ADS, NDS, ...)
*/
var $serverType = 0;
/**
* @var string $_subSchemaEntry the subschema entry DN
*/
var $subSchemaEntry = '';
/**
* @var array $supportedObjectClasses the supported objectclasses
*/
var $supportedObjectClasses = array();
/**
* @var array $supportedOIDs the supported OIDs
*/
var $supportedOIDs = array();
/**
* gets the version
*
* @return integer the supported ldap version
*/
function getVersion()
{ {
/** return $this->version;
* @var array $namingContext holds the supported namingcontexts
*/
var $namingContext = array();
/**
* @var string $version holds the LDAP server version
*/
var $version = 2;
/**
* @var integer $serverType holds the type of LDAP server(OpenLDAP, ADS, NDS, ...)
*/
var $serverType = 0;
/**
* @var string $_subSchemaEntry the subschema entry DN
*/
var $subSchemaEntry = '';
/**
* @var array $supportedObjectClasses the supported objectclasses
*/
var $supportedObjectClasses = array();
/**
* @var array $supportedOIDs the supported OIDs
*/
var $supportedOIDs = array();
/**
* the constructor for this class
*/
/*function ldapserverinfo() {
}*/
/**
* gets the version
*
* @return integer the supported ldap version
*/
function getVersion() {
return $this->version;
}
/**
* sets the namingcontexts
*
* @param array $_namingContext the supported namingcontexts
*/
function setNamingContexts($_namingContext) {
$this->namingContext = $_namingContext;
}
/**
* sets the type of the ldap server(OpenLDAP, ADS, NDS, ...)
*
* @param integer $_serverType the type of ldap server
*/
function setServerType($_serverType) {
$this->serverType = $_serverType;
}
/**
* sets the DN for the subschema entry
*
* @param string $_subSchemaEntry the subschema entry DN
*/
function setSubSchemaEntry($_subSchemaEntry) {
$this->subSchemaEntry = $_subSchemaEntry;
}
/**
* sets the supported objectclasses
*
* @param array $_supportedObjectClasses the supported objectclasses
*/
function setSupportedObjectClasses($_supportedObjectClasses) {
$this->supportedOIDs = $_supportedObjectClasses;
$this->supportedObjectClasses = array_flip($_supportedObjectClasses);
}
/**
* sets the version
*
* @param integer $_version the supported ldap version
*/
function setVersion($_version) {
$this->version = $_version;
}
/**
* checks for supported objectclasses
*
* @return bool returns true if the ldap server supports this objectclass
*/
function supportsObjectClass($_objectClass) {
if($this->supportedObjectClasses[strtolower($_objectClass)]) {
return true;
} else {
return false;
}
}
} }
?>
/**
* sets the namingcontexts
*
* @param array $_namingContext the supported namingcontexts
*/
function setNamingContexts($_namingContext)
{
$this->namingContext = $_namingContext;
}
/**
* sets the type of the ldap server(OpenLDAP, ADS, NDS, ...)
*
* @param integer $_serverType the type of ldap server
*/
function setServerType($_serverType)
{
$this->serverType = $_serverType;
}
/**
* sets the DN for the subschema entry
*
* @param string $_subSchemaEntry the subschema entry DN
*/
function setSubSchemaEntry($_subSchemaEntry)
{
$this->subSchemaEntry = $_subSchemaEntry;
}
/**
* sets the supported objectclasses
*
* @param array $_supportedObjectClasses the supported objectclasses
*/
function setSupportedObjectClasses($_supportedObjectClasses)
{
$this->supportedOIDs = $_supportedObjectClasses;
$this->supportedObjectClasses = array_flip($_supportedObjectClasses);
}
/**
* sets the version
*
* @param integer $_version the supported ldap version
*/
function setVersion($_version)
{
$this->version = $_version;
}
/**
* checks for supported objectclasses
*
* @return bool returns true if the ldap server supports this objectclass
*/
function supportsObjectClass($_objectClass)
{
if($this->supportedObjectClasses[strtolower($_objectClass)])
{
return true;
}
return false;
}
}