Client Management. More...

Collaboration diagram for ilClient:

Public Member Functions
	__construct ($a_client_id, $a_db_connections)
	ilClient constructor. More...

	getDBSetup ()

	init ()
	init client load client.ini and set some constants More...

	provideGlobalDB ()

	revokeGlobalDB ()

	getId ()
	get client id More...

	setId ($a_client_id)
	set client id More...

	getName ()
	get client name More...

	setName ($a_str)
	set client name More...

	getDescription ()
	get client description More...

	setDescription ($a_str)
	set client description More...

	getDB ()
	get mysql version More...

	connect ()
	connect to client database More...

	isInstalledDB (&$a_db)
	check if client db is installed More...

	setDSN ()
	set the dsn and dsn_host More...

	setDbHost ($a_str)
	set the host More...

	getDbHost ()
	get db host More...

	setDbName ($a_str)
	set the name of database More...

	getDbName ()
	get name of database More...

	setDbUser ($a_str)
	set db user More...

	getDbUser ()
	get db user More...

	getDbPort ()
	get db port More...

	setDbPort ($a_str)
	set db port More...

	setDbPass ($a_str)
	set db password More...

	getDbPass ()
	get db password More...

	setDbSlaveActive ($a_act)
	set the slave active More...

	getDbSlaveActive ()
	get slave active More...

	setDbSlaveHost ($a_str)
	set the slave host More...

	getDbSlaveHost ()
	get db slave host More...

	setDbSlaveName ($a_str)
	set the name of slave database More...

	getDbSlaveName ()
	get name of slave database More...

	setDbSlaveUser ($a_str)
	set slave db user More...

	getDbSlaveUser ()
	get slave db user More...

	getDbSlavePort ()
	get slave db port More...

	setDbSlavePort ($a_str)
	set slave db port More...

	setDbSlavePass ($a_str)
	set slave db password More...

	getDbSlavePass ()
	get slave db password More...

	setDbType ($a_str)
	set the type of database More...

	getDbType ()
	get type of database More...

	getDataDir ()
	get client datadir path More...

	getWebspaceDir ()
	get client webspacedir path More...

	checkDatabaseExists ($a_keep_connection=false)
	check database connection with database name More...

	reconnect ()

	getSetting ($a_keyword)
	read one value from settings table More...

	getAllSettings ()
	read all values from settings table @access public More...

	setSetting ($a_key, $a_val)
	write one value to settings table @access public More...

	getURLStringForNIC ($a_nic_url)

	updateNIC ($a_nic_url)
	Connect to ILIAS-NIC. More...

	setNICkey ()
	set nic_key generate nic_key if nic_key field in cust table is empty. More...

	getNICkey ()
	get nic_key @access public More...

	getDefaultLanguage ()

	setDefaultLanguage ($a_lang_key)

	getError ()
	get error message and clear error var More...

	setError ($error_message)

	delete ($a_ini=true, $a_db=false, $a_files=false)
	delete client More...

	create ()
	create a new client and its subdirectories More...

	writeIni ()
	write init More...

Data Fields
	$id

	$dir

	$name

	$db_exists = false

	$db_installed = false

	$client_defaults

	$status

	$setup_ok = false

	$nic_status

	$error = ''

	$db

	$ini

Detailed Description

Client Management.

Author: Sascha Hofmann shofm.nosp@m.ann@.nosp@m.datab.nosp@m.ay.d.nosp@m.e; Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

Definition at line 12 of file class.ilClient.php.

Constructor & Destructor Documentation

◆ __construct()

ilClient::__construct	(	$a_client_id,
		$a_db_connections
	)

ilClient constructor.

Parameters

$a_client_id
$a_db_connections

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

        {
                if ($a_client_id)
                {
                        $this->id = $a_client_id;
                        $this->ini_file_path = ILIAS_ABSOLUTE_PATH."/".ILIAS_WEB_DIR."/".$this->getId()."/client.ini.php";
                }
 
                $this->db_connections = $a_db_connections;
 
                // set path default.ini
                $this->client_defaults = ILIAS_ABSOLUTE_PATH."/setup/client.master.ini.php";
        }

References getId().

Here is the call graph for this function:

Member Function Documentation

◆ checkDatabaseExists()

