Inheritance diagram for ILIAS\Cache\Container\ActiveContainer:

Collaboration diagram for ILIAS\Cache\Container\ActiveContainer:

Public Member Functions
	__construct (private Request $request, private Adaptor $adaptor, private Config $config)

	isLocked ()
	Returns true if the container is locked. More...

	lock (float $seconds)
	Locks the container for a given amount of seconds (max 300), in this time, get() will return null and has() will return false. More...

	has (string $key)
	Returns true if the container contains a value for the given key. More...

	get (string $key, Transformation $transformation)
	Returns the value for the given key, or null if the key does not exist. More...

	set (string $key, string\|int\|array\|bool\|null $value, ?int $ttl=null)
	Sets the value for the given key. More...

	delete (string $key)
	Deletes the value for the given key. More...

	flush ()
	Deletes all values in the container. More...

	getAdaptorName ()
	Returns the name of the adaptop used (such as apc, memcache, phpstatic) More...

	getContainerName ()
	Returns the name of the container. More...

	unlock ()

Protected Member Functions
	buildFinalTransformation (Transformation $transformation)

	getNullFallback ()

Private Member Functions
	pack (mixed $value)

	packRecursive (array $value)

	unprefix (string $value)

	unpack (?string $value)

	unpackRecursive (array $value)

Private Attributes
const	LOCK_UNTIL = '_lock_until'

const	GLUE = '\|\|\|\|\|'

const	STRING_PREFIX = 'string'

const	ARRAY_PREFIX = 'array'

const	INT_PREFIX = 'int'

const	BOOL_PREFIX = 'bool'

const	NULL_PREFIX = 'null'

const	TRUE = 'true'

const	FALSE = 'false'

ILIAS Data Factory	$data_factory

Transformation	$null_trafo

string	$prefix_pattern

float	$lock_cache = null

Detailed Description

Author: Fabian Schmid fabia.nosp@m.n@sr.nosp@m..solu.nosp@m.tion.nosp@m.s

Definition at line 31 of file ActiveContainer.php.

Constructor & Destructor Documentation

◆ __construct()

ILIAS\Cache\Container\ActiveContainer::__construct	(	private Request	$request,
		private Adaptor	$adaptor,
		private Config	$config
	)

Definition at line 49 of file ActiveContainer.php.

       {
         $this->data_factory = new \ILIAS\Data\Factory();
         // see comment in buildFinalTransformation why this is not a good solution.
         $this->null_trafo = new \ILIAS\Refinery\Custom\Transformation(function ($value) {
             return null;
         });
         $this->prefix_pattern = '(' . implode('|', [
                 preg_quote(self::STRING_PREFIX, '/'),
                 preg_quote(self::ARRAY_PREFIX, '/'),
                 preg_quote(self::INT_PREFIX, '/'),
                 preg_quote(self::BOOL_PREFIX, '/'),
                 preg_quote(self::NULL_PREFIX, '/')
             ]) . ')';
     }

Member Function Documentation

◆ buildFinalTransformation()

ILIAS\Cache\Container\ActiveContainer::buildFinalTransformation ( Transformation $transformation )

protected

Definition at line 161 of file ActiveContainer.php.

References ILIAS\Cache\Container\ActiveContainer\getNullFallback().

