dokuwiki\Media\MediaFile

Complexity

Total Complexity

26

Size/Duplication

Total Lines	164
Duplicated Lines	0 %

Coupling/Cohesion

Components	3
Dependencies	1

Importance

Changes

0

17 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	7	1
A	fromRelativePath()	0	8	3
A	getId()	0	4	1
A	getPath()	0	4	1
A	getDisplayName()	0	4	1
A	getMime()	0	5	2
A	getExtension()	0	4	1
A	getIcoClass()	0	6	2
A	isDownloadable()	0	4	1
A	getFileSize()	0	4	1
A	getLastModified()	0	4	1
A	isWritable()	0	4	1
A	isImage()	0	4	1
A	initSizes()	0	9	3
A	getWidth()	0	5	2
A	getHeight()	0	5	2
A	getMeta()	0	5	2

<?php

namespace dokuwiki\Media;

use dokuwiki\Utf8\PhpString;

class MediaFile
{
    protected $id;
    protected $path;

    protected $mime;
    protected $ext;
    protected $downloadable;

    protected $width;
    protected $height;
    protected $meta;

    /**
     * MediaFile constructor.
     * @param string $id
     * @param string|int $rev optional revision
     */
    public function __construct($id, $rev = '')

The parameter $rev is not used and could be removed.

    {
        $this->id = $id; //FIXME should it be cleaned?
        $this->path = mediaFN($id);

        list($this->mime, $this->ext, $this->downloadable) = mimetype($this->path, false);
    }

    /**
     * Factory to create a new MediaFile from a Media Path
     *
     * @param string $path The path of a file, relative to the media base dir
     * @return MediaFile
     */
    static public function fromRelativePath($path)
    {
        if ($path[0] === '/' || $path[1] === ':') {
            throw new \RuntimeException('Only paths relative to the media directory may be used');
        }

        return new MediaFile(pathID($path, true));
    }

    /** @return string */
    public function getId()
    {
        return $this->id;
    }

    /** @return string */
    public function getPath()
    {
        return $this->path;
    }

    /**
     * The ID without namespace, used for display purposes
     *
     * @return string
     */
    public function getDisplayName()
    {
        return noNS($this->id);
    }

    /** @return string */
    public function getMime()
    {
        if (!$this->mime) return 'application/octet-stream';
        return $this->mime;
    }

    /** @return string */
    public function getExtension()
    {
        return (string)$this->ext;
    }

    /**
     * Similar to the extesion but does some clean up
     *
     * @return string
     */
    public function getIcoClass()
    {
        $ext = $this->getExtension();
        if ($ext === '') $ext = 'file';
        return preg_replace('/[^_\-a-z0-9]+/i', '_', $ext);
    }

    /**
     * Should this file be downloaded instead being displayed inline?
     *
     * @return bool
     */
    public function isDownloadable()
    {
        return $this->downloadable;
    }

    /** @return int */
    public function getFileSize()
    {
        return filesize($this->path);
    }

    /** @return int */
    public function getLastModified()
    {
        return filemtime($this->path);
    }

    /** @return bool */
    public function isWritable()
    {
        return is_writable($this->path);
    }

    /** @return bool */
    public function isImage()
    {
        return (substr($this->mime, 0, 6) === 'image/');
    }

    /**
     * initializes width and height for images when requested
     */
    protected function initSizes()
    {
        $this->width = 0;
        $this->height = 0;
        if (!$this->isImage()) return;
        $info = getimagesize($this->path);
        if ($info === false) return;
        list($this->width, $this->height) = $info;
    }

    /**
     * Returns the width if this is a supported image, 0 otherwise
     *
     * @return int
     */
    public function getWidth()
    {
        if ($this->width === null) $this->initSizes();
        return $this->width;
    }

    /**
     * Returns the height if this is a supported image, 0 otherwise
     *
     * @return int
     */
    public function getHeight()
    {
        if ($this->height === null) $this->initSizes();
        return $this->height;
    }

    /** @return \JpegMeta */
    public function getMeta()
    {
        if($this->meta === null) $this->meta = new \JpegMeta($this->path);
        return $this->meta;
    }
}