ilClient::checkDatabaseExists ( $a_keep_connection = false )

check database connection with database name

Returns: boolean

Definition at line 559 of file class.ilClient.php.

        {
                return $this->getDBSetup()->isConnectable();
                
                //try to connect to database
                $db = $this->db_connections->connectDB($this->dsn);
                if (MDB2::isError($db))
                {
                        return false;
                }
 
                if (!$this->isInstalledDB($db))
                {
                        return false;
                }
 
                // #10633
                if($a_keep_connection)
                {
                        $GLOBALS["ilDB"] = $this->db;
                        $GLOBALS["DIC"]["ilDB"] = function($c) {
                                return $GLOBALS["ilDB"];
                        };
                }
 
                return true;
        }

References $db, $GLOBALS, getDBSetup(), MDB2\isError(), and isInstalledDB().

Here is the call graph for this function:

◆ connect()

ilClient::connect ( )

connect to client database

Returns: boolean true on success

Definition at line 198 of file class.ilClient.php.

        {
                // check parameters
                // To support oracle tnsnames.ora dbname is not required
                if (!$this->getdbHost() || !$this->getdbUser()) {
                        $this->error = "empty_fields";
 
                        return false;
                }
 
                include_once("./Services/Database/classes/class.ilDBWrapperFactory.php");
                $this->db = ilDBWrapperFactory::getWrapper($this->getdbType(),
                        $this->ini->readVariable("db","inactive_mysqli"));
                $this->db->setDBUser($this->getdbUser());
                $this->db->setDBPort($this->getdbPort());
                $this->db->setDBPassword($this->getdbPass());
                $this->db->setDBHost($this->getdbHost());
                $this->db->setDBName($this->getdbName());
                $con = $this->db->connect(true);
 
                if (!$con)
                {
                        $this->error = "Database connection failed.";
                        return false;
                }
                $GLOBALS["ilDB"] = $this->db;
                $GLOBALS["DIC"]["ilDB"] = function($c) {
                        return $GLOBALS["ilDB"];
                };
 
                $this->db_exists = true;
                return true;
        }

References $db, $GLOBALS, and error().

Referenced by reconnect().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ create()

ilClient::create ( )

create a new client and its subdirectories

Returns: boolean true on success

Definition at line 834 of file class.ilClient.php.

        {
                //var_dump($this->getDataDir());exit;
                // create base data dir
                if (!ilUtil::makeDir($this->getDataDir()))
                {
                        $this->error = "could_not_create_base_data_dir :".$this->getDataDir();
                        return false;
                }
 
                // create sub dirs in base data dir
                if (!ilUtil::makeDir($this->getDataDir()."/mail"))
                {
                        $this->error = "could_not_create_mail_data_dir :".$this->getDataDir()."/mail";
                        return false;
                }
 
                if (!ilUtil::makeDir($this->getDataDir()."/lm_data"))
                {
                        $this->error = "could_not_create_lm_data_dir :".$this->getDataDir()."/lm_data";
                        return false;
                }
 
                if (!ilUtil::makeDir($this->getDataDir()."/forum"))
                {
                        $this->error = "could_not_create_forum_data_dir :".$this->getDataDir()."/forum";
                        return false;
                }
 
                if (!ilUtil::makeDir($this->getDataDir()."/files"))
                {
                        $this->error = "could_not_create_files_data_dir :".$this->getDataDir()."/files";
                        return false;
                }
 
                // create base webspace dir
                if (!ilUtil::makeDir($this->getWebspaceDir()))
                {
                        $this->error = "could_not_create_base_webspace_dir :".$this->getWebspaceDir();
                        return false;
                }
 
                // create sub dirs in base webspace dir
                if (!ilUtil::makeDir($this->getWebspaceDir()."/lm_data"))
                {
                        $this->error = "could_not_create_lm_webspace_dir :".$this->getWebspaceDir()."/lm_data";
                        return false;
                }
 
                if (!ilUtil::makeDir($this->getWebspaceDir()."/usr_images"))
                {
                        $this->error = "could_not_create_usr_images_webspace_dir :".$this->getWebspaceDir()."/usr_images";
                        return false;
                }
 
                if (!ilUtil::makeDir($this->getWebspaceDir()."/mobs"))
                {
                        $this->error = "could_not_create_mobs_webspace_dir :".$this->getWebspaceDir()."/mobs";
                        return false;
                }
 
                if (!ilUtil::makeDir($this->getWebspaceDir()."/css"))
                {
                        $this->error = "could_not_create_css_webspace_dir :".$this->getWebspaceDir()."/css";
                        return false;
                }
 
                // write client ini
                if (!$this->ini->write())
                {
                        $this->error = get_class($this).": ".$this->ini->getError();
                        return false;
                }
 
                return true;
        }