Referenced by ILIAS\Cache\Container\ActiveContainer\get().

                                                                                : \ILIAS\Refinery\ByTrying
     {
         // This is a workaround for the fact that the ByTrying transformation cannot be created by
         // $DIC->refinery()->byTrying() since we are in a hell of dependencies. E.g. we cant instantiate the
         // caching service with $DIC->refinery() since the Refinery needs ilLanguage, but ilLanguage
         // needs the caching service...
         return new ByTrying([$transformation, $this->getNullFallback()], $this->data_factory);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

ILIAS\Cache\Container\ActiveContainer::delete ( string $key )

Deletes the value for the given key.

Implements ILIAS\Cache\Container\Container.

Definition at line 244 of file ActiveContainer.php.

References ILIAS\LTI\ToolProvider\$key, and ILIAS\Cache\Container\ActiveContainer\isLocked().

                                        : void
     {
         if ($this->isLocked()) {
             return;
         }
         $this->adaptor->delete($this->request->getContainerKey(), $key);
     }

Here is the call graph for this function:

◆ flush()

ILIAS\Cache\Container\ActiveContainer::flush ( )

Deletes all values in the container.

Implements ILIAS\Cache\Container\Container.

Definition at line 252 of file ActiveContainer.php.

                            : void
     {
         $this->adaptor->flushContainer($this->request->getContainerKey());
     }

◆ get()

ILIAS\Cache\Container\ActiveContainer::get	(	string	$key,
		Transformation	$transformation
	)

Returns the value for the given key, or null if the key does not exist.

Implements ILIAS\Cache\Container\Container.

Definition at line 213 of file ActiveContainer.php.

References ILIAS\LTI\ToolProvider\$key, ILIAS\Cache\Container\ActiveContainer\buildFinalTransformation(), ILIAS\Cache\Container\ActiveContainer\has(), ILIAS\Cache\Container\ActiveContainer\isLocked(), and ILIAS\Cache\Container\ActiveContainer\unpack().

                                                                     : string|int|array|bool|null
     {
         if ($this->isLocked()) {
             return null;
         }
         if (!$this->has($key)) {
             return null;
         }
 
         $unpacked_values = $this->unpack(
             $this->adaptor->get($this->request->getContainerKey(), $key)
         );
 
         return $this->buildFinalTransformation($transformation)->transform($unpacked_values);
     }

Here is the call graph for this function:

◆ getAdaptorName()

ILIAS\Cache\Container\ActiveContainer::getAdaptorName ( )

Returns the name of the adaptop used (such as apc, memcache, phpstatic)

Implements ILIAS\Cache\Container\Container.

Definition at line 257 of file ActiveContainer.php.

                                     : string
     {
         return $this->config->getAdaptorName();
     }

◆ getContainerName()

ILIAS\Cache\Container\ActiveContainer::getContainerName ( )

Returns the name of the container.

Implements ILIAS\Cache\Container\Container.

Definition at line 262 of file ActiveContainer.php.

                                       : string
     {
         return $this->request->getContainerKey();
     }

◆ getNullFallback()

ILIAS\Cache\Container\ActiveContainer::getNullFallback ( )

protected

Definition at line 170 of file ActiveContainer.php.

References ILIAS\Cache\Container\ActiveContainer\$null_trafo.

Referenced by ILIAS\Cache\Container\ActiveContainer\buildFinalTransformation().

                                         : Transformation
     {
         return $this->null_trafo;
     }

Here is the caller graph for this function:

◆ has()

ILIAS\Cache\Container\ActiveContainer::has ( string $key )

Returns true if the container contains a value for the given key.

Implements ILIAS\Cache\Container\Container.

Definition at line 204 of file ActiveContainer.php.

References ILIAS\LTI\ToolProvider\$key, and ILIAS\Cache\Container\ActiveContainer\isLocked().

Referenced by ILIAS\Cache\Container\ActiveContainer\get().

                                     : bool
     {
         if ($this->isLocked()) {
             return false;
         }
 
         return $this->adaptor->has($this->request->getContainerKey(), $key);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isLocked()

ILIAS\Cache\Container\ActiveContainer::isLocked ( )

Returns true if the container is locked.

Implements ILIAS\Cache\Container\Container.

Definition at line 175 of file ActiveContainer.php.

Referenced by ILIAS\Cache\Container\ActiveContainer\delete(), ILIAS\Cache\Container\ActiveContainer\get(), ILIAS\Cache\Container\ActiveContainer\has(), and ILIAS\Cache\Container\ActiveContainer\set().

                               : bool
     {
         if ($this->lock_cache !== null && $this->lock_cache > microtime(true)) {
             return true;
         }
 
         if (!$this->adaptor->has($this->request->getContainerKey(), self::LOCK_UNTIL)) {
             $this->lock_cache = null;
             return false;
         }
 
         // see comment in buildFinalTransformation why this is not a good solution.
         $lock_until = $this->adaptor->get($this->request->getContainerKey(), self::LOCK_UNTIL);
         $lock_until = $lock_until === null ? null : (float) $lock_until;
 
         $this->lock_cache = $lock_until;
 
         return $lock_until !== null && $lock_until > microtime(true);
     }

Here is the caller graph for this function:

◆ lock()

ILIAS\Cache\Container\ActiveContainer::lock ( float $seconds )

Locks the container for a given amount of seconds (max 300), in this time, get() will return null and has() will return false.

Exceptions

Implements ILIAS\Cache\Container\Container.

Definition at line 195 of file ActiveContainer.php.

                                         : void
     {
         if ($seconds > 300.0 || $seconds < 0.0) {
             throw new \InvalidArgumentException('Locking for more than 5 minutes is not allowed.');
         }
         $lock_until = (string) (microtime(true) + $seconds);
         $this->adaptor->set($this->request->getContainerKey(), self::LOCK_UNTIL, $lock_until, 300);
     }

◆ pack()

ILIAS\Cache\Container\ActiveContainer::pack ( mixed $value )

private

Definition at line 68 of file ActiveContainer.php.

References ILIAS\Cache\Container\ActiveContainer\packRecursive().

Referenced by ILIAS\Cache\Container\ActiveContainer\packRecursive(), and ILIAS\Cache\Container\ActiveContainer\set().

                                        : string
     {
         if (is_string($value)) {
             return self::STRING_PREFIX . self::GLUE . $value;
         }
         if (is_array($value)) {
             $value = $this->packRecursive($value);
 
             return self::ARRAY_PREFIX . self::GLUE . json_encode($value, JSON_THROW_ON_ERROR);
         }
         if (is_int($value)) {
             return self::INT_PREFIX . self::GLUE . $value;
         }
         if (is_bool($value)) {
             return self::BOOL_PREFIX . self::GLUE . ($value ? self::TRUE : self::FALSE);
         }
         if (is_null($value)) {
             return self::NULL_PREFIX . self::GLUE;
         }
 
         throw new \InvalidArgumentException(
             'Only strings, integers and arrays containing those values are allowed, ' . gettype($value) . ' given.'
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ packRecursive()

ILIAS\Cache\Container\ActiveContainer::packRecursive ( array $value )

private

Definition at line 93 of file ActiveContainer.php.

References ILIAS\Cache\Container\ActiveContainer\pack().

Referenced by ILIAS\Cache\Container\ActiveContainer\pack().

                                                 : array
     {
         array_walk($value, function (&$item): void {
             if (is_array($item)) {
                 $item = $this->packRecursive($item);
             } else {
                 $item = $this->pack($item);
             }
         });
         return $value;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set()

ILIAS\Cache\Container\ActiveContainer::set	(	string	$key,
		string\|int\|array\|bool\|null	$value,
		?int	$ttl = `null`
	)

Sets the value for the given key.

Implements ILIAS\Cache\Container\Container.

Definition at line 229 of file ActiveContainer.php.

References ILIAS\LTI\ToolProvider\$key, ILIAS\Cache\Container\ActiveContainer\isLocked(), and ILIAS\Cache\Container\ActiveContainer\pack().

                                                                                          : void
     {
         if ($this->isLocked()) {
             return;
         }
         $ttl = $ttl ?? $this->config->getDefaultTTL();
 
         $this->adaptor->set(
             $this->request->getContainerKey(),
             $key,
             $this->pack($value),
             $ttl
         );
     }

Here is the call graph for this function:

◆ unlock()

ILIAS\Cache\Container\ActiveContainer::unlock ( )

Definition at line 270 of file ActiveContainer.php.

                             : void
     {
         $this->adaptor->delete($this->request->getContainerKey(), self::LOCK_UNTIL);
         $this->lock_cache = null;
     }

◆ unpack()

ILIAS\Cache\Container\ActiveContainer::unpack ( ?string $value )

private

Definition at line 115 of file ActiveContainer.php.

References ILIAS\Cache\Container\ActiveContainer\unpackRecursive(), and ILIAS\Cache\Container\ActiveContainer\unprefix().

Referenced by ILIAS\Cache\Container\ActiveContainer\get(), and ILIAS\Cache\Container\ActiveContainer\unpackRecursive().

                                            : string|int|array|bool|null
     {
         // simple detection
         if ($value === null) {
             return null;
         }
         if ($value === self::NULL_PREFIX . self::GLUE) {
             return null;
         }
 
         // type detection
         [$type, $unprefixed_value] = $this->unprefix($value);
 
         switch ($type) {
             case self::STRING_PREFIX:
                 return $unprefixed_value;
             case self::BOOL_PREFIX:
                 return $unprefixed_value === self::TRUE;
             case self::ARRAY_PREFIX:
                 $unprefixed_value = json_decode($unprefixed_value, true, 512);
                 if (!is_array($unprefixed_value)) {
                     return null;
                 }
 
                 return $this->unpackRecursive($unprefixed_value);
             case self::INT_PREFIX:
                 return (int) $unprefixed_value;
             default:
                 return null;
         }
 
         return null;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ unpackRecursive()

ILIAS\Cache\Container\ActiveContainer::unpackRecursive ( array $value )

private

Definition at line 149 of file ActiveContainer.php.

References ILIAS\Cache\Container\ActiveContainer\unpack().

Referenced by ILIAS\Cache\Container\ActiveContainer\unpack().

                                                   : array
     {
         array_walk($value, function (&$item): void {
             if (is_array($item)) {
                 $item = $this->unpackRecursive($item);
             } else {
                 $item = $this->unpack($item);
             }
         });
         return $value;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ unprefix()

ILIAS\Cache\Container\ActiveContainer::unprefix ( string $value )

private

Definition at line 105 of file ActiveContainer.php.

Referenced by ILIAS\Cache\Container\ActiveContainer\unpack().

                                             : array
     {
         $str = '/^' . $this->prefix_pattern . preg_quote(self::GLUE, '/') . '(.*)/is';
         if (!preg_match($str, $value, $matches)) {
             return [self::NULL_PREFIX, null];
         }
 
         return [$matches[1], $matches[2]];
     }

Here is the caller graph for this function:

Field Documentation

◆ $data_factory

ILIAS Data Factory ILIAS\Cache\Container\ActiveContainer::$data_factory

private

Definition at line 43 of file ActiveContainer.php.

◆ $lock_cache

float ILIAS\Cache\Container\ActiveContainer::$lock_cache = null

private

Definition at line 47 of file ActiveContainer.php.

◆ $null_trafo

Transformation ILIAS\Cache\Container\ActiveContainer::$null_trafo

private

Definition at line 44 of file ActiveContainer.php.

Referenced by ILIAS\Cache\Container\ActiveContainer\getNullFallback().

◆ $prefix_pattern

string ILIAS\Cache\Container\ActiveContainer::$prefix_pattern

private

Definition at line 45 of file ActiveContainer.php.

◆ ARRAY_PREFIX

const ILIAS\Cache\Container\ActiveContainer::ARRAY_PREFIX = 'array'

private

Definition at line 36 of file ActiveContainer.php.

◆ BOOL_PREFIX

const ILIAS\Cache\Container\ActiveContainer::BOOL_PREFIX = 'bool'

private

Definition at line 38 of file ActiveContainer.php.

◆ FALSE

const ILIAS\Cache\Container\ActiveContainer::FALSE = 'false'

private

Definition at line 41 of file ActiveContainer.php.

◆ GLUE

const ILIAS\Cache\Container\ActiveContainer::GLUE = '|||||'

private

Definition at line 34 of file ActiveContainer.php.

◆ INT_PREFIX

const ILIAS\Cache\Container\ActiveContainer::INT_PREFIX = 'int'

private

Definition at line 37 of file ActiveContainer.php.

◆ LOCK_UNTIL

const ILIAS\Cache\Container\ActiveContainer::LOCK_UNTIL = '_lock_until'

private

Definition at line 33 of file ActiveContainer.php.

◆ NULL_PREFIX

const ILIAS\Cache\Container\ActiveContainer::NULL_PREFIX = 'null'

private

Definition at line 39 of file ActiveContainer.php.

◆ STRING_PREFIX

const ILIAS\Cache\Container\ActiveContainer::STRING_PREFIX = 'string'

private

Definition at line 35 of file ActiveContainer.php.

◆ TRUE

const ILIAS\Cache\Container\ActiveContainer::TRUE = 'true'

private

Definition at line 40 of file ActiveContainer.php.

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

src/Cache/Container/ActiveContainer.php

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildFinalTransformation()

◆ delete()

◆ flush()

◆ get()

◆ getAdaptorName()

◆ getContainerName()

◆ getNullFallback()

◆ has()

◆ isLocked()

◆ lock()

◆ pack()

◆ packRecursive()

◆ set()

◆ unlock()

◆ unpack()

◆ unpackRecursive()

◆ unprefix()

Field Documentation

◆ $data_factory

◆ $lock_cache

◆ $null_trafo

◆ $prefix_pattern

◆ ARRAY_PREFIX

◆ BOOL_PREFIX

◆ FALSE

◆ GLUE

◆ INT_PREFIX

◆ LOCK_UNTIL

◆ NULL_PREFIX

◆ STRING_PREFIX

◆ TRUE