ilChatroomServerConnector Class Reference

Class ilChatroomServerConnector. More...

Collaboration diagram for ilChatroomServerConnector:

Public Member Functions
	__construct (private readonly ilChatroomServerSettings $settings)
	isServerAlive ()
	connect (int $scope, int $userId)
	Creates connect URL using given $scope and $userId and returns it. More...
	sendCreatePrivateRoom (int $scope, int $user, string $title)
	enterPrivateRoom (int $scope, int $user)
	sendEnterPrivateRoom (int $scope, int $user)
	sendClearMessages (int $scope, int $user)
	leavePrivateRoom (int $scope, int $user)
	sendLeavePrivateRoom (int $scope, int $user)
	sendKick (int $scope, int $user)
	kick (int $scope, int $user)
	Returns kick URL Creates kick URL using given $scope and $query and returns it. More...
	sendBan (int $scope, int $user)
	getSettings ()
	sendInviteToPrivateRoom (int $scope, int $user, int $invited_id)
	sendUserConfigChange (string $message)

Static Public Member Functions
static	checkServerConnection (bool $use_cache=true)

Protected Member Functions
	file_get_contents (string $url, ?array $stream_context_params=null)

Static Protected Attributes
static bool	$connection_status = null

Detailed Description

Class ilChatroomServerConnector.

Author

Jan Posselt jposs.nosp@m.elt@.nosp@m.datab.nosp@m.ay.d.nosp@m.e

Version

$Id$ \

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

Constructor & Destructor Documentation

__construct()

ilChatroomServerConnector::__construct

(

private readonly ilChatroomServerSettings

$settings

)

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

    {
    }

Member Function Documentation

checkServerConnection()

static ilChatroomServerConnector::checkServerConnection ( bool  $use_cache = true )

static

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

References ilChatroomAdmin\getDefaultConfiguration(), and null.