References error(), getDataDir(), getWebspaceDir(), and ilUtil\makeDir().

Here is the call graph for this function:

◆ delete()

ilClient::delete	(	$a_ini = `true`,
		$a_db = `false`,
		$a_files = `false`
	)

delete client

Parameters

boolean	remove ini if true
boolean	remove db if true
boolean	remove files if true

Returns: array confirmation messages

Definition at line 805 of file class.ilClient.php.

        {
                if ($a_ini === true and file_exists(ILIAS_ABSOLUTE_PATH."/".ILIAS_WEB_DIR."/".$this->getId()."/client.ini.php"))
                {
                        unlink(CLIENT_WEB_DIR."/client.ini.php");
                        $msg[] = "ini_deleted";
                }
 
                if ($a_db === true and $this->db_exists)
                {
                        $this->db->query("DROP DATABASE ".$this->getDbName());
                        $msg[] = "db_deleted";
                }
 
                if ($a_files === true and file_exists(CLIENT_WEB_DIR) and is_dir(CLIENT_WEB_DIR))
                {
                        // rmdir();
                        ilUtil::delDir(CLIENT_WEB_DIR);
                        ilUtil::delDir(CLIENT_DATA_DIR);
                        $msg[] = "files_deleted";
                }
 
                return $msg;
        }

References ilUtil\delDir(), and getDbName().

Here is the call graph for this function:

◆ getAllSettings()

ilClient::getAllSettings ( )

read all values from settings table @access public

Returns: array keyword/value pairs

Definition at line 616 of file class.ilClient.php.

        {
                include_once './Services/Administration/classes/class.ilSetting.php';
                $set = new ilSetting("common", true);
                return $set->getAll();
        }

Referenced by getURLStringForNIC(), and updateNIC().

Here is the caller graph for this function:

◆ getDataDir()

ilClient::getDataDir ( )

get client datadir path

Returns: string client datadir path

Definition at line 540 of file class.ilClient.php.

        {
                return ILIAS_DATA_DIR."/".$this->getId();
        }

References getId().

Referenced by create().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDB()

ilClient::getDB ( )

get mysql version

Get DB object

Definition at line 189 of file class.ilClient.php.

        {
                return $this->db;
        }

References $db.

◆ getDbHost()

ilClient::getDbHost ( )

get db host

Returns: string db host

Definition at line 323 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","host");
        }

◆ getDbName()

ilClient::getDbName ( )

get name of database

Returns: string name of database

Definition at line 341 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","name");
        }

Referenced by delete().

Here is the caller graph for this function:

◆ getDbPass()

ilClient::getDbPass ( )

get db password

Returns: string db password

Definition at line 395 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","pass");
        }

◆ getDbPort()

ilClient::getDbPort ( )

get db port

Returns: string db port

Definition at line 368 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","port");
        }

◆ getDBSetup()

ilClient::getDBSetup ( )

Returns: \ilDbSetup

Definition at line 62 of file class.ilClient.php.

                                     {
                require_once('./setup/classes/class.ilDbSetup.php');
 
                return ilDbSetup::getInstanceForClient($this);
        }

References ilDbSetup\getInstanceForClient().

Referenced by checkDatabaseExists(), getSetting(), init(), provideGlobalDB(), and revokeGlobalDB().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDbSlaveActive()

ilClient::getDbSlaveActive ( )

get slave active

Returns: int active

Definition at line 414 of file class.ilClient.php.

        {
                return (int) $this->ini->readVariable("db","slave_active");
        }

◆ getDbSlaveHost()

ilClient::getDbSlaveHost ( )

get db slave host

Returns: string db host

Definition at line 433 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","slave_host");
        }

◆ getDbSlaveName()

