soap server Base class for all SOAP registered methods. More...

Inheritance diagram for ilSoapAdministration:

Collaboration diagram for ilSoapAdministration:

Public Member Functions
	__construct (bool $use_nusoap=true)

	getMessage ()

	appendMessage (string $a_str)

	setMessageCode (string $a_code)

	getMessageCode ()

	reInitUser ()

	isFault ($object)

	getInstallationInfoXML ()

	getClientInfoXML (string $clientid)

Data Fields
const	NUSOAP = 1

const	PHP5 = 2

int	$error_method
	Defines type of error handling (PHP5 \|\| NUSOAP) More...

Protected Member Functions
	checkSession (string $sid)

	explodeSid (string $sid)

	setMessage (string $a_str)

	initAuth (string $sid)

	initIlias ()

	initAuthenticationObject ()

	raiseError (string $a_message, $a_code)

	checkObjectAccess (int $ref_id, array $expected_type, string $permission, bool $returnObject=false)
	check access for ref id: expected type, permission, return object instance if returnobject is true More...

Protected Attributes
bool	$soap_check = true

string	$message = ''

string	$message_code = ''

Detailed Description

soap server Base class for all SOAP registered methods.

E.g ilSoapUserAdministration

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 30 of file class.ilSoapAdministration.php.

Constructor & Destructor Documentation

◆ __construct()

ilSoapAdministration::__construct ( bool $use_nusoap = true )

Reimplemented in ilSoapBackgroundTasksAdministration.

Definition at line 44 of file class.ilSoapAdministration.php.

    {
        if (
            defined('IL_SOAPMODE') &&
            defined('IL_SOAPMODE_NUSOAP') &&
            IL_SOAPMODE == IL_SOAPMODE_NUSOAP
        ) {
            $this->error_method = self::NUSOAP;
        } else {
            $this->error_method = self::PHP5;
        }
 
        $this->initAuthenticationObject();
    }

References IL_SOAPMODE, IL_SOAPMODE_NUSOAP, initAuthenticationObject(), NUSOAP, and PHP5.

Here is the call graph for this function:

Member Function Documentation

◆ appendMessage()

ilSoapAdministration::appendMessage ( string $a_str )

Definition at line 117 of file class.ilSoapAdministration.php.

                                                : void
    {
        $this->message .= isset($this->message) ? ' ' : '';
        $this->message .= $a_str;
    }

◆ checkObjectAccess()

ilSoapAdministration::checkObjectAccess	(	int	$ref_id,
		array	$expected_type,
		string	$permission,
		bool	$returnObject = `false`
	)

protected

check access for ref id: expected type, permission, return object instance if returnobject is true

Definition at line 208 of file class.ilSoapAdministration.php.

      {
        global $DIC;
 
        $rbacsystem = $DIC->rbac()->system();
 
        if (!ilObject::_exists($ref_id, true)) {
            return $this->raiseError(
                'No object for id.',
                'CLIENT_OBJECT_NOT_FOUND'
            );
        }
 
        if (ilObject::_isInTrash($ref_id)) {
            return $this->raiseError(
                'Object is already trashed.',
                'CLIENT_OBJECT_DELETED'
            );
        }
 
        $type = ilObject::_lookupType(ilObject::_lookupObjId($ref_id));
        if (!in_array($type, $expected_type, true)) {
            return $this->raiseError(
                "Wrong type $type for id. Expected: " . implode(",", $expected_type),
                'CLIENT_OBJECT_WRONG_TYPE'
            );
        }
        if (!$rbacsystem->checkAccess($permission, $ref_id, $type)) {
            return $this->raiseError(
                'Missing permission $permission for type $type.',
                'CLIENT_OBJECT_WRONG_PERMISSION'
            );
        }
        if ($returnObject) {
            try {
                return ilObjectFactory::getInstanceByRefId($ref_id);
            } catch (ilObjectNotFoundException $e) {
                return $this->raiseError('No valid ref_id given', 'Client');
            }
        }
        return $type;
    }

References $DIC, Vendor\Package\$e, $ref_id, $type, ilObject\_exists(), ilObject\_isInTrash(), ilObject\_lookupObjId(), ilObject\_lookupType(), ilObjectFactory\getInstanceByRefId(), and raiseError().

Referenced by ilSoapCourseAdministration\getCoursesForUser(), ilSoapGroupAdministration\getGroupsForUser(), and ilSoapUserAdministration\getUsersForContainer().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkSession()

ilSoapAdministration::checkSession ( string $sid )

protected