Referenced by ilChatroomAdminViewGUI\checkServerConnection().

                                                                        : bool
    {
        if ($use_cache && self::$connection_status !== null) {
            return self::$connection_status;
        }

        $connector = new self(ilChatroomAdmin::getDefaultConfiguration()->getServerSettings());
        self::$connection_status = $connector->isServerAlive();

        return self::$connection_status;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

connect()

ilChatroomServerConnector::connect	(	int	$scope,
		int	$userId
	)

Creates connect URL using given $scope and $userId and returns it.

Returns

string|false

Definition at line 74 of file class.ilChatroomServerConnector.php.

References file_get_contents(), and ILIAS\Repository\settings().

    {
        return $this->file_get_contents(
            $this->settings->getURL('Connect', (string) $scope) . '/' . $userId
        );
    }

Here is the call graph for this function:

enterPrivateRoom()

ilChatroomServerConnector::enterPrivateRoom	(	int	$scope,
		int	$user
	)

Returns

string|false

Deprecated:

Please use sendEnterPrivateRoom instead

Definition at line 138 of file class.ilChatroomServerConnector.php.

References sendEnterPrivateRoom().

    {
        return $this->sendEnterPrivateRoom($scope, $user);
    }

Here is the call graph for this function:

file_get_contents()

ilChatroomServerConnector::file_get_contents ( string  $url, ?array  $stream_context_params = null  )

protected

Parameters

array | null

$stream_context_params

Returns

string|false

Definition at line 85 of file class.ilChatroomServerConnector.php.

References Vendor\Package\$e, $message, ilLoggerFactory\getLogger(), and ILIAS\Repository\settings().

Referenced by connect(), isServerAlive(), kick(), sendBan(), sendClearMessages(), sendCreatePrivateRoom(), sendEnterPrivateRoom(), sendInviteToPrivateRoom(), sendLeavePrivateRoom(), and sendUserConfigChange().

    {
        $credentials = $this->settings->getAuthKey() . ':' . $this->settings->getAuthSecret();
        $header =
            "Connection: close\r\n" .
            "Content-Type: application/json; charset=utf-8\r\n" .
            "Authorization: Basic " . base64_encode($credentials);

        $ctx = [
            'http' => [
                'method' => 'GET',
                'header' => $header
            ],
            'https' => [
                'method' => 'GET',
                'header' => $header
            ]
        ];

        if (is_array($stream_context_params)) {
            $ctx = array_merge_recursive($ctx, $stream_context_params);
        }

        set_error_handler(static function (int $severity, string $message, string $file, int $line): never {
            throw new ErrorException($message, $severity, $severity, $file, $line);
        });

        try {
            return file_get_contents($url, false, stream_context_create($ctx));
        } catch (Exception $e) {
            ilLoggerFactory::getLogger('chatroom')->alert($e->getMessage());
        } finally {
            restore_error_handler();
        }

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSettings()

ilChatroomServerConnector::getSettings

(

)

Definition at line 211 of file class.ilChatroomServerConnector.php.

                                 : ilChatroomServerSettings
    {
        return $this->settings;
    }

isServerAlive()

ilChatroomServerConnector::isServerAlive

(

)

Definition at line 47 of file class.ilChatroomServerConnector.php.

References $response, file_get_contents(), ILIAS\Repository\int(), and ILIAS\Repository\settings().

                                   : bool
    {
        $response = $this->file_get_contents(
            $this->settings->getURL('Heartbeat'),
            [
                'http' => [
                    'timeout' => 2
                ],
                'https' => [
                    'timeout' => 2
                ]
            ]
        );

        if (false === $response) {
            return false;
        }

        $responseObject = json_decode($response, false, 512, JSON_THROW_ON_ERROR);

        return $responseObject instanceof stdClass && ((int) $responseObject->status) === 200;
    }

Here is the call graph for this function:

kick()

ilChatroomServerConnector::kick	(	int	$scope,
		int	$user
	)

Returns kick URL Creates kick URL using given $scope and $query and returns it.

Returns

string|false

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

References file_get_contents(), and ILIAS\Repository\settings().

Referenced by sendKick().

    {
        return $this->file_get_contents(
            $this->settings->getURL('Kick', (string) $scope) . '/' . $user
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

leavePrivateRoom()

ilChatroomServerConnector::leavePrivateRoom	(	int	$scope,
		int	$user
	)

Returns

string|false

Definition at line 166 of file class.ilChatroomServerConnector.php.

References sendLeavePrivateRoom().

    {
        return $this->sendLeavePrivateRoom($scope, $user);
    }

Here is the call graph for this function:

sendBan()

ilChatroomServerConnector::sendBan	(	int	$scope,
		int	$user
	)

Returns

string|false

Definition at line 204 of file class.ilChatroomServerConnector.php.

References file_get_contents(), and ILIAS\Repository\settings().

    {
        return $this->file_get_contents(
            $this->settings->getURL('Ban', (string) $scope) . '/' . $user
        );
    }

Here is the call graph for this function:

sendClearMessages()

ilChatroomServerConnector::sendClearMessages	(	int	$scope,
		int	$user
	)

Returns

string|false

Definition at line 156 of file class.ilChatroomServerConnector.php.

References file_get_contents(), and ILIAS\Repository\settings().

    {
        return $this->file_get_contents(
            $this->settings->getURL('ClearMessages', (string) $scope) . '/' . $user
        );
    }

Here is the call graph for this function:

sendCreatePrivateRoom()

ilChatroomServerConnector::sendCreatePrivateRoom	(	int	$scope,
		int	$user,
		string	$title
	)

Returns

string|false

Definition at line 126 of file class.ilChatroomServerConnector.php.

References file_get_contents(), and ILIAS\Repository\settings().

    {
        return $this->file_get_contents(
            $this->settings->getURL('CreatePrivateRoom', (string) $scope) .
            '/' . $user . '/' . rawurlencode($title)
        );
    }

Here is the call graph for this function:

sendEnterPrivateRoom()

ilChatroomServerConnector::sendEnterPrivateRoom	(	int	$scope,
		int	$user
	)

Returns

string|false

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

References file_get_contents(), and ILIAS\Repository\settings().

Referenced by enterPrivateRoom().

    {
        return $this->file_get_contents(
            $this->settings->getURL('EnterPrivateRoom', (string) $scope) . '/' . $user
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendInviteToPrivateRoom()

ilChatroomServerConnector::sendInviteToPrivateRoom	(	int	$scope,
		int	$user,
		int	$invited_id
	)

Returns

string|false

Definition at line 219 of file class.ilChatroomServerConnector.php.

References file_get_contents(), and ILIAS\Repository\settings().

    {
        return $this->file_get_contents(
            $this->settings->getURL('InvitePrivateRoom', (string) $scope) .
            '/' . $user . '/' . $invited_id
        );
    }

Here is the call graph for this function:

sendKick()

ilChatroomServerConnector::sendKick	(	int	$scope,
		int	$user
	)

Returns

string|false

Definition at line 184 of file class.ilChatroomServerConnector.php.

References kick().

    {
        return $this->kick($scope, $user);
    }

Here is the call graph for this function:

sendLeavePrivateRoom()

ilChatroomServerConnector::sendLeavePrivateRoom	(	int	$scope,
		int	$user
	)

Returns

string|false

Definition at line 174 of file class.ilChatroomServerConnector.php.

References file_get_contents(), and ILIAS\Repository\settings().

Referenced by leavePrivateRoom().

    {
        return $this->file_get_contents(
            $this->settings->getURL('LeavePrivateRoom', (string) $scope) . '/' . $user
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendUserConfigChange()

ilChatroomServerConnector::sendUserConfigChange

(

string

$message

)

Returns

string|false

Definition at line 230 of file class.ilChatroomServerConnector.php.

References file_get_contents(), null, and ILIAS\Repository\settings().

    {
        $query = http_build_query(['message' => $message]);

        return $this->file_get_contents(
            $this->settings->getURL('UserConfigChange', null) . '?' . $query
        );
    }

Here is the call graph for this function:

Field Documentation

$connection_status

bool ilChatroomServerConnector::$connection_status = null

staticprotected

Definition at line 29 of file class.ilChatroomServerConnector.php.

---

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

• components/ILIAS/Chatroom/classes/class.ilChatroomServerConnector.php