ilClient::getDbSlaveName ( )

get name of slave database

Returns: string name of database

Definition at line 451 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","slave_name");
        }

◆ getDbSlavePass()

ilClient::getDbSlavePass ( )

get slave db password

Returns: string db password

Definition at line 505 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","slave_pass");
        }

◆ getDbSlavePort()

ilClient::getDbSlavePort ( )

get slave db port

Returns: string db port

Definition at line 478 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","slave_port");
        }

◆ getDbSlaveUser()

ilClient::getDbSlaveUser ( )

get slave db user

Returns: string db user

Definition at line 469 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","slave_user");
        }

◆ getDbType()

ilClient::getDbType ( )

get type of database

Returns: string name of database

Definition at line 523 of file class.ilClient.php.

        {
                $val =  $this->ini->readVariable("db","type");
                if ($val == "")
                {
                        return "mysql";
                }
                else
                {
                        return $val;
                }
        }

Referenced by setDSN().

Here is the caller graph for this function:

◆ getDbUser()

ilClient::getDbUser ( )

get db user

Returns: string db user

Definition at line 359 of file class.ilClient.php.

        {
                return $this->ini->readVariable("db","user");
        }

◆ getDefaultLanguage()

ilClient::getDefaultLanguage ( )

Definition at line 762 of file class.ilClient.php.

        {
                return $this->getSetting("language");
        }

References getSetting().

Here is the call graph for this function:

◆ getDescription()

ilClient::getDescription ( )

get client description

Returns: string client description

Definition at line 164 of file class.ilClient.php.

        {
                return $this->ini->readVariable("client","description");
        }

◆ getError()

ilClient::getError ( )

get error message and clear error var

Returns: string error message

Definition at line 782 of file class.ilClient.php.

                            {
                $error = $this->error;
                $this->error = "";
 
                return $error;
        }

References $error, and error().

Here is the call graph for this function:

◆ getId()

ilClient::getId ( )

get client id

Returns: string client id

Definition at line 127 of file class.ilClient.php.

        {
                return $this->id;
        }

References $id.

Referenced by __construct(), getDataDir(), getWebspaceDir(), and init().

Here is the caller graph for this function:

◆ getName()

ilClient::getName ( )

get client name

Returns: string client name

Definition at line 146 of file class.ilClient.php.

        {
                return $this->ini->readVariable("client","name");
        }

◆ getNICkey()

ilClient::getNICkey ( )

get nic_key @access public

Returns: string nic_key

Definition at line 750 of file class.ilClient.php.

        {
                $this->nic_key = $this->getSetting("nic_key");
 
                if (empty($this->nic_key))
                {
                        $this->setNICkey();
                }
 
                return $this->nic_key;
        }

References getSetting(), and setNICkey().

Referenced by getURLStringForNIC().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSetting()

ilClient::getSetting ( $a_keyword )

read one value from settings table

@access public

Parameters

string keyword

Returns: string value

Definition at line 600 of file class.ilClient.php.

                                               {
                global $ilDB;
                if (!$this->getDBSetup()->isDatabaseInstalled() || !$ilDB) {
                        return false;
                }
                include_once './Services/Administration/classes/class.ilSetting.php';
                $set = new ilSetting("common", true);
 
                return $set->get($a_keyword);
        }

References $ilDB, and getDBSetup().

Referenced by getDefaultLanguage(), and getNICkey().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getURLStringForNIC()

ilClient::getURLStringForNIC ( $a_nic_url )

Parameters

string url to ilias nic server

Returns: string url with required parameters

Definition at line 641 of file class.ilClient.php.

        {
                $settings = $this->getAllSettings();
 
                $inst_id = (empty($settings["inst_id"])) ? "0" : $settings["inst_id"];
 
                // send host information to ilias-nic
                //#18132: removed ipadr, server_port, server_software, institution, contact_title, contact_position,
                // contact_institution, contact_street, contact_pcode, contact_city, contact_country, contact_phone
                $url =  $a_nic_url.
                                "?cmd=getid".
                                "&inst_id=".rawurlencode($inst_id).
                                "&hostname=".rawurlencode($_SERVER["SERVER_NAME"]).
                                "&inst_name=".rawurlencode($this->ini->readVariable("client","name")).
                                "&inst_info=".rawurlencode($this->ini->readVariable("client","description")).
                                "&http_path=".rawurlencode(ILIAS_HTTP_PATH).
                                "&contact_firstname=".rawurlencode($settings["admin_firstname"]).
                                "&contact_lastname=".rawurlencode($settings["admin_lastname"]).
                                "&contact_email=".rawurlencode($settings["admin_email"]).
                                "&nic_key=".rawurlencode($this->getNICkey());
 
                return $url;
        }

