ILIAS\MediaObjects\MediaObjectManager Class Reference

Collaboration diagram for ILIAS\MediaObjects\MediaObjectManager:

Public Member Functions
	__construct (protected InternalDataService $data, InternalRepoService $repo, protected InternalDomainService $domain, protected \ilMobStakeholder $stakeholder)
	create (int $id, string $title, int $from_mob_id=0)
	addLocalDirectory (int $mob_id, string $dir)
	addFileFromLegacyUpload (int $mob_id, string $tmp_name, string $target_path="")
	addFileFromUpload (int $mob_id, UploadResult $result, string $path="/")
	addFileFromLocal (int $mob_id, string $tmp_name, string $path)
	removeLocation (int $mob_id, string $location)
	getLocationStream (int $mob_id, string $location)
	getLocationContent (int $mob_id, string $location)
	addStream (int $mob_id, string $location, FileStream $stream)
	getLocalSrc (int $mob_id, string $location)
	hasLocalFile (int $mob_id, string $location)
	getContainerResource (int $mob_id)
	getContainerResourceId (int $mob_id)
	getFilesOfPath (int $mob_id, string $dir_path)
	getInfoOfEntry (int $mob_id, string $path)
	deliverEntry (int $mob_id, string $path)
	generatePreview (int $mob_id, string $location, bool $local, string $format, int $sec=1, string $target_location="mob_vpreview.png")
	resizeImage (int $mob_id, string $location, string $format, int $width, int $height, bool $a_constrain_prop=false)
	addPreviewFromUrl (int $mob_id, string $url, string $target_location)
	getSrtFiles (int $mob_id, bool $vtt_only=false)
	generateMissingVTT (int $mob_id)
	srtToVtt (string $srt_text)
	getLastChangeTimestamp (int $mob_id)
	updateLastChange (int $mob_id)

Protected Attributes
ilLogger	$logger
ImageOutputOptions	$output_options
Images	$image_converters
MediaObjectRepository	$repo

Detailed Description

Definition at line 32 of file MediaObjectManager.php.

Constructor & Destructor Documentation

__construct()

ILIAS\MediaObjects\MediaObjectManager::__construct	(	protected InternalDataService	$data,
		InternalRepoService	$repo,
		protected InternalDomainService	$domain,
		protected \ilMobStakeholder	$stakeholder
	)

Definition at line 39 of file MediaObjectManager.php.

      {
        $this->repo = $repo->mediaObject();
        $this->image_converters = new Images(true);
        $this->output_options = new ImageOutputOptions();
        $this->logger = \ilLoggerFactory::getLogger('mob');
    }

References ILIAS\MediaObjects\MediaObjectManager\$repo, ilLoggerFactory\getLogger(), and ILIAS\Repository\logger().

Here is the call graph for this function:

Member Function Documentation

addFileFromLegacyUpload()

ILIAS\MediaObjects\MediaObjectManager::addFileFromLegacyUpload	(	int	$mob_id,
		string	$tmp_name,
		string	$target_path = ""
	)

Definition at line 69 of file MediaObjectManager.php.

                                                                                                    : void
    {
        $this->repo->addFileFromLegacyUpload($mob_id, $tmp_name, $target_path);
    }

addFileFromLocal()

ILIAS\MediaObjects\MediaObjectManager::addFileFromLocal	(	int	$mob_id,
		string	$tmp_name,
		string	$path
	)

Definition at line 82 of file MediaObjectManager.php.

                                                                                 : void
    {
        $this->repo->addFileFromLocal($mob_id, $tmp_name, $path);
    }

References $path.

addFileFromUpload()

ILIAS\MediaObjects\MediaObjectManager::addFileFromUpload	(	int	$mob_id,
		UploadResult	$result,
		string	$path = "/"
	)

Definition at line 74 of file MediaObjectManager.php.

     : void {
        $this->repo->addFileFromUpload($mob_id, $result, $path);
    }

addLocalDirectory()

ILIAS\MediaObjects\MediaObjectManager::addLocalDirectory	(	int	$mob_id,
		string	$dir
	)

Definition at line 64 of file MediaObjectManager.php.

                                                               : void
    {
        $this->repo->addLocalDirectory($mob_id, $dir);
    }

addPreviewFromUrl()

ILIAS\MediaObjects\MediaObjectManager::addPreviewFromUrl	(	int	$mob_id,
		string	$url,
		string	$target_location
	)

