MimeTypeService.php

Go to the documentation of this file.

<?php

namespace Elgg\Filesystem;

use Elgg\EventsService;
use Elgg\Exceptions\InvalidArgumentException;

class MimeTypeService {

    public function __construct(protected EventsService $events) {
    }
    
    public function getMimeType(string $filename, string $default = MimeTypeDetector::DEFAULT_TYPE): string {
        if (!is_file($filename) || !is_readable($filename)) {
            throw new InvalidArgumentException("The file '{$filename}' is not a valid file or is not readable");
        }
        
        $detector = new MimeTypeDetector();
        
        $mime = $detector->getType($filename, $default);
        
        $params = [
            'filename' => $filename,
            'original_filename' => basename($filename),
            'default' => $default,
        ];
        
        return $this->events->triggerResults('mime_type', 'file', $params, $mime);
    }
    
    public function getSimpleType(string $mimetype, string $default = 'general'): string {
        $result = $default;
        
        switch ($mimetype) {
            case 'application/msword':
            case 'application/vnd.openxmlformats-officedocument.wordprocessingml.document':
            case 'application/pdf':
                $result = 'document';
                break;
            case 'application/ogg':
                $result = 'audio';
                break;
        }
        
        $matches = [];
        if (preg_match('~^(audio|image|video)/~', $mimetype, $matches)) {
            $result = $matches[1];
        }
        
        if (str_starts_with($mimetype, 'text/') || str_contains($mimetype, 'opendocument')) {
            $result = 'document';
        }
        
        $params = [
            'mime_type' => $mimetype,
        ];
        return $this->events->triggerResults('simple_type', 'file', $params, $result);
    }
    
    public function getSimpleTypeFromFile(string $filename, string $default = 'general'): string {
        $mimetype = $this->getMimeType($filename);
        
        return $this->getSimpleType($mimetype, $default);
    }
}