References $_SERVER, $url, getAllSettings(), and getNICkey().

Referenced by updateNIC().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getWebspaceDir()

ilClient::getWebspaceDir ( )

get client webspacedir path

Returns: string clietn webspacedir path

Definition at line 549 of file class.ilClient.php.

        {
                return ILIAS_ABSOLUTE_PATH."/".ILIAS_WEB_DIR."/".$this->getId();
        }

References getId().

Referenced by create().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ init()

ilClient::init ( )

init client load client.ini and set some constants

Returns: boolean

Definition at line 73 of file class.ilClient.php.

        {
                $this->ini = new ilIniFile($this->ini_file_path);
 
                // load defaults only if no client.ini was found
                if (!@file_exists($this->ini_file_path)) {
                        //echo "<br>A-".$this->ini_file_path."-";
                        $this->ini->GROUPS = parse_ini_file($this->client_defaults, true);
 
                        return false;
                }
 
                // read client.ini
                if (!$this->ini->read()) {
                        $this->error = get_class($this) . ": " . $this->ini->getError();
 
                        return false;
                }
 
                // only for ilias main
                define("CLIENT_WEB_DIR", ILIAS_ABSOLUTE_PATH . "/" . ILIAS_WEB_DIR . "/" . $this->getId());
                define("CLIENT_DATA_DIR", ILIAS_DATA_DIR . "/" . $this->getId());
                define("DEVMODE", $this->ini->readVariable('system', 'DEVMODE'));
                define("ROOT_FOLDER_ID", $this->ini->readVariable('system', 'ROOT_FOLDER_ID'));
                define("SYSTEM_FOLDER_ID", $this->ini->readVariable('system', 'SYSTEM_FOLDER_ID'));
                define("ROLE_FOLDER_ID", $this->ini->readVariable('system', 'ROLE_FOLDER_ID'));
                define("ANONYMOUS_USER_ID", 13);
                define("ANONYMOUS_ROLE_ID", 14);
                define("SYSTEM_USER_ID", 6);
                define("SYSTEM_ROLE_ID", 2);
 
                $this->db_exists = $this->getDBSetup()->isConnectable();
                                $this->getDBSetup()->provideGlobalDB();
                if ($this->db_exists) {
                        $this->db_installed = $this->getDBSetup()->isDatabaseInstalled();
                }
 
                return true;
        }

References error(), getDBSetup(), and getId().

Here is the call graph for this function:

◆ isInstalledDB()

ilClient::isInstalledDB ( & $a_db )

check if client db is installed

Parameters

object db object

Returns: boolean true if installed

Definition at line 237 of file class.ilClient.php.

        {
                if(method_exists($a_db,'loadModule'))
                {
                        $a_db->loadModule('Manager');
                }
                if(!$tables = $a_db->listTables())
                {
                        return false;
                }
 
                // check existence of some basic tables from ilias3 to determine if ilias3 is already installed in given database
                if (in_array("object_data",$tables) and in_array("object_reference",$tables) and in_array("usr_data",$tables) and in_array("rbac_ua",$tables))
                {
                        $this->db_installed = true;
                        return true;
                }
                $this->db_installed = false;
                return false;
        }

Referenced by checkDatabaseExists().

Here is the caller graph for this function:

◆ provideGlobalDB()

ilClient::provideGlobalDB ( )

Definition at line 114 of file class.ilClient.php.

                                          {
                $this->getDBSetup()->provideGlobalDB();
        }

References getDBSetup().

Here is the call graph for this function:

◆ reconnect()

ilClient::reconnect ( )

Definition at line 587 of file class.ilClient.php.

        {
                $this->connect();
        }

References connect().

Here is the call graph for this function:

◆ revokeGlobalDB()