Definition at line 281 of file MediaObjectManager.php.

     : void {
        $log = $this->logger;
        try {
            $log->debug('Trying to fetch thumbnail from URL: {thumbnail_url}', [
                'thumbnail_url' => $url,
            ]);
            $curl = new \ilCurlConnection($url);
            $curl->init(true);
            $curl->setOpt(CURLOPT_RETURNTRANSFER, true);
            $curl->setOpt(CURLOPT_VERBOSE, true);
            $curl->setOpt(CURLOPT_FOLLOWLOCATION, true);
            $curl->setOpt(CURLOPT_TIMEOUT_MS, 5000);
            $curl->setOpt(CURLOPT_TIMEOUT, 5);
            $curl->setOpt(CURLOPT_FAILONERROR, true);
            $curl->setOpt(CURLOPT_SSL_VERIFYPEER, 1);
            $curl->setOpt(CURLOPT_SSL_VERIFYHOST, 2);
 
            $str = $curl->exec();
            $info = $curl->getInfo();
 
            $log->debug('cURL Info: {info}', [
                'info' => print_r($info, true)
            ]);
 
            $status = $info['http_code'] ?? '';
            if ((int) $status === 200) {
                $log->debug('Successfully fetched preview file from URL: Received {bytes} bytes', [
                    'bytes' => (string) strlen($str),
                ]);
            } else {
                $log->error('Could not fetch thumbnail from YouTube: {thumbnail_url}', [
                    'thumbnail_url' => $url,
                ]);
            }
 
            $res = fopen('php://memory', 'r+');
            fwrite($res, $str);
            rewind($res);
            $stream = new Stream($res);
            $this->repo->addStream(
                $mob_id,
                $target_location,
                $stream
            );
        } catch (\Exception $e) {
            $log->error('Could not fetch thumbnail from Url: {message}', [
                'message' => $e->getMessage(),
            ]);
            $log->error($e->getTraceAsString());
        }
    }

References $info, $log, $res, and $url.

addStream()

ILIAS\MediaObjects\MediaObjectManager::addStream	(	int	$mob_id,
		string	$location,
		FileStream	$stream
	)

Definition at line 108 of file MediaObjectManager.php.

     : void {
        $this->repo->addStream($mob_id, $location, $stream);
    }

create()

ILIAS\MediaObjects\MediaObjectManager::create	(	int	$id,
		string	$title,
		int	$from_mob_id = 0
	)

Definition at line 51 of file MediaObjectManager.php.

     : void {
        $this->repo->create(
            $id,
            $title,
            $this->stakeholder,
            $from_mob_id
        );
    }

deliverEntry()

ILIAS\MediaObjects\MediaObjectManager::deliverEntry	(	int	$mob_id,
		string	$path
	)

Definition at line 166 of file MediaObjectManager.php.

     : void {
        $this->repo->deliverEntry($mob_id, $path);
    }

generateMissingVTT()

ILIAS\MediaObjects\MediaObjectManager::generateMissingVTT

(

int

$mob_id

)

Definition at line 357 of file MediaObjectManager.php.

                                                   : void
    {
        $names = array_map(static function (array $i) {
            return $i["file"];
        }, $this->getSrtFiles($mob_id));
        $missing_vtt = [];
        foreach ($names as $name) {
            if (str_ends_with($name, ".srt")) {
                $vtt = str_replace(".srt", ".vtt", $name);
                if (!in_array($vtt, $names) && !in_array($vtt, $missing_vtt)) {
                    $missing_vtt[] = $vtt;
                }
            }
        }
        foreach ($missing_vtt as $vtt_name) {
            $srt_name = str_replace(".vtt", ".srt", $vtt_name);
            $srt_content = stream_get_contents($this->repo->getLocationStream($mob_id, "srt/" . $srt_name)->detach());
            $vtt_content = $this->srtToVtt($srt_content);
            $this->repo->addString($mob_id, "/srt/" . $vtt_name, $vtt_content);
        }
    }

generatePreview()

ILIAS\MediaObjects\MediaObjectManager::generatePreview	(	int	$mob_id,
		string	$location,
		bool	$local,
		string	$format,
		int	$sec = 1,
		string	$target_location = "mob_vpreview.png"
	)