Definition at line 59 of file class.ilSoapAdministration.php.

                                                : bool
    {
        global $DIC;
 
        $ilUser = $DIC->user();
 
        [$sid, $client] = $this->explodeSid($sid);
 
        if ($sid === '') {
            $this->setMessage('No session id given');
            $this->setMessageCode('Client');
            return false;
        }
        if (!$client) {
            $this->setMessage('No client given');
            $this->setMessageCode('Client');
            return false;
        }
 
        if (!$GLOBALS['DIC']['ilAuthSession']->isAuthenticated()) {
            $this->setMessage('Session invalid');
            $this->setMessageCode('Client');
            return false;
        }
 
        if ($ilUser->hasToAcceptTermsOfService()) {
            $this->setMessage('User agreement no accepted.');
            $this->setMessageCode('Server');
            return false;
        }
 
        if ($this->soap_check) {
            $set = new ilSetting();
            $this->setMessage('SOAP is not enabled in ILIAS administration for this client');
            $this->setMessageCode('Server');
            return ((int) $set->get("soap_user_administration", '0')) === 1;
        }
 
        return true;
    }

References $client, $DIC, $GLOBALS, $ilUser, explodeSid(), setMessage(), and setMessageCode().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ explodeSid()

ilSoapAdministration::explodeSid ( string $sid )

protected

Definition at line 100 of file class.ilSoapAdministration.php.

                                              : array
    {
        $exploded = explode('::', $sid);
 
        return is_array($exploded) ? $exploded : array('sid' => '', 'client' => '');
    }

Referenced by checkSession(), and initAuth().

Here is the caller graph for this function:

◆ getClientInfoXML()

ilSoapAdministration::getClientInfoXML ( string $clientid )

Returns: soap_fault|SoapFault|string|null

Definition at line 278 of file class.ilSoapAdministration.php.

    {
        $this->initIlias();
        if (!defined("ILIAS_WEB_DIR")) {
            define('ILIAS_WEB_DIR', dirname(__DIR__, 3) . "/data/");
        }
        $clientdir = ILIAS_WEB_DIR . "/" . $clientid;
 
        require_once("webservice/soap/classes/class.ilSoapInstallationInfoXMLWriter.php");
        $writer = new ilSoapInstallationInfoXMLWriter();
        $writer->start();
        if (!$writer->addClient($clientdir)) {
            return $this->raiseError(
                'Client ID ' . $clientid . 'does not exist!',
                'Client'
            );
        }
        $writer->end();
        return $writer->getXML();
    }

References ILIAS_WEB_DIR, initIlias(), and raiseError().

Here is the call graph for this function:

◆ getInstallationInfoXML()

ilSoapAdministration::getInstallationInfoXML ( )

Definition at line 255 of file class.ilSoapAdministration.php.

                                            : string
    {
        $this->initIlias();
        if (!defined("ILIAS_WEB_DIR")) {
            define('ILIAS_WEB_DIR', dirname(__DIR__, 3) . "/data/");
        }
 
        $clientdirs = glob(ILIAS_WEB_DIR . "/*", GLOB_ONLYDIR);
        require_once("webservice/soap/classes/class.ilSoapInstallationInfoXMLWriter.php");
        $writer = new ilSoapInstallationInfoXMLWriter();
        $writer->start();
        if (is_array($clientdirs)) {
            foreach ($clientdirs as $clientdir) {
                $writer->addClient($clientdir);
            }
        }
        $writer->end();
        return $writer->getXML();
    }

References ILIAS_WEB_DIR, and initIlias().

Here is the call graph for this function:

◆ getMessage()

ilSoapAdministration::getMessage ( )

Definition at line 112 of file class.ilSoapAdministration.php.

                                : string
    {
        return $this->message;
    }

References $message.

Here is the caller graph for this function:

◆ getMessageCode()

ilSoapAdministration::getMessageCode ( )

Definition at line 128 of file class.ilSoapAdministration.php.

                                    : string
    {
        return $this->message_code;
    }

References $message_code.

Here is the caller graph for this function:

◆ initAuth()

ilSoapAdministration::initAuth ( string $sid )

protected

Definition at line 133 of file class.ilSoapAdministration.php.

                                            : void
    {
        global $DIC;
 
        [$sid, $client] = $this->explodeSid($sid);
 
        if (session_status() === PHP_SESSION_ACTIVE && $sid === session_id()) {
            return;
        }
 
        if (session_status() === PHP_SESSION_ACTIVE) {
            session_destroy();
        }
 
        session_id($sid);
    }

References $client, $DIC, and explodeSid().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initAuthenticationObject()

ilSoapAdministration::initAuthenticationObject ( )

protected

Definition at line 172 of file class.ilSoapAdministration.php.

                                                 : void
    {
        include_once './Services/Authentication/classes/class.ilAuthFactory.php';
        ilAuthFactory::setContext(ilAuthFactory::CONTEXT_SOAP);
    }

References ilAuthFactory\CONTEXT_SOAP, and ilAuthFactory\setContext().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initIlias()