ilClient::revokeGlobalDB ( )

Definition at line 119 of file class.ilClient.php.

                                         {
                $this->getDBSetup()->provideGlobalDB();
        }

References getDBSetup().

Here is the call graph for this function:

◆ setDbHost()

ilClient::setDbHost ( $a_str )

set the host

Parameters

string

Definition at line 313 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","host",$a_str);
        }

◆ setDbName()

ilClient::setDbName ( $a_str )

set the name of database

Parameters

string

Definition at line 332 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","name",$a_str);
        }

◆ setDbPass()

ilClient::setDbPass ( $a_str )

set db password

Parameters

string

Definition at line 386 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","pass",$a_str);
        }

◆ setDbPort()

ilClient::setDbPort ( $a_str )

set db port

Parameters

string

Definition at line 377 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","port",$a_str);
        }

◆ setDbSlaveActive()

ilClient::setDbSlaveActive ( $a_act )

set the slave active

Parameters

int

Definition at line 404 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","slave_active", (int) $a_act);
        }

◆ setDbSlaveHost()

ilClient::setDbSlaveHost ( $a_str )

set the slave host

Parameters

string

Definition at line 423 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","slave_host",$a_str);
        }

◆ setDbSlaveName()

ilClient::setDbSlaveName ( $a_str )

set the name of slave database

Parameters

string

Definition at line 442 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","slave_name",$a_str);
        }

◆ setDbSlavePass()

ilClient::setDbSlavePass ( $a_str )

set slave db password

Parameters

string

Definition at line 496 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","slave_pass",$a_str);
        }

◆ setDbSlavePort()

ilClient::setDbSlavePort ( $a_str )

set slave db port

Parameters

string

Definition at line 487 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","slave_port",$a_str);
        }

◆ setDbSlaveUser()

ilClient::setDbSlaveUser ( $a_str )

set slave db user

Parameters

string db user

Definition at line 460 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","slave_user",$a_str);
        }

◆ setDbType()

ilClient::setDbType ( $a_str )

set the type of database

Parameters

string

Definition at line 514 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","type",$a_str);
        }

◆ setDbUser()

ilClient::setDbUser ( $a_str )

set db user

Parameters

string db user

Definition at line 350 of file class.ilClient.php.

        {
                $this->ini->setVariable("db","user",$a_str);
        }

◆ setDefaultLanguage()

ilClient::setDefaultLanguage ( $a_lang_key )

Definition at line 767 of file class.ilClient.php.

        {
                $this->setSetting("language",$a_lang_key);
                $this->ini->setVariable("language","default",$a_lang_key);
                $this->ini->write();
 
                return true;
        }

References setSetting().

Here is the call graph for this function:

◆ setDescription()

ilClient::setDescription ( $a_str )

set client description

Parameters

string client description

Definition at line 173 of file class.ilClient.php.

        {
                $this->ini->setVariable("client","description",$a_str);
        }

◆ setDSN()

ilClient::setDSN ( )

set the dsn and dsn_host

Definition at line 261 of file class.ilClient.php.

        {
                switch($this->getDbType())
                {
                        case "oracle":
                                //$this->dsn_host = "oci8://".$this->getdbUser().":".$this->getdbPass()."@".$this->getdbHost();
                                $this->dsn_host = array(
                                                'phptype' => 'oci8',
                                                'hostspec' => $this->getdbHost(),
                                                'username' => $this->getdbUser(),
                                                                                                'port' => $this->getdbPort(),
                                                'password' => $this->getdbPass(),
                                                );
                                //$this->dsn = "oci8://".$this->getdbUser().":".$this->getdbPass()."@".$this->getdbHost()."/?service=".$this->getdbName();
                                $this->dsn = $this->dsn = array(
                                        'phptype' => 'oci8',
                                        'hostspec' => $this->getdbHost(),
                                        'username' => $this->getdbUser(),
                                        'port' => $this->getdbPort(),
                                        'password' => $this->getdbPass(),
                                        'service' => $this->getdbName()
                                        );
                                break;
 
                        case "postgres":
                                $db_port_str = "";
                                if (trim($this->getdbPort()) != "")
                                {
                                        $db_port_str = ":".$this->getdbPort();
                                }
                                $this->dsn_host = "pgsql://".$this->getdbUser().":".$this->getdbPass()."@".$this->getdbHost().$db_port_str;
                                $this->dsn = "pgsql://".$this->getdbUser().":".$this->getdbPass()."@".$this->getdbHost().$db_port_str."/".$this->getdbName();
                                break;
 
                        case "mysql":
                        case "innodb":
                        default:
                                $db_port_str = "";
                                if (trim($this->getdbPort()) != "")
                                {
                                        $db_port_str = ":".$this->getdbPort();
                                }
                                $this->dsn_host = "mysql://".$this->getdbUser().":".$this->getdbPass()."@".$this->getdbHost().$db_port_str;
                                $this->dsn = "mysql://".$this->getdbUser().":".$this->getdbPass()."@".$this->getdbHost().$db_port_str."/".$this->getdbName();
                                break;
                }
        }