Definition at line 174 of file MediaObjectManager.php.

     : void {
 
        $is_image = is_int(strpos($format, "image/"));
        $is_video = in_array($format, ["video/mp4", "video/webm"]);
 
        if ($local) {
            if ($is_image) {
                $width = $height = \ilObjMediaObject::DEFAULT_PREVIEW_SIZE;
                $image_quality = 60;
 
                // the zip stream is not seekable, which is needed by Imagick
                // so we create a seekable stream first
                $tempStream = fopen('php://temp', 'w+');
                stream_copy_to_stream($this->repo->getLocationStream($mob_id, $location)->detach(), $tempStream);
                rewind($tempStream);
                $stream = new Stream($tempStream);
 
                $converter = $this->image_converters->resizeToFixedSize(
                    $stream,
                    $width,
                    $height,
                    true,
                    $this->output_options
                        ->withQuality($image_quality)
                        ->withFormat(ImageOutputOptions::FORMAT_PNG)
                );
                $this->repo->addStream(
                    $mob_id,
                    $target_location,
                    $converter->getStream()
                );
                fclose($tempStream);
            }
            if ($is_video) {
                $zip_uri = $this->repo->getContainerPath($mob_id);
                $image_str = \ilFFmpeg::extractPNGFromVideoInZip(
                    $zip_uri,
                    $location,
                    $sec
                );
                $png_res = fopen('php://memory', 'r+');
                fwrite($png_res, $image_str);
                rewind($png_res);
                $png_stream = new Stream($png_res);
                $this->repo->addStream(
                    $mob_id,
                    $target_location,
                    $png_stream
                );
            }
        }
    }

getContainerResource()

ILIAS\MediaObjects\MediaObjectManager::getContainerResource

(

int

$mob_id

)

Definition at line 137 of file MediaObjectManager.php.

     : ?StorableResource {
        return $this->repo->getContainerResource($mob_id);
    }

getContainerResourceId()

ILIAS\MediaObjects\MediaObjectManager::getContainerResourceId

(

int

$mob_id

)

Definition at line 143 of file MediaObjectManager.php.

     : ?ResourceIdentification {
        return $this->repo->getContainerResourceId($mob_id);
    }

getFilesOfPath()

ILIAS\MediaObjects\MediaObjectManager::getFilesOfPath	(	int	$mob_id,
		string	$dir_path
	)

Definition at line 149 of file MediaObjectManager.php.

     : array {
        return $this->repo->getFilesOfPath($mob_id, $dir_path);
    }

getInfoOfEntry()

ILIAS\MediaObjects\MediaObjectManager::getInfoOfEntry	(	int	$mob_id,
		string	$path
	)

Definition at line 156 of file MediaObjectManager.php.

     : array {
        return $this->repo->getInfoOfEntry(
            $mob_id,
            $path
        );
    }

getLastChangeTimestamp()

ILIAS\MediaObjects\MediaObjectManager::getLastChangeTimestamp

(

int

$mob_id

)

Definition at line 415 of file MediaObjectManager.php.

                                                       : int
    {
        return $this->repo->getLastChangeTimestamp($mob_id);
    }

getLocalSrc()

ILIAS\MediaObjects\MediaObjectManager::getLocalSrc	(	int	$mob_id,
		string	$location
	)

Definition at line 116 of file MediaObjectManager.php.

                                                              : string
    {
        $src = $this->repo->getLocalSrc(
            $mob_id,
            $location
        );
        if ($src === "") {  // fallback: old source
            $path_to_file = \ilObjMediaObject::_getURL($mob_id) . "/" . $location;
            try {
                $src = \ilWACSignedPath::signFile($path_to_file);
            } catch (\Exception $e) {
            }
        }
        return $src;
    }

References Vendor\Package\$e, $location, ilObjMediaObject\_getURL(), and ilWACSignedPath\signFile().

Here is the call graph for this function:

getLocationContent()

ILIAS\MediaObjects\MediaObjectManager::getLocationContent	(	int	$mob_id,
		string	$location
	)

Definition at line 101 of file MediaObjectManager.php.

     : string {
        return $this->repo->getLocationContent($mob_id, $location);
    }

getLocationStream()

ILIAS\MediaObjects\MediaObjectManager::getLocationStream	(	int	$mob_id,
		string	$location
	)

Definition at line 94 of file MediaObjectManager.php.

     : ZIPStream {
        return $this->repo->getLocationStream($mob_id, $location);
    }

getSrtFiles()

ILIAS\MediaObjects\MediaObjectManager::getSrtFiles	(	int	$mob_id,
		bool	$vtt_only = false
	)

Definition at line 337 of file MediaObjectManager.php.

                                                                    : array
    {
        $srt_files = [];
        $valid_suffixes = $vtt_only
            ? ["vtt"]
            : ["srt", "vtt"];
        foreach ($this->getFilesOfPath($mob_id, "/srt") as $i) {
            $name = explode(".", $i["basename"]);
            if (in_array($name[1], $valid_suffixes) && substr($name[0], 0, 9) == "subtitle_") {
                $srt_files[] = [
                    "file" => $i["basename"],
                    "full_path" => $i["path"],
                    "src" => $this->getLocalSrc($mob_id, $i["path"]),
                    "language" => substr($name[0], 9, 2)
                ];
            }
        }
        return $srt_files;
    }

