class.ilFFmpeg.php

Go to the documentation of this file.

<?php
 
class ilFFmpeg
{
    public static ?array $last_return = array();
 
    public static array $formats = array(
        "video/3pgg" => array(
            "source" => true,
            "target" => false
            ),
        "video/x-flv" => array(
            "source" => true,
            "target" => false
            ),
        "video/mp4" => array(
            "source" => true,
            "target" => true,
            "parameters" => "-vcodec libx264 -strict experimental -acodec aac -sameq -ab 56k -ar 48000",
            "suffix" => "mp4"
            ),
        "video/webm" => array(
            "source" => true,
            "target" => true,
            "parameters" => "-strict experimental -vcodec libvpx -acodec vorbis -ac 2 -sameq -ab 56k -ar 48000",
            "suffix" => "webm"
            )
        );
 
 
    public static function enabled(): bool
    {
        if (defined("PATH_TO_FFMPEG") && PATH_TO_FFMPEG != "") {
            return true;
        }
        return false;
    }
 
    public static function getSourceMimeTypes(): array
    {
        $ttypes = array();
        foreach (self::$formats as $k => $f) {
            if ($f["source"] == true) {
                $ttypes[] = $k;
            }
        }
        return $ttypes;
    }
 
    public static function supportsImageExtraction(
        string $a_mime
    ): bool {
        if (in_array($a_mime, self::getSourceMimeTypes(), true)) {
            return true;
        }
        return false;
    }
 
 
    private static function getCmd(): string
    {
        return PATH_TO_FFMPEG;
    }
 
    protected static function exec(string $args): array
    {
        $win = (stripos(php_uname(), "win") === 0);
        $cmd = self::getCmd();
        if ($win && str_contains($cmd, " ") && $cmd[0] !== '"') {
            $cmd = '"' . $cmd . '"';
            if ($args) {
                $cmd .= " " . $args;
            }
        } elseif ($args) {
            $cmd .= " " . $args;
        }
        $arr = [];
        exec($cmd, $arr);
        return $arr;
    }
 
    protected static function escapeShellArg(string $a_arg): string
    {
        setlocale(
            LC_CTYPE,
            "UTF8",
            "en_US.UTF-8"
        ); // fix for PHP escapeshellcmd bug. See: http://bugs.php.net/bug.php?id=45132
        // see also ilias bug 5630
        return escapeshellarg($a_arg);
    }
 
 
    public static function getLastReturnValues(): ?array
    {
        return self::$last_return;
    }
 
    public static function extractImage(
        string $a_file,
        string $a_target_filename,
        string $a_target_dir = "",
        int $a_sec = 1
    ): string {
        $spi = pathinfo($a_file);
 
        // use source directory if no target directory is passed
        $target_dir = ($a_target_dir != "")
            ? $a_target_dir
            : $spi['dirname'];
 
        $target_file = $target_dir . "/" . $a_target_filename;
 
        $sec = $a_sec;
        $cmd = "-y -i " . ilShellUtil::escapeShellArg(
            $a_file
        ) . " -r 1 -f image2 -vframes 1 -ss " . $sec . " " . ilShellUtil::escapeShellArg($target_file);
        $ret = self::exec($cmd . " 2>&1");
        self::$last_return = $ret;
 
        if (is_file($target_file)) {
            return $target_file;
        } else {
            throw new ilFFmpegException("It was not possible to extract an image from " . basename($a_file) . ".");
        }
    }
 
    public static function extractPNGFromVideoInZip(
        string $zip,
        string $path,
        int $sec = 1
    ): string {
        $zip_archive = new \ZipArchive();
        if ($zip_archive->open($zip) !== true) {
            return "";
        }
 
        $tfile = ilFileUtils::ilTempnam();
 
        $path = ltrim($path, "/");
        $video_stream = false;
        foreach ([$path, "/" . $path] as $path_in_zip) {
            $video_stream = $zip_archive->getStream($path_in_zip);
            if (is_resource($video_stream)) {
                break;
            }
        }
 
        if (!is_resource($video_stream)) {
            $zip_archive->close();
            return "";
        }
 
        $tmp_stream = fopen($tfile, "wb");
        if (!is_resource($tmp_stream)) {
            fclose($video_stream);
            $zip_archive->close();
            return "";
        }
        stream_copy_to_stream($video_stream, $tmp_stream);
        fclose($tmp_stream);
        fclose($video_stream);
        $zip_archive->close();
 
        clearstatcache(true, $tfile);
        if (!is_file($tfile) || filesize($tfile) === 0) {
            unlink($tfile);
            return "";
        }
 
        $tmp_file = self::escapeShellArg($tfile);
        $command2 = self::getCmd() . " -i $tmp_file -f image2 -vframes 1 -ss $sec -vcodec png pipe:1";
 
        $ret = (string) shell_exec($command2);
        unlink($tfile);
        return $ret;
    }
}