References getDbType().

Here is the call graph for this function:

◆ setError()

ilClient::setError ( $error_message )

Parameters

$error_message

Definition at line 793 of file class.ilClient.php.

                                                 {
                $this->error = $error_message;
        }

References error().

Referenced by updateNIC().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setId()

ilClient::setId ( $a_client_id )

set client id

Parameters

string client id

Definition at line 136 of file class.ilClient.php.

        {
                $this->id = $a_client_id;
                $this->webspace_dir = ILIAS_ABSOLUTE_PATH."/".ILIAS_WEB_DIR."/".$this->id;
        }

References $id.

◆ setName()

ilClient::setName ( $a_str )

set client name

Parameters

string client name

Definition at line 155 of file class.ilClient.php.

        {
                $this->ini->setVariable("client","name",$a_str);
        }

◆ setNICkey()

ilClient::setNICkey ( )

set nic_key generate nic_key if nic_key field in cust table is empty.

the nic_key is used for authentication update requests sent to the ILIAS-NIC server. @access public

Returns: boolean

Definition at line 732 of file class.ilClient.php.

        {
                mt_srand((double)microtime()*1000000);
                $nic_key =      md5(str_replace(".","",$_SERVER["SERVER_ADDR"]) +
                                        mt_rand(100000,999999));
 
                $this->setSetting("nic_key",$nic_key);
 
                $this->nic_key = $nic_key;
 
                return true;
        }

References $_SERVER, and setSetting().

Referenced by getNICkey().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setSetting()

ilClient::setSetting	(	$a_key,
		$a_val
	)

write one value to settings table @access public

Parameters

string	keyword
string	value

Returns: boolean true on success

Definition at line 630 of file class.ilClient.php.

        {
                include_once './Services/Administration/classes/class.ilSetting.php';
                $set = new ilSetting("common", true);
                $set->set($a_key, $a_val);
        }

Referenced by setDefaultLanguage(), and setNICkey().

Here is the caller graph for this function:

◆ updateNIC()

ilClient::updateNIC ( $a_nic_url )

Connect to ILIAS-NIC.

This function establishes a HTTP connection to the ILIAS Network Information Center (NIC) in order to update the ILIAS-NIC host database and - in case of a newly installed system - obtain an installation id at first connection. This function my be put into a dedicated include file as soon as there are more functions concerning the interconnection of ILIAS hosts

Parameters

void

Returns: string/array $ret error message or data array

Definition at line 679 of file class.ilClient.php.

        {
                $max_redirects = 5;
                $socket_timeout = 5;
 
                require_once(__DIR__."/../../Services/WebServices/Curl/classes/class.ilCurlConnection.php");
                if (!ilCurlConnection::_isCurlExtensionLoaded()) {
                        $this->setError("CURL-extension not loaded.");
                        return false;
                }
 
                $url = $this->getURLStringForNIC($a_nic_url);
                $req = new ilCurlConnection($url);
                $req->init();
 
                $settings = $this->getAllSettings();
                if((bool)$settings['proxy_status'] && strlen($settings['proxy_host']) && strlen($settings['proxy_port']))
                {
                        $req->setOpt(CURLOPT_HTTPPROXYTUNNEL, true);
                        $req->setOpt(CURLOPT_PROXY, $settings["proxy_host"]);
                        $req->setOpt(CURLOPT_PROXYPORT, $settings["proxy_port"]);
                }
 
                $req->setOpt(CURLOPT_HEADER, 1);
                $req->setOpt(CURLOPT_RETURNTRANSFER, 1);
                $req->setOpt(CURLOPT_CONNECTTIMEOUT, $socket_timeout);
                $req->setOpt(CURLOPT_MAXREDIRS, $max_redirects);
                $response = $req->exec();
                
                $req->parseResponse($response);
                $response_body = $req->getResponseBody();
 
                $info = $req->getInfo();
                if ($info["http_code"] != "200") {
                        $this->setError("Could not connect to NIC-Server at '".$url."'");
                        return false;
                }
 
                $this->nic_status = explode("\n", $response_body);
                
                ilLoggerFactory::getLogger('setup')->dump($nic_status);
 
                return true;
        }