hasLocalFile()

ILIAS\MediaObjects\MediaObjectManager::hasLocalFile	(	int	$mob_id,
		string	$location
	)

Definition at line 132 of file MediaObjectManager.php.

                                                               : bool
    {
        return $this->repo->hasLocalFile($mob_id, $location);
    }

References $location.

removeLocation()

ILIAS\MediaObjects\MediaObjectManager::removeLocation	(	int	$mob_id,
		string	$location
	)

Definition at line 87 of file MediaObjectManager.php.

     : void {
        $this->repo->removeLocation($mob_id, $location);
    }

resizeImage()

ILIAS\MediaObjects\MediaObjectManager::resizeImage	(	int	$mob_id,
		string	$location,
		string	$format,
		int	$width,
		int	$height,
		bool	$a_constrain_prop = false
	)

Definition at line 234 of file MediaObjectManager.php.

     : string {
 
        if (!is_int(strpos($format, "image/"))) {
            return "";
        }
 
        $file_path = pathinfo($location);
        $new_location = substr($file_path["basename"], 0, strlen($file_path["basename"]) -
                strlen($file_path["extension"]) - 1) . "_" .
            $width . "_" .
            $height . "." . $file_path["extension"];
 
 
        $image_quality = 60;
 
        // the zip stream is not seekable, which is needed by Imagick
        // so we create a seekable stream first
        $tempStream = fopen('php://temp', 'w+');
        stream_copy_to_stream($this->repo->getLocationStream($mob_id, $location)->detach(), $tempStream);
        rewind($tempStream);
        $stream = new Stream($tempStream);
 
        $converter = $this->image_converters->resizeToFixedSize(
            $stream,
            $width,
            $height,
            false,
            $this->output_options
            //->withQuality($image_quality)
            //->withFormat(ImageOutputOptions::FORMAT_PNG)
        );
        $this->repo->addStream(
            $mob_id,
            $new_location,
            $converter->getStream()
        );
        fclose($tempStream);
        return $new_location;
    }

srtToVtt()

ILIAS\MediaObjects\MediaObjectManager::srtToVtt

(

string

$srt_text

)

Definition at line 379 of file MediaObjectManager.php.

                                              : string
    {
        // Remove UTF-8 BOM if present
        $srt_text = preg_replace('/^\xEF\xBB\xBF/', '', $srt_text);
 
        // Normalise line-endings and split cues
        $srt_text = preg_replace('~\r\n?~', "\n", $srt_text);
        $blocks = preg_split("/\n{2,}/", trim($srt_text));
 
        $vttLines = ['WEBVTT', ''];          // header + blank line
 
        foreach ($blocks as $block) {
            $lines = explode("\n", $block);
 
            if (count($lines) < 2) {
                continue;                    // malformed cue
            }
 
            /* cue number? allow BOM or spaces either side */
            if (preg_match('/^\s*\d+\s*$/u', $lines[0])) {
                array_shift($lines);         // drop it
            }
 
            /* now $lines[0] *is* the time-code line → , → . */
            $lines[0] = preg_replace(
                '/(\d{2}:\d{2}:\d{2}),(\d{3})/',
                '$1.$2',
                $lines[0]
            );
 
            $vttLines = array_merge($vttLines, $lines, ['']);
        }
 
        return implode("\n", $vttLines);
    }

updateLastChange()

ILIAS\MediaObjects\MediaObjectManager::updateLastChange

(

int

$mob_id

)

Definition at line 420 of file MediaObjectManager.php.

                                                 : void
    {
        $this->repo->updateLastChangeTimestamp($mob_id, time());
    }

Field Documentation

$image_converters

Images ILIAS\MediaObjects\MediaObjectManager::$image_converters

protected

Definition at line 36 of file MediaObjectManager.php.

$logger

ilLogger ILIAS\MediaObjects\MediaObjectManager::$logger

protected

Definition at line 34 of file MediaObjectManager.php.

$output_options

ImageOutputOptions ILIAS\MediaObjects\MediaObjectManager::$output_options

protected

Definition at line 35 of file MediaObjectManager.php.

$repo

MediaObjectRepository ILIAS\MediaObjects\MediaObjectManager::$repo

protected

Definition at line 37 of file MediaObjectManager.php.

Referenced by ILIAS\MediaObjects\MediaObjectManager\__construct().

---

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

• components/ILIAS/MediaObjects/MediaObject/MediaObjectManager.php