ilSoapAdministration::initIlias ( )

protected

Definition at line 150 of file class.ilSoapAdministration.php.

                                  : void
    {
        if (ilContext::getType() === ilContext::CONTEXT_SOAP) {
            try {
                require_once("Services/Init/classes/class.ilInitialisation.php");
                ilInitialisation::reinitILIAS();
            } catch (Exception $e) {
            }
        }
    }

References Vendor\Package\$e, ilContext\CONTEXT_SOAP, ilContext\getType(), and ilInitialisation\reinitILIAS().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isFault()

ilSoapAdministration::isFault ( $object )

Definition at line 194 of file class.ilSoapAdministration.php.

                                    : bool
    {
        switch ($this->error_method) {
            case self::NUSOAP:
                return $object instanceof soap_fault;
            case self::PHP5:
                return $object instanceof SoapFault;
        }
        return true;
    }

References NUSOAP, and PHP5.

Referenced by ilSoapObjectAdministration\copyObject(), ilSoapUserAdministration\getUsersForContainer(), ilSoapObjectAdministration\moveObject(), and ilSoapObjectAdministration\validateReferences().

Here is the caller graph for this function:

◆ raiseError()

ilSoapAdministration::raiseError	(	string	$a_message,
			$a_code
	)

protected

Parameters

string	$a_message
string \| int	$a_code

Returns: soap_fault|SoapFault|null

Reimplemented in ilAbstractSoapMethod.

Definition at line 183 of file class.ilSoapAdministration.php.

    {
        switch ($this->error_method) {
            case self::NUSOAP:
                return new soap_fault($a_code, '', $a_message);
            case self::PHP5:
                return new SoapFault($a_code, $a_message);
        }
        return null;
    }

References NUSOAP, and PHP5.

Here is the caller graph for this function:

◆ reInitUser()

ilSoapAdministration::reInitUser ( )

Definition at line 161 of file class.ilSoapAdministration.php.

                                : void
    {
        if (ilContext::getType() === ilContext::CONTEXT_SOAP) {
            try {
                require_once("Services/Init/classes/class.ilInitialisation.php");
                ilInitialisation::reInitUser();
            } catch (Exception $e) {
            }
        }
    }

References Vendor\Package\$e, ilContext\CONTEXT_SOAP, ilContext\getType(), and ilInitialisation\reInitUser().

Referenced by ilAbstractSoapMethod\initIliasAndCheckSession().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMessage()

ilSoapAdministration::setMessage ( string $a_str )

protected

Definition at line 107 of file class.ilSoapAdministration.php.

                                                : void
    {
        $this->message = $a_str;
    }

Referenced by checkSession().

Here is the caller graph for this function:

◆ setMessageCode()

ilSoapAdministration::setMessageCode ( string $a_code )

Definition at line 123 of file class.ilSoapAdministration.php.

                                                  : void
    {
        $this->message_code = $a_code;
    }

Referenced by checkSession().

Here is the caller graph for this function:

Field Documentation

◆ $error_method

int ilSoapAdministration::$error_method

Defines type of error handling (PHP5 || NUSOAP)

Definition at line 42 of file class.ilSoapAdministration.php.

◆ $message

string ilSoapAdministration::$message = ''

protected

Definition at line 36 of file class.ilSoapAdministration.php.

Referenced by ilSoapUserAdministration\getImportProtocolAsXML(), getMessage(), and ilSoapUserAdministration\getUserMappingAsXML().

◆ $message_code

string ilSoapAdministration::$message_code = ''

protected

Definition at line 37 of file class.ilSoapAdministration.php.

Referenced by getMessageCode().

◆ $soap_check

bool ilSoapAdministration::$soap_check = true

protected

Definition at line 35 of file class.ilSoapAdministration.php.

◆ NUSOAP

const ilSoapAdministration::NUSOAP = 1

Definition at line 32 of file class.ilSoapAdministration.php.

Referenced by __construct(), isFault(), and raiseError().

◆ PHP5

const ilSoapAdministration::PHP5 = 2

Definition at line 33 of file class.ilSoapAdministration.php.

Referenced by __construct(), isFault(), and raiseError().

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

webservice/soap/classes/class.ilSoapAdministration.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ appendMessage()

◆ checkObjectAccess()

◆ checkSession()

◆ explodeSid()

◆ getClientInfoXML()

◆ getInstallationInfoXML()

◆ getMessage()

◆ getMessageCode()

◆ initAuth()

◆ initAuthenticationObject()

◆ initIlias()

◆ isFault()

◆ raiseError()

◆ reInitUser()

◆ setMessage()

◆ setMessageCode()

Field Documentation

◆ $error_method

◆ $message

◆ $message_code

◆ $soap_check

◆ NUSOAP

◆ PHP5