References $info, $nic_status, $url, ilCurlConnection\_isCurlExtensionLoaded(), getAllSettings(), ilLoggerFactory\getLogger(), getURLStringForNIC(), and setError().

Here is the call graph for this function:

◆ writeIni()

ilClient::writeIni ( )

write init

Parameters

return

Definition at line 917 of file class.ilClient.php.

        {
                $this->ini->write();
        }

Field Documentation

◆ $client_defaults

ilClient::$client_defaults

Definition at line 20 of file class.ilClient.php.

◆ $db

ilClient::$db

Definition at line 31 of file class.ilClient.php.

Referenced by checkDatabaseExists(), connect(), and getDB().

◆ $db_exists

ilClient::$db_exists = false

Definition at line 17 of file class.ilClient.php.

◆ $db_installed

ilClient::$db_installed = false

Definition at line 18 of file class.ilClient.php.

◆ $dir

ilClient::$dir

Definition at line 15 of file class.ilClient.php.

◆ $error

ilClient::$error = ''

Definition at line 27 of file class.ilClient.php.

Referenced by getError().

◆ $id

ilClient::$id

Definition at line 14 of file class.ilClient.php.

Referenced by getId(), and setId().

◆ $ini

ilClient::$ini

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

◆ $name

ilClient::$name

Definition at line 16 of file class.ilClient.php.

◆ $nic_status

ilClient::$nic_status

Definition at line 23 of file class.ilClient.php.

Referenced by updateNIC().

◆ $setup_ok

ilClient::$setup_ok = false

Definition at line 22 of file class.ilClient.php.

◆ $status

ilClient::$status

Definition at line 21 of file class.ilClient.php.

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

setup/classes/class.ilClient.php

Public Member Functions

Data Fields

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkDatabaseExists()

◆ connect()

◆ create()

◆ delete()

◆ getAllSettings()

◆ getDataDir()

◆ getDB()

◆ getDbHost()

◆ getDbName()

◆ getDbPass()

◆ getDbPort()

◆ getDBSetup()

◆ getDbSlaveActive()

◆ getDbSlaveHost()

◆ getDbSlaveName()

◆ getDbSlavePass()

◆ getDbSlavePort()

◆ getDbSlaveUser()

◆ getDbType()

◆ getDbUser()

◆ getDefaultLanguage()

◆ getDescription()

◆ getError()

◆ getId()

◆ getName()

◆ getNICkey()

◆ getSetting()

◆ getURLStringForNIC()

◆ getWebspaceDir()

◆ init()

◆ isInstalledDB()

◆ provideGlobalDB()

◆ reconnect()

◆ revokeGlobalDB()

◆ setDbHost()

◆ setDbName()

◆ setDbPass()

◆ setDbPort()

◆ setDbSlaveActive()

◆ setDbSlaveHost()

◆ setDbSlaveName()

◆ setDbSlavePass()

◆ setDbSlavePort()

◆ setDbSlaveUser()

◆ setDbType()

◆ setDbUser()

◆ setDefaultLanguage()

◆ setDescription()

◆ setDSN()

◆ setError()

◆ setId()

◆ setName()

◆ setNICkey()

◆ setSetting()

◆ updateNIC()

◆ writeIni()

Field Documentation

◆ $client_defaults

◆ $db

◆ $db_exists

◆ $db_installed

◆ $dir

◆ $error

◆ $id

◆ $ini

◆ $name

◆ $nic_status

◆ $setup_ok